Вікі про вікі
Вікі про вікі

Тимчасова діаграма — вбудоване в статтю зображення на основі вікірозмітки, що представляє собою графічну ілюстрацію викладених даних. Може бути одновимірною ілюстрацією, вертикальною або горизонтальною, а також двомірною.

За роботу діаграм відповідає розширення MediaWiki EasyTimeline, підключене на всіх проєктах Фандома за замовчуванням.

Синтаксис[]

Вступ[]

Для створення діаграми потрібно написати скрипт, укладений між спеціальним тегом:

<timeline>
script
</timeline>

При цьому EasyTimeline перетворює скрипт в зображення формату PNG і (опціонально) інтерактивну карту. Сам по собі синтаксис EasyTimeline досить простий для освоєння, тому ви цілком можете відразу прочитати приклади, щоб зрозуміти основи.

Команди[]

EasyTimeline підтримує наступні команди для створення скрипта:

Засади[]

Скрипт може містити команди і коментарі. Кожна команда містить один або кілька атрибутів. Команди та їх атрибути можуть бути написані літерами нижнього, верхнього або змішаного регістру — технічно він не має значення; проте варто дотримуватися єдиного стилю при написанні сценарію для того, щоб код був максимально зручний для читання.

Обов'язкові команди, які повинен містити скрипт:

  • ImageSize — визначає загальний розмір діаграми.
  • PlotArea — визначає відстань між зображенням і областю, де буде намальована діаграма.
  • Period — визначає часовий період, який має бути відображений на діаграмі.
  • TimeAxis — орієнтація діаграми (вертикальна/горизонтальна).

Скрипт повинен містити хоча б одну з цих команд:

Коментарі[]

За допомогою коментарів можна залишити пояснення до вихідного коду скрипта, оскільки коментарі не обробляються розширенням.

  • Весь текст рядка після знака "'#"' буде вважатися коментарем
  • Весь текст між "'#>"' і "'<#"' буде вважатися коментарем. На відміну від першого способу, що дозволяє розбити текст на рядки.
DateFormat = dd/mm/yyyy # Європейський формат дати

Period = from:01/09/1939 till:02/09/1945 #> Ця діаграма покаже тривалість

Другої світової війни <#

Команди[]

Кожна команда повинна знаходитися на новому рядку. Деякі команди можуть супроводжувати декілька рядків з даними. Ці додаткові рядки повинні починатися з хоча б одного пробілу.

Команди можуть мати одну з наступних форм (в залежності від команди):
"""Команда" = "атрибут(и)""'

DateFormat = dd/mm/yyyy

""'Назва команди" = "атрибут(и)""'

Define $RF = text:Російська Федерація"

"""Команда" ="'

""'атрибут(и)""'
""'атрибут(и)""'
""'і т. д.""'
PlotData =
fontsize:XS width:20
 bar:Japan from:start till:19/02/1945 color:JT
bar:Japan from:19/02/1945 till:14/03/1945 color:AI

Атрибути[]

Якщо для однієї команди може бути задано відразу кілька аргументів, вони вказуються у вигляді пар «ім'я-значення». Кілька значень одного атрибута повинні бути укладені в дужки.

BackgroundColors = bars:darkgrey
PlotData = at:5 shift:(10, -7) text:Foo
Color SB = value:rgb(0.8,0,0.7) legend:Sea_Battles


Список[]

Інформація по всім можливим командам та їх атрибутів.

AlignBars[]

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

early "(за замовчуванням)"
Перший стовпець буде розміщений у лівій частині/крайній верхній частині діаграми («приклеєний» до осі), залишаючи місце між останнім стовпцем і правою/нижній частині діаграми.
late
Протилежно «early»: останній стовпець буде розміщений в крайній правій частині/крайній нижній частині діаграми, залишаючи місце між першим стовпцем і лівої/верхній частині діаграми.
justify
Перший і останній стовпці будуть вилучені один від одного настільки, наскільки це можливо, не залишаючи порожніх місць у діаграмі.
Alignbars = early late justify
TimeAxis = orientation: horizontal

Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- Invalid statement. No '=' found.


