Открыть главное меню

НачалоПравить

Одномерные и двухмерные диаграммы в викитексте можно задавать с помощью расширения 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, #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

СсылкиПравить