Extension:Chartie

Справка по расширениям MediaWiki

Chartie Статус релиза: стабильно
Реализация	Функция парсера , Тег
Описание	Добавляет в Вашу MediaWiki поддержку интерактивных линейных диаграмм.
Автор(ы)	Dolfinus
Последняя версия	1.1 (2024-04-01)
MediaWiki	1.25+
Изменения в БД	Нет
Лицензия	MIT License
Скачать	Download master snapshot GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . README
Пример	Пример отрисовки линейного графика
Параметры $wgChartie
Метки ‎<chart>
Используемые хуки ParserMakeImageParams ParserFirstCallInit ImageBeforeProduceHTML ImageOpenShowImageInlineBefore BeforePageDisplay BeforePageDisplayMobile

Описание

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

Примеры

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

noframe

Supported file extensions

CSV

• .csv

Установка

• Скачайте и распакуйте файл(ы) в папку с названием Chartie в вашей папке extensions/.
• Добавьте следующий код в конце вашего файла LocalSettings.php :

  wfLoadExtension( 'Chartie' );
  

• Измените значение параметра $wgFileExtensions

$wgFileExtensions = array_merge(
  $wgFileExtensions, array(
      'csv'
  )
);

•  Готово – Перейдите на страницу 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
Нажатие на единицу измерения	Конвертация всех значений в другие единицы измерения
Двойное нажатие на график	Скрыть график
Нажатие на элемент легенды	Скрыть/отобразить график
Нажатие на заголовок блока легенд	Скрыть/отобразить все графики