Line 13: bar:D from:start till:end

- New command expected instead of data line (= line starting with spaces). Data line(s) ignored.

 



Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- Invalid statement. No '=' found.


Line 13: bar:D from:start till:end

- Invalid statement. No '=' found.


Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- Invalid statement. No '=' found.


Line 13: bar:D from:start till:end

- Invalid statement. No '=' found.


TimeAxis = orientation: vertical

Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- New command expected instead of data line (= line starting with spaces). Data line(s) ignored.

 



Line 13: bar:D from:start till:end

- Invalid statement. No '=' found.


Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- Invalid statement. No '=' found.


Line 13: bar:D from:start till:end

- Invalid statement. No '=' found.


Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 7 errors found
Line 4: DateFormat = рррр

- Invalid DateFormat. Specify as 'dd/mm/yyyy', 'mm/dd/yyyy', 'yyyy' or 'x.y'

 (use first two only for years >= 1800)



Line 9: color:red width:10

- Data expected for command 'PlotData', but line is not indented.

 



Line 9: color:red width:10

- Invalid statement. No '=' found.


Line 10: bar:A from:start till:end

- Invalid statement. No '=' found.


Line 11: bar:B from:start till:end

- Invalid statement. No '=' found.


Line 12: bar:C from:start till:end

- Invalid statement. No '=' found.


Line 13: bar:D from:start till:end

- Invalid statement. No '=' found.


BackgroundColors[]

Дозволяє налаштувати колір фону для безлічі частин діаграми. Ідентифікатори кольорів (color(s)-id») повинні бути попередньо визначені командою Colors.

canvas:"color-id" "(опціональний)"
Встановити колір фону для всього зображення.
bars:"color-id" "(опціональний)"
Встановити колір фону для всіх стовпців.
BackgroundColors = bars:darkgrey

BackgroundColors = canvas:lightgrey bars:darkgrey

BackgroundColors = canvas:lightgrey

BarData[]

Визначає, які стовпці будуть намальовані на графіку, і в якому порядку це буде зроблено. Її використання рекомендується для малювання складних діаграм. Якщо ця команда відсутня, то буде використовуватися команда PlotData.

bar:"bar-id"
Встановлює ідентифікатор стовпця, який буде очікуватися і використовуватися іншими командами. Також буде визначати текст, що відображається на осі, якщо тільки атрибут «text» не було поставлено. Ідентифікатор не повинен містити пробіли, їх можна замінити на нижню тире: «_».
text:"що-небудь" "(опціональний)"
Якщо присутнє, то буде визначати текст, що відображається на осі, заміщаючи собою индентификатор. Може включати одне посилання.
link:"local-URL" "(опціональний)"
Встановлює посилання (URL), яка відображається на осі, як синій текст. Посилання можна встановити або за допомогою атрибута «text», або з допомогою атрибута «link», але не обох.
BarData =
bar:SOAP
bar:Helper text:"Fandom Helper"
bar:Staff text:[[Співробітник]]

Colors[]

Ця команда дозволяє визначити кольори, які можуть використовувати інші команди. Припустимо визначення декількох кольорів, що починаються з нового рядка.

id:"color-id"
Ідентифікатор, який буде використовуватися іншими командами.
value:"color-space"
Визначення самого кольору, яке може бути створене декількома шляхами:
  • "'зумовлений колір"': розширення підтримує 32 константи (див.: Ploticus color page).
  • "'rgb(""'red""',""'green""',""'blue""')"': призначити три числа із значенням від 0 до 1.
  • "'hsv(""'hue""',""'saturation""',""'value""')"': призначити три числа із значенням від 0 до 1.
  • "'gray(""'value""')"': призначити число від 0 (чорний) до 1 (білий).
