Jump to content

Extension:Chartie

From mediawiki.org
This page is a translated version of the page Extension:Chartie and the translation is 100% complete.
Справка по расширениям MediaWiki
Chartie
Статус релиза: стабильно
Реализация Функция парсера , Тег
Описание Добавляет в Вашу MediaWiki поддержку интерактивных линейных диаграмм.
Автор(ы) Dolfinus
Последняя версия 1.1 (2024-04-01)
MediaWiki 1.25+
Изменения в БД Нет
Лицензия MIT License
Скачать
README
Пример Пример отрисовки линейного графика
$wgChartie
‎<chart>

Описание

Расширение MediaWiki, позволяющее добавлять на страницы простые линейные графики. Основано ни библиотеке d3.js, отрисовка в SVG. Пример страницы с графиком

Примеры

Пример отрисовки линейного графика

noframe
noframe

Supported file extensions

CSV

  • .csv

Установка

  • Скачайте и распакуйте файл(ы) в папку с названием Chartie в вашей папке extensions/.
  • Добавьте следующий код в конце вашего файла LocalSettings.php :
    wfLoadExtension( 'Chartie' );
    
  • Измените значение параметра $wgFileExtensions
$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'csv'
  )
);
  • Yes Готово – Перейдите на страницу Special:Version на своей вики, чтобы удостовериться в том, что расширение успешно установлено.

Использование

Как средство просмотра

[[File:Data.csv|800x350px|legend_title=,x_title=,...]]

Функция парсера

{{#chart:
Name;x_value1;y_value1
Name;x_value2;y_value2
...}}

или

{{#chart:Data.csv}}

с параметрами:

{{#chart:Data.csv|width}}
{{#chart:Data.csv|width|height}}
...
{{#chart:Data.csv|width|height|legend_title|x_type|x_title|x_unit|x_null|y_type|y_title|y_unit|y_null|delimiter|style|class}}

Вместо названия локального файла можно указывать также и ссылку на файл с другого сайта

Как тег

<chart data="Data.csv" width="" height="" ... ></chart>

или

<chart width="" height="" ... >Data.csv</chart>

или

<chart width="" height="" ... >
Name;x_value1;y_value1
Name;x_value2;y_value2
</chart>

Можно использовать ссылку вместо названия файла

Параметры

Имя Описание Значение по умолчанию
width Ширина области рисования 865
height Высота области рисования 360
legend_title Заголовок блока Легенда Растворители:
x_type Тип значения по оси x temp
x_title Заголовок под осью x Температура
x_unit Единица измерения для оси x C
x_null Если значение true, шкала начинается с 0 false
y_type Тип значения по оси y solub
y_title Заголовок под осью y Растворимость
y_unit Единица измерения для оси y г/100г
y_null Если значение true, шкала y начинается с 0 false
delimiter Разделитель в csv-файле ;
style CSS-стиль области рисования
class HTML-класс области рисования

Высота и ширина также могут иметь значение auto - таким образом размер области рисования будет рассчитан на основании размера экрана устройства.

Тип шкалы определяет список доступных единиц измерения, между которыми может быть выполнена автоматическая конвертация. Если вы хотите использовать собственные единицы, используйте тип general. Если вы не используете конвертацию единиц измерения, выберите тип no. По-умолчанию, заголовки шкал и единицы измерения автоматически устанавливаются в соответствие с типом шкалы (имя соответствует типу, а единица - первой доступной единице измерения в списке):

Типы осей и единицы измерения

Тип Единицы измерения
general а,ф,п,н,м,c,д, ,К,М,Г,Т,П (префиксы)
time с,мин,час,день,месяц,год
mass мг,карат,г,унций,фунтов,кг,тонн
length мм,см,дюйм,футов,ярд,м,км,миль
area мм2,см2,дюйм2,дм2,футов2,ярд2,м2,ар,декар,акр,гектар,км2,миль2
volume мм3,см,пинт,кварт,литров,галлон,баррель,м3,км3
speed м/с,узлов,миль/ч,фут/с,км/ч,км/с,c
temp C,K,F,Ra
solub гр/100гр,%

Локализация

Единицы измерения также зависят от локализации. Полный список переводов можно найти в папке i18n, файлы названы в соответствии с языком.

Настройка

Все значения по-умолчанию могут быть изменены в файле LocalSettings.php

$wgChartie["width"]  = 865;
$wgChartie["height"] = 360;
...
$wgChartie["class"]  = 'someclass';

Элементы управления

Действие Управление
Наведение мыши на график или нажатие на него Отображение экстраполированного значения
Наведение мыши на точку или нажатие на нее Отображение точного значения в точке
Нажатие на заголовок оси Отображение значений от минимума или от 0
Нажатие на единицу измерения Конвертация всех значений в другие единицы измерения
Двойное нажатие на график Скрыть график
Нажатие на элемент легенды Скрыть/отобразить график
Нажатие на заголовок блока легенд Скрыть/отобразить все графики