Википедия:Создание временных диаграмм (Fntnhy;nx&Vk[;guny fjybyuud] ;ngijgbb)

Начало[править код]

Одномерные и двухмерные диаграммы в викитексте можно задавать с помощью расширения mw:Extension:EasyTimeline.

Диаграмма задаётся сценарием между специальными тегами:

 <timeline>
  сценарий
 </timeline>

Пример простой диаграммы, визуализирующей размещение простых чисел от 2 до 37:

<timeline>
ImageSize = width:400 height:30
PlotArea = left:0 bottom:0 top:0 right:0
Period = from:0 till:40
TimeAxis = orientation:hor
PlotData=
  from:2 till:2   text:2
  from:3 till:3   text:3
  from:5 till:5   text:5
  from:7 till:7   text:7
  from:11 till:11 text:11
  from:13 till:13 text:13
  from:17 till:17 text:17
  from:19 till:19 text:19
  from:23 till:23 text:23
  from:29 till:29 text:29
  from:31 till:31 text:31
  from:37 till:37 text:37
</timeline>

Расположение текста можно изменить на более читаемое, а также добавить ссылки:

ImageSize = width:400 height:35
PlotArea = left:0 bottom:0 top:0 right:0
Period = from:0 till:40
TimeAxis = orientation:hor

Define $dx1 = -2
Define $dx2 = -5
Define $dy = 15

PlotData=
  from:2 till:2 shift: ($dx1, $dy) text:[[2]]
  from:3 till:3 shift: ($dx1, $dy) text:[[3]]
  from:5 till:5 shift: ($dx1, $dy) text:[[5]]
  from:7 till:7 shift: ($dx1, $dy) text:[[7]]
  from:11 till:11 shift: ($dx2, $dy) text:[[11]]
  from:13 till:13 shift: ($dx2, $dy) text:[[13]]
  from:17 till:17 shift: ($dx2, $dy) text:[[17]]
  from:19 till:19 shift: ($dx2, $dy) text:[[19]]
  from:23 till:23 shift: ($dx2, $dy) text:[[23]]
  from:29 till:29 shift: ($dx2, $dy) text:[[29]]
  from:31 till:31 shift: ($dx2, $dy) text:[[31]]
  from:37 till:37 shift: ($dx2, $dy) text:[[37]]

Доступны команды[править код]

Общее размещение: #ImageSize, #PlotArea, #Colors, #BackgroundColors, #AlignBars
Интерпретация и представление дат и периодов: #DateFormat, #Period, #ScaleMajor, #ScaleMinor, #TimeAxis
События, периоды и описывающий текст: #PlotData, #TextData
Упорядочивание, разделение, имена групп событий и периодов: #BarData, #Legend, #LineData
Ссылки на части кода повторяющиеся много раз: #Define

Следующие команды обязательны: #ImageSize, #PlotArea, #Period, #TimeAxis. Также необходима как минимум одна команда #PlotData или #TextData. Каждая из них может повторяться множество раз. Все остальные команды необязательны.

ImageSize[править код]

Устанавливает общий размер изображения.

width: ширина, максимум 1600, минимум 25
height: высоты максимум 1200, минимум 25

Также размер может быть установлен в auto, если число прямоугольников из которых состоит диаграмма часто меняется. В этом случае должен быть установлен параметр:

barincrement: размер, который должен быть добавлен к общему размеру изображения для каждого нового прямоугольника.

PlotArea[править код]

Параметры left, top, right, bottom задают расстояние между соответственно левыми, верхними, правыми и нижними границами всего изображения и области рисования

Period[править код]

Период времени от (параметр from) и до (till), который должен быть отображён на диаграмме. Даты должны быть определены в соответствии с #DateFormat.

TimeAxis[править код]

Определяет ориентацию диаграммы.

orientation: горизонтальная (hor) или вертикальная (ver).
order: задаёт обратное (reverse) расположение.

PlotData[править код]