"Примітки"
  1. 0 і 1 можуть бути визначені тільки у вигляді цілих чисел. При необхідності в проміжних значеннях, потрібно використовувати крапку в якості роздільника частин дробу.
  2. Щоб створити редагування HSV або RGB компонентів колір, дивіться: RGB/HSB конвертер.
"Кольору в шістнадцятковому форматі => rgb()"
Щоб перетворити колір у шістнадцятковому форматі (#D09916) rgb (rgb(0.816,0.600,0.086)):
  1. Відвідайте ColorHexa, щоб знайти цей колір.
  2. Знайдіть рядок: «In a RGB color space, hex ... is composed of RR.R% red, GG.G% green and BB.B% blue».
  3. Розділіть три числа (RR.R, GG.G BB.B) на 100, після чого використовуйте отримані значення в якості значень кольору. (див. також: приклад використання)
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)

Константи[]

Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: More than 10 errors found
Line 7: id:black value:black legend:black

- Data expected for command 'Colors', but line is not indented.

 



Line 7: id:black value:black legend:black

- Invalid statement. No '=' found.


Line 8: id:tan2 value:tan2 legend:tan2

- New command expected instead of data line (= line starting with spaces). Data line(s) ignored.

 



Line 9: id:tan1 value:tan1 legend:tan1

- Invalid statement. No '=' found.


Line 10: id:white value:white legend:white

- Invalid statement. No '=' found.


Line 11: id:pink value:pink legend:pink

- Invalid statement. No '=' found.


Line 12: id:coral value:coral legend:coral

- Invalid statement. No '=' found.


Line 13: id:magenta value:magenta legend:magenta

- Invalid statement. No '=' found.


Line 14: id:claret value:claret legend:claret

- Invalid statement. No '=' found.


Line 15: id:red value:red legend:red

- Invalid statement. No '=' found.


Line 16: id:redorange value:redorange legend:redorange

- Invalid statement. No '=' found.


DateFormat[]

Визначає, яким чином дати, задані іншими командами, повинні бути оброблені.

Підтримувані формати:

dd/mm/yyyy "(дати в більшості європейських країн)"
Дати інтерпретуються, як «день/місяць/рік»
"'Примітка"': дозволено лише для дат, що починаються з 01/01/1800
mm/dd/yyyy "(дати в США)"
Дати інтерпретуються, як «місяць/день/рік»
"'Примітка"': дозволено лише для дат, що починаються з 01/01/1800
рррр (за замовчуванням)

Працює з цілими числами від -9999 до 9999

DateFormat = mm/dd/yyyy

Define[]

Дозволяє задавати константи — часто повторювані частини коду, які зручніше один раз поставити, а далі просто викликати. Константи починаються зі знака "'$"' (знак долара).

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

ImageSize (обов'язково)[]

Визначає розмір зображення. Значення задаються абсолютними величинами.

width:"число/auto"
Ширина кінцевого зображення. Максимум: 1600 піскелів, мінімум: 25 пікселів.
(може бути визначено як «auto», якщо задана вертикальна діаграма).
height:"число/auto"
Висота кінцевого зображення. Максимум: 1600 піскелів, мінімум: 25 пікселів.
(може бути визначено як «auto», якщо задана горизонтальна діаграма).
barincrement:"число"
Кількість пікселів, що має бути додано до зображенні за кожний заданий стовпець.
(дозволено і обов'язково тільки разом з "width: autoс або «height: auto»).

Для досягнення максимальної гнучкості, ви можете дозволити розширенню підбирати розмір зображення, грунтуючись на кількості стовпців та пікселів, які потрібно додати за кожен стовпець. Встановіть «"'height: auto"'» (для горизонтальних діаграм) або «"'width: auto"'» (для вертикальних діаграм).

ImageSize = width:800 height:600

ImageSize = width:800 height:auto barincrement:30

Legend[]

Легенда з'явиться тільки в тому випадку, якщо в скрипті є хоча б один колір з атрибутом legend:, сама команда «Legend». Деякі атрибути є взаємовиключними (див. нижче).

orientation:"hor/ver" "(опціональний)"
Встановити горизонтальну («horizontal») або вертикальну орієнтацію («vertical») (за замовчуванням).
"Обмеження": «orientation = horizontal» і «orientation = right» — взаємовиключні атрибути.
position:"top/bottom/right" "(опціональний)"
Визначає положення легенди щодо діаграми: верх («top»), низ («bottom») (за замовчуванням) або право («right»).
"Обмеження": «position = top», «position = right» і «position = right» — взаємовиключні атрибути.
columns:"число" "(опціонально)"
Число в межах від 1 до 4..
Якщо цей атрибут відсутній, то кількість стовпців легенди визначається наступним чином:
  • "'orientation: horizontal"' :Всі записи легенди розміщуються на одному рядку.
  • "'orientation vertical"':
    • "'position: right"': Всі записи легенди розміщуються в одному стовпці.
    • "'position: top"' або "'bottom': Кількість колонок залежить від кількості записів легенди:
      1-5 записів відповідає 1 стовпцю, 6-10 записів — 2 стовпцями, 11 або більше 3 — стовпцями.

""'Порада:"' нижченаведені атрибути можна пропустити, вказавши тільки в тому випадку, якщо ви не задоволені результатами автоматичної надбудови."

columnwidth:"відстань" "(опціональний)"
Визначає відстань між стовпцями. Може приймати, як абсолютне значення, так і відносно (у відсотках від ширини зображення).
"Обмеження": ігнорується, якщо встановлено «columns = 1».
left:"відстань" "(опціональний)"
Визначає відстань між лівою стороною легенди і лівою стороною зображення. Може приймати, як абсолютне значення, так і відносно (у відсотках від ширини зображення).
top:"відстань" "(опціональний)"
Визначає відстань між верхньою стороною легенди і верхньою стороною зображення. Може приймати, як абсолютне значення, так і відносно (у відсотках від ширини зображення).

LineData[]

Деякі часові діаграми включають в себе декілька періодів, що різняться. Лінія може допомогти їх візуально розмежувати.

at:"час"
Малює лінію, перпендикулярну часовій осі.
Необхідно встановити дату/рік (залежить від DateFormat), де буде намальована лінія.
color:"color-id" "(опціональний)"
Колір лінії.
"'Примітка"': Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors.
layer:"front/back" "(опціональний)"
Визначає, чи повинна лінія з'явиться на передньому плані. За замовчуванням лінія з'являється на задньому плані діаграми («back»).
width:"відстань" "(опціональний)"
Ширина лінії. Може приймати значення від 0.1 (дуже тонко) до 10 (дуже жирно); за умовчанням застосовується одиниця.

"'Додаткові параметри позиціонування"' Ці атрибути використовуються тільки в рідкісних випадках, коли потрібно тонка настройка:

  1. "Паралельність до тимчасової осі" з довільним часом початку та кінця:
    atpos:"позиція"
    from:"время_начала" "(опціональний)"
    till:"время_конца" "(опціональний)"
    Позиція встановлюється абсолютно/щодо, ортогонально до тимчасової осі.
    Необхідно встановити дату/рік (залежить від DateFormat) для встановлення часу початку і кінця.
  2. "Ортогональність до тимчасової осі" з довільними позиціями початку і кінця:
    at:"час"
    frompos:"позиция_начала" "(опціональний)"
    tillpos:"позиция_конца" "(опціональний)"
    Необхідно встановити дату/рік (залежить від DateFormat) для встановлення часу початку і кінця.
    Позиція встановлюється абсолютно/щодо, ортогонально до тимчасової осі (за замовчуванням: повна довжина DrawArea).
  3. "В будь-якому напрямку" з довільними координатами початку і кінця:
    points:("x1","y1")("x2","y2")
    Абсолютні і відносні позиції можуть бути встановлені у вигляді координат. Не залежить від тимчасової осі.

Period (обов'язково)[]

Визначає тимчасово період, відображений на тимчасовій діаграмі. Обидва параметра обов'язкові. Дати необхідно встановлювати відповідно з DateFormat.

from:"час"
Початковий час діаграми. Значення може бути використане в таких командах, як PlotData або TextData.
till:"час"
Кінцевий час діаграми. Значення може бути використане у інших командах.

PlotArea (обов'язково)[]

left:"відстань"
Відстань між лівою частиною всього зображення і лівої областю діаграми. Підтримує абсолютні і відносні значення.
top:"расстояни"
Відстань між верхньою частиною всього зображення і верхній областю діаграми. Підтримує абсолютні і відносні значення.
right:"відстань" (рекомендується)"
Відстань між правою частиною всього зображення і правою областю діаграми. Підтримує абсолютні і відносні значення.
Цей атрибут і атрибут «width» є взаємовиключними.
bottom:"відстань" (рекомендується)"
Відстань між нижньою частиною всього зображення і нижньої областю діаграми. Підтримує абсолютні і відносні значення.
Цей атрибут і атрибут «height» є взаємовиключними.
Мінімально можливе значення становить 20 пікселів (якщо визначена легенда, див. Legend).
width:"відстань" "(небажано)"
Підтримує абсолютні і відносні значення.
"'Не рекомендується до використання"'; можна замінити атрибутом «right».
height:"відстань" "(небажано)"
Підтримує абсолютні і відносні значення.
"'Не рекомендується до використання"'; можна замінити атрибутом «bottom».

"'Зауваження:"'

  1. Атрибути «width» та «height» залишені тільки для зворотної сумісності зі старими схемами. Раніше, область діаграми могла б встановлена тільки з використанням відступів: «"ширина" та"висота"», «"left"» і «"bottom».
  2. Новий спосіб завдання області діаграми відрізняється більшою гнучкістю: зміна розміру зображення не вимагає перевизначення відступів. Це особливо важливо, коли розмір визначається автоматично (див.: ImageSize).

PlotData[]

Використовується для визначення стовпців (позначають часовий період) і додавання тексту в задані місця діаграми.

Для додавання тексту, не пов'язаного з певною датою/роком, або запитувача розширене форматування, потрібно використовувати команду TextData.

Атрибути «text», «at», «from» і «till» завжди застосовуються у відношенні тієї рядки, на якій вони були оголошені. Всі інші атрибути, якщо тільки вони не поєднуються з цими чотирма, що діють для всієї решти блоку з командою або до завдання нового значення.

PlotData підтримує безліч атрибутів (деякі з них є взаємовиключними), які можна розділити на:

Позиційні атрибути[]

at:"час" "(застосовується до конкретної рядку)"
Визначає дату/рік, де має бути встановлений маркер. Залежно від атрибута "'align"', текст знаходиться на початку, кінці або середині цієї позиції. Дати необхідно встановлювати відповідно з DateFormat, або ж можна використовувати атрибути «start» або «end» у відповідності з командою Period завдання для тимчасового відрізка.
"Примітка:" Цей атрибут можна комбінувати з атрибутами "'from"' або "'till"'.
from:"время_начала" "(застосовується до конкретної рядку)"
till:"время_конца" "(застосовується до конкретної рядку)"
Визначає дату/рік, де повинен знаходитися стовпець. Дати необхідно встановлювати відповідно з DateFormat, або ж можна використовувати атрибут «start» у відповідності з командою Period завдання для тимчасового відрізка.
"Примітка:" Цей атрибут можна комбінувати з атрибутом "'о"'.
shift:("x","y") "(опціональний)"
У абсолютних величинах визначає вертикальне і горизонтально положення тексту, що дозволяє:
  • Зрушити текст для уникнення його накладень у випадку з щільно розташованими стовпцями;
  • Розміщення тексту поряд з стовпцем, а поверх нього.

Пов'язані зі стовпцями атрибути[]

bar:"bar-id"
Визначає стовпець, до якого застосовуються атрибути (включаючи опиональные маркерні і позиційні атрибути).

Значення цього атрибута також буде представлено на осі поруч зі стовпцем.

  • Якщо команда BarData відсутня, то стовпці буде промальовані відповідно до PlotData.
  • Якщо команда BarData присутнє, то стовпці будуть промальовані у відповідності з цією командою.
barset:"barset-id" ("опціональний")
Дозволяє стоздать відразу декілька стовпців на одній рядку
Атрибут «bar-id» повинен бути визначений в BarData.
«Barset» (анонімний») не вимагає приречення через BarData.
color:"color-id" ("опціональний")
Визначає колір стовпця.
Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors.

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

width:"відстань" ("опціональний")
Визначає ширину стовпця в абсолютних або відносних одиницях вимірювання.
Значення за замовчуванням розраховується на основі параметрів PlotArea і максимальній кількості стовпців у діаграмі.

Атрибути[]

text:"що-небудь" "(застосовується до конкретної рядку)"
Визначає текст, який буде розташований поруч зі стовпцем. Положення тексту можна визначити: за допомогою атрибута «at», або неявно: з допомогою атрибутів: «from» і «till». Текст підтримує посилання.
textcolor:"color-id" "(опціональний)"
Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors. В іншому випадку буде використано чорний колір.
fontsize:"число/мітка" "(опціональний)"
Визначає розміру тексту допомогу числових значень: від 6 до 30, або (що предпочительно) за допомогою міток: XS (найменший), S (за замовчуванням), M, L або XL (найбільший).
align:"center/left/right" "(опціональний)"
Визначає положення тексту: центр (за замовчуванням)/ліво/право.
link:"URL" "(опціональний, застосовується до конкретної рядку)"
Визначає посилання на ресурс, текст при цьому змінить колір на синій.
"'Notes"'
  1. Може бути використаний тільки з атрибутом "'text"'.
  2. Визначте посилання або відразу, з допомогою атрибута «text», або визначте через «link», не використовуючи обидва меотда відразу.

Маркерні атрибути[]

mark:("символ","color-id")
Устаналивает маркер в задану область.
  • Єдине значення "символу" на сьогоднішній день: "'line"'.
  • Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors. В іншому випадку буде використано чорний колір.

ScaleMajor[]

Одним з цих способів, команда ділить діаграму на менші періоди:

  • Графічним — через вертикальні або горизонтальні лінії (сітку) на діаграмі;
  • Текстовим — через відрізки часу, розташовані зліва внизу діаграми;
  • І графічним і текстовим.
gridcolor:"color-id" "(опціональний)"
Визначає колір сітки, рисуемой на зданем плані діаграми.
Сітка не будуть намальована, якщо команда не знайдеш.
Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors.
unit:"единица_измерения" "(опціональний)"
Опеределяет одиницю виміру для сітки.
Встановіть "'day' (день), "'month"' (місяць) або "'year"' (рік; за замовчуванням).
Якщо значення DateFormat відповідає «yyyy», то тут можна використовувати тільки значення "'year"'.
increment:"число" "(опціональний)"
Визначає (ненульове значення, на яке буде збільшуватися відстань між лініями сітки.
Значення за замовчуванням: "'1"'.
start:"time" "(опціональний)"
Визначає, де повинна з'явитися перша лінія або відрізок часу..

За замовчуванням рівне значенню Period.

"'Примітка"': такі параметри, як, наприклад, орієнтація ліній, залежить від значень TimeAxis.

ScaleMinor[]

Ця команда дозволяє додатково розбити діаграму (синтакс атрибутів).

TextData[]

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

text:"що-небудь"
Сам текст; може включати в себе посилання.
pos:("x","y")
Визначає положення верхній лівій частині текстовго блоку в абсолютних або відносних одиницях вимірювання.
link:"URL" "(опціональний)"
Встановлює посилання (URL), за якою буде вести текст, змінюючи при цьому колір тексту на синій.
textcolor:"color-id" "(опціональний)"
Визначає колір тексту
Ідентифікатор кольору повинен бути визначений заздалегідь командою Colors.
Якщо нічого не встановлено, то за замовчуванням буде використовуватися чорний текст.
fontsize:"integer/tag" "(optional)"
Визначає розміру тексту допомогу числових значень: від 6 до 30, або (що предпочительно) за допомогою міток: XS (найменший), S (за замовчуванням), M, L або XL (найбільший).
tabs:("x1"-"alignment1","x2"-"alignment2...") "(опціональний)"
Визначає положення і вирівнювання для символу табуляції: "'^"' (каретка)
Визначте установки у вигляді рядків: "xn""'-""'alignn", де:
  • "xn" — горизонтальне положення, виражене у абсолютних одиницях виміру, від лівої сторони тексту;
  • "alignmentn" — положення сегмента тексту ("'center"' (центр), "'left"' (ліво) або "'right"' (право)).
lineheight:"відстань" "(опціональний)"
Визначає інтервал між послідовними рядками в абсолютних одиницях вимірювання.
Максимальне значення: 40 пікселів.
Якщо атрибут не встановлений, то інтервал буде визначатися автоматично, на підставі розмірів тексту.

"'Примітки':

  1. Посилання можна встановити або за допомогою атрибута «text», або з допомогою атрибута «link», але не обох.

TimeAxis (обов'язково)[]

Визначає орієнтацію тимчасової осі, а також текстове представлення часових відрізків вздовж цієї осі.

format:"time-format" "(опціональний)"
Визначає формат для дат, які відображаються вздовж осі.
У цей формат підтримується тільки "'yyyy"' (за замовчуванням). Це означає, що якщо атрибут unit: команди ScaleMajor буде мати значення, відмінне від year, то сітка не буде синхронна по відношенню до осі.
orientation:"hor/ver"
Встановити горизонтальну («horizontal») або вертикальну орієнтацію осі.

За замовчуванням використовується горизонтальна орієнтація.

order:"reverse" "(опціональний)"
Визначає "'reverse"' — час на осі буде відображатися в зворотному порядку.

Приклади[]

Вертикальна діаграма[]

Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: 5 errors found
Line 8: color:blue width:50

- Data expected for command 'PlotData', but line is not indented.

 



Line 8: color:blue width:50

- Invalid statement. No '=' found.


Line 9: bar:Quartz from:start till:2008

- Invalid statement. No '=' found.


Line 10: bar:from Monaco:2008 till:2010

- Invalid statement. No '=' found.


Line 11: bar:Wikia from:2010 till:end

- Invalid statement. No '=' found.




ImageSize = width:240 height:310
PlotArea = width:180 height:280 left:40 bottom:20
Period = from:2004 till:2017
AlignBars = justify
TimeAxis = orientation:vertical
ScaleMajor = unit:year increment:1 start:2004

PlotData =
color:blue width:50
bar:Quartz from:start till:2008
bar:from Monaco:2008 till:2010
bar:Wikia from:2010 till:end

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

Перші два рядки скрипта задають: розмір зображення; розмір області, де буде намальована діаграма; відступи зліва і знизу.

Третій рядок задає часовий період, відображений на діаграмі, а четверта визначає відстань між стовпцями (тут: вирівнювання — «justify»). П'ятий рядок задає вертикальну орієнтацію діаграми, а шоста — одиницю виміру (рік), одиницю виміру (1) і початок (2004) основної осі діаграми. Починаючи з сьомого рядка визначається інформація, яку несе в собі діаграма: спершу задається колір стовпців, їх ширина; далі визначаються самі стовпці (назва, початковий і кінцевий роки).

Горизонтальна діаграма[]

Не вдається зібрати вхід EasyTimeline:

EasyTimeline 1.90


Timeline generation failed: More than 10 errors found
Line 9: id:canvas value:gray(0.95)

- Data expected for command 'Colors', but line is not indented.

 



Line 9: id:canvas value:gray(0.95)

- Invalid statement. No '=' found.


Line 10: id:f value:rgb(1,0.584,0)

- Invalid statement. No '=' found.


Line 11: id:f2 value:rgb(1,0.7,0)

- Invalid statement. No '=' found.


Line 12: id:wf value:rgb(0,0.7,0.4)

- Invalid statement. No '=' found.


Line 13: id:wf2 value:rgb(0,0.75,0.4)

- Invalid statement. No '=' found.


Line 14: id:ds value:rgb(0.8,0.2,0.3)

- Invalid statement. No '=' found.


Line 15: BackgroundColors = canvas:canvas

- BackgroundColors definition invalid. Attribute 'canvas': unknown color 'canvas'.

 Specify command 'Color' before this command.



Line 17: Bar:Forum

- Data expected for command 'BarData', but line is not indented.

 



Line 17: Bar:Forum

- Invalid statement. No '=' found.


Line 18: Bar:WikiaForum

- Invalid statement. No '=' found.



ImageSize = width:740 height:160
PlotArea = width:710 height:120 left:20 bottom:20
Period = from:2004 till:2017
AlignBars = justify
TimeAxis = orientation:horizontal
ScaleMajor = unit:year increment:2 start:2004
ScaleMinor = grid:tan2 unit:year increment:1 start:2004

Colors =
id:canvas value:gray(0.95)
id:f value:rgb(1,0.584,0)
id:f2 value:rgb(1,0.7,0)
id:wf value:rgb(0,0.7,0.4)
id:wf2 value:rgb(0,0.75,0.4)
id:ds value:rgb(0.8,0.2,0.3)

BackgroundColors = canvas:canvas

BarData = 
Bar:Forum
Bar:WikiaForum
Bar:Discussions

PlotData =
bar:Forum color:f from:start till:2010 text:"[[Форум]]" 
bar:Forum color:f2 from:2010 till:end
 bar:WikiaForum color:wf from:2010 till:end text:"[[Форум (новий)]]"
bar:WikiaForum color:wf2 from:2015 till:end
bar:Discussions color:ds from:2015 till:end text:"[[Обговорення (розширення)|Обговорення]]"

Горизонтальна діаграма показує розширення або інструменти, що дають Користувачам можливість обговорення (питань).

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

За допомогою команди «Colors» всі задані кольори, що використовуються в діаграмі. Можна помітити, що практично всі вони задані за допомогою RGB, де цифри в дужках являють собою значення насиченості кольору у відсотках, поділену на сто (наприклад, «1,0.584,0» означає, що тут 100 % червоного кольору, 58,4 % зеленого і 0 % — синього). Наступна ж рядок допомагає визначити колір фону, тут: самий перший заданий колір з ID «canvas».

Команда «BarData» допомагає задати всі три основних, використовуваних стовпця, що дозволяє намалювати відразу декілька стовпців на базі одного. Крім цього, для деяких стовпців заданий текст, який є посиланням.

Цікаві факти[]

  • Розширення використовує шрифт FreeSans для відображення тексту.
  • Ви також можете використовувати поточну дату в скрипті. Для цього переконайтеся, що скрипт починається з {{#tag:timeline|, а закінчується — }}. Після цього дату можна вставити, використовуючи чарівні слова, наприклад, {{#time: d/m/Y }} або {{CURRENTDAY2}}/{{CURRENTMONTH2}}/{{CURRENTYEAR}}.

Див. також[]