Довідка про розширення MediaWiki

Chart Статус релізу: стабільнийCategory:Stable extensions/uk
Реалізація	Тег Category:Tag extensions/uk
Опис	Renders charts
Автор(и)	TODO
Compatibility policy	Master maintains backward compatibility.
MediaWiki	>= 1.44
Зміни в БД	Ні
Ліцензія	GNU General Public License 3.0 or later
Завантажити	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control/uk README
Параметри $wgChartRequestSizeLimit $wgChartProgressiveEnhancement $wgChartTransformsEnabled $wgChartServiceUrl $wgChartCliPath
Використані hook'и LinksUpdateComplete Category:LinksUpdateComplete extensions/uk PageSaveComplete Category:PageSaveComplete extensions/uk ParserFirstCallInit Category:ParserFirstCallInit extensions/uk
Quarterly downloads	30 (Ranked 66th)
Translate the Chart extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

Розширення Chart надає базові можливості з інтерактивної візуалізації даних, які розроблені для заміни розширення Graph та, можливо, також і розширення EasyTimeline . Це розширення зараз в розробці для вікі проєктів Вікімедіа. Детальніше щодо деталей про процес розробки див. Extension:Chart/Project .

Ця розширення підтримує наступні типи діаграм:

• Лінійна діаграма
• Діаграма з областями
• Стовпчикова діаграма
• Секторна діаграма

Встановлення

Розширення Chart вимагає наявність встановленого розширення JsonConfig , а також завантаження бібліотеки Chart Renderer JavaScript (насправді TypeScript).

Див. файл README.md в репозиторії щодо повної інструкції зі встановлення.

For Wikimedia production usage, see Wikitech:Kubernetes/Deployments for general instructions on service deployments.

Інструкція з використання

Щоб відобразити діаграму, ви повинні спершу визначитися з джерелами даних, які ви хочете відобразити. Визначення діаграми є відносно простим файлом JSON, що відповідає Extension:Chart/Specification . Всіх діаграми в цьому прикладі можуть відображатися з одного і того самого джерела даних: Data:Chart_Example_Data.tab, вигаданий набір даних. Приклад вмісту для цих сторінок можна знайти в каталозі sample.

{
    "license": "CC0-1.0",
    "version": 1,
    "source": "Chart Example Data.tab",
    "type": "line",
    "title": {
        "en": "Example Chart Title"
    },
    "xAxis": {
        "title": {
        	"en": "Example X Axis Title"
        },
        "format": "none"
    },
    "yAxis": {
        "title": {
            "en": "Example Y Axis Title"
        },
        "format": "none"
    },
    "mediawikiCategories": [
        {
            "name": "Example category",
            "sort": "Its sortkey"
        }
    ],
    "transform": {
        "module": "Optional lua module for data transforms",
        "function": "transform_func",
        "args": {
            "arg_name": "arg_value"
        }
    }
}

Коли діаграму визначено, то ви можете її відобразити, просто використавши персерну функцію #chart. У цьому випадку дані діаграми визначено в Data:Chart_Example_Data.tab, а сама діаграма — Data:Example.Line.chart:

{{#chart:Example.Line.chart}}

Налаштування

Наразі налаштування діаграм є обмеженим. Надіє полягає в тому, що після тестування, обговорення та оцінення, можна буде знайти рішення для налаштування діаграм, що не буде порушувати доступність, відображення, що притамане певному пристрою, або безпеку.

Інтернаціоналізація

Діаграми можуть лише бути вбудованими в мову контенту вікі; тому, наприклад, рядок запиту «uselang» (наприклад, ?uselang=es) не впливатиме на діаграму.

Формат діаграми підтримує визначення тексту як назва і мітки іншими мовами, тому одна і та сама діаграма може бути використана у вікі різними мовами. Див. цей приклад діаграми з підтримкою для кількох мов, який відображається в іспанській вікі.

Типи діаграм

Для всіх діаграм очікується, що дані розміщенні в стовпчиках, де перший стовпчик представляє x-axis, а наступні стовпчики представляють ряди на y-axis.

Пошук наявних діаграм

Діаграми, що використовуються в статтях, розміщуються в Вікісховищі та можуть відстежуватися, використовуючи категорії MediaWiki.

Цей запит може бути використаний як проксі, щоб знайти діаграми, які створили інші користувачі та додати переклади.

Список вікісторінок, що використовують в будь-які певній вікі, можна знайти в категорії, чия назва визначена в MediaWiki:chart-render-category та MediaWiki:Chart-error-category (Category:Pages using the Chart extension та Category:Pages using the Chart extension with rendering errors у цій вікі). Будь ласка, впевніться, що категорії вашої вікі прив'язані до d:Q131382738 та d:Q131406605, щоб спростити пошуку між вікі.

Технічна документація

З огляду на проблкми з Extension:Graph , всі рішення щодо нового розширення були ретельно розглянуті з надією вибудувати довіру та впевненість до його заміни.

До цього часу технічні рішення документувалися в репозиторії коду у папці doc/adr.

Error Monitoring

Errors with client side chart rendering will be logged to logstash.

See also

• Frequently asked questions

Це розширення використовується в одному або декількох проєктах Вікімедіа. Це, мабуть, означає, що розширення стабільне і працює досить добре, щоб його могли використовувати веб-сайти з великим трафіком. Шукайте назву цього розширення у файлах конфігурації Wikimedia CommonSettings.php та InitialiseSettings.php, щоб побачити, де це встановлене. Повний перелік розширень, встановлених на певній вікі, можна переглянути на сторінці Special:Version вікі.