Используется для определения прямоугольников и добавления текста к этим прямоугольникам. Для текста, который не связан с определённым периодом или требует расширенного форматироваия используйте команду TextData.

Атрибуты расположения[править код]

at: Определяет дату, на которой должен размещаться текст. В зависимости от атрибута align текст начинается, заканчивается или размещается в центре указанной позиции.
from: Определяет дату, с которой должен начинаться прямоугольник. Используете значение start для указания минимального значения в диаграмме.
till: Определяет дату, на которой заканчивается прямоугольник. Используйте параметр end для обозначения максимального значения в диаграмме.
shift: Определяет горизонтальное и вертикальное смещение для текста.

PlotData=
  bar:Japan from:start      till:19/02/1945 color:JT
  bar:Japan from:19/02/1945 till:14/03/1945 color:AI
  bar:Japan from:02/09/1945 till:end        color:AO

  at:07/12/1941 shift:(0,-15) text:"<-- WW2 reaches Asia"

Атрибуты прямоугольника[править код]

bar: Определяет к какому прямоугольнику применяются все остальные атрибуты.
color: Определяет цвет прямоугольника. color должен быть прежде определён командой #Colors.
width: Определяет размер прямоугольника в абсолютных или относительных измерениях.

Текстовые атрибуты[править код]

text: Определяет текст, возможно со ссылками, который отображается рядом с прямоугольником. Позиция задаётся напрямую через at или косвенно через from или till. Во втором случае текст располагается в середине прямоугольника.
textcolor: Определяет цвет текста. Цвет должен быть определён выше командой #Colors. По умолчанию используется черный цвет.
fontsize: Определяет размер между 6 и 30, или (предпочтительно) один из тэгов XS, S (по умолчанию), M, L, XL.
align: Выравнивание по центру (center, по умолчанию), по левому (left) или правому (right) краю.
link: Определяет ссылку.

PlotData=
   bar:US at:07/12/1941 align:left textcolor:black fontsize:XS text:7/12 [[Pearl Harbour]]

Атрибуты маркера[править код]

mark: Помещает маркер в прямоугольник в заданную позицию. Определяется как mark:(symbol, color). symbol может принимать только значение line. color должен быть определён прежде командой #Colors. Если цвет не определён используется чёрный.

PlotData=
  bar:test width:15 color:red
  from:1900 till:2000
  at:1990 mark:(line,white)

Colors[править код]

Команда позволяет привязывать цвета к идентификаторам. Другие команды должны ссылаться на идентификаторы, определённые здесь. Команда определяет один или более цветов, каждый в отдельной строке с отступом.

id: Другие команды должны использовать этот идентификатор для ссылок на цвет.
value: Определение цвета. Это должно быть:

предопределённая константа;
rgb (red, green, blue): определяет RGB цвет, значения от 0 до 1;
hsv (hue, saturation, value): определяет HSV цвет, три значения от 0 до 1;
gray (value): определяет серый цвет между 0 (чёрный) и 1 (белый).

legend: Определяет текст, который должен отображаться рядом с этим цветом в легенде

Colors =
  id:war       value:red   legend:Война
  id:peace     value:blue  legend:Мирное время
  id:treaty    value:rgb(0.6,0,0.6)
  id:lightgrey value:gray(0.9)
  id:darkgrey  value:gray(0.1)

DateFormat[править код]

Определяет как даты, используемые в других командах, должны интерпретироваться.

Допустимыми форматами являются:

dd/mm/yyyy: Дата воспринимается как день/месяц/год (только для дат с 01/01/1800).
mm/dd/yyyy: Дата воспринимается как месяц/день/год (только для дат с 01/01/1800).
yyyy: Целое значение между −9999 и +9999.

DateFormat = mm/dd/yyyy

Define[править код]

Команда позволяет создавать ссылки на текстовые константы, которые встречаются много раз. Должны начинаться с символа $.

Define $broad       = width:30
Define $narrow      = width:10
Define $bardefaults = $broad fontsize:S

Ссылки[править код]

Полное описание синтаксиса EasyTimeline (англ.)