Тимчасова діаграма — вбудоване в статтю зображення на основі вікірозмітки, що представляє собою графічну ілюстрацію викладених даних. Може бути одновимірною ілюстрацією, вертикальною або горизонтальною, а також двомірною.
За роботу діаграм відповідає розширення MediaWiki EasyTimeline, підключене на всіх проєктах Фандома за замовчуванням.
Синтаксис[]
Вступ[]
Для створення діаграми потрібно написати скрипт, укладений між спеціальним тегом:
<timeline> script </timeline>
При цьому EasyTimeline перетворює скрипт в зображення формату PNG і (опціонально) інтерактивну карту. Сам по собі синтаксис EasyTimeline досить простий для освоєння, тому ви цілком можете відразу прочитати приклади, щоб зрозуміти основи.
Команди[]
EasyTimeline підтримує наступні команди для створення скрипта:
- Загальне розміщення: ImageSize, PlotArea, Colors, BackgroundColors, AlignBars
- Інтерпретація і подання дат і періодів: ImageSize, PlotArea, Colors, BackgroundColors, AlignBars
- Посилання на багаторазово повторювані частини коду: Define
- Упорядкування, поділ, імена груп подій і періодів: BarData, Legend, LineData
- Періоди, опису та події: PlotData, TextData
Засади[]
Скрипт може містити команди і коментарі. Кожна команда містить один або кілька атрибутів. Команди та їх атрибути можуть бути написані літерами нижнього, верхнього або змішаного регістру — технічно він не має значення; проте варто дотримуватися єдиного стилю при написанні сценарію для того, щоб код був максимально зручний для читання.
Обов'язкові команди, які повинен містити скрипт:
- 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
(use first two only for years >= 1800)
|
Не вдається зібрати вхід EasyTimeline: EasyTimeline 1.90
(use first two only for years >= 1800)
|
Не вдається зібрати вхід EasyTimeline: EasyTimeline 1.90
(use first two only for years >= 1800)
|
TimeAxis = orientation: vertical |
Не вдається зібрати вхід EasyTimeline: EasyTimeline 1.90
(use first two only for years >= 1800)
|
Не вдається зібрати вхід EasyTimeline: EasyTimeline 1.90
(use first two only for years >= 1800)
|
Не вдається зібрати вхід EasyTimeline: EasyTimeline 1.90
(use first two only for years >= 1800)
|
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 (білий).
- "Примітки"
- 0 і 1 можуть бути визначені тільки у вигляді цілих чисел. При необхідності в проміжних значеннях, потрібно використовувати крапку в якості роздільника частин дробу.
- Щоб створити редагування HSV або RGB компонентів колір, дивіться: RGB/HSB конвертер.
- "Кольору в шістнадцятковому форматі => rgb()"
- Щоб перетворити колір у шістнадцятковому форматі (#D09916) rgb (rgb(0.816,0.600,0.086)):
- Відвідайте ColorHexa, щоб знайти цей колір.
- Знайдіть рядок: «In a RGB color space, hex ... is composed of RR.R% red, GG.G% green and BB.B% blue».
- Розділіть три числа (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:
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 (дуже жирно); за умовчанням застосовується одиниця.
"'Додаткові параметри позиціонування"' Ці атрибути використовуються тільки в рідкісних випадках, коли потрібно тонка настройка:
- "Паралельність до тимчасової осі" з довільним часом початку та кінця:
- atpos:"позиція"
- from:"время_начала" "(опціональний)"
- till:"время_конца" "(опціональний)"
- Позиція встановлюється абсолютно/щодо, ортогонально до тимчасової осі.
- Необхідно встановити дату/рік (залежить від DateFormat) для встановлення часу початку і кінця.
- "Ортогональність до тимчасової осі" з довільними позиціями початку і кінця:
- at:"час"
- frompos:"позиция_начала" "(опціональний)"
- tillpos:"позиция_конца" "(опціональний)"
- Необхідно встановити дату/рік (залежить від DateFormat) для встановлення часу початку і кінця.
- Позиція встановлюється абсолютно/щодо, ортогонально до тимчасової осі (за замовчуванням: повна довжина DrawArea).
- "В будь-якому напрямку" з довільними координатами початку і кінця:
- points:("x1","y1")("x2","y2")
- Абсолютні і відносні позиції можуть бути встановлені у вигляді координат. Не залежить від тимчасової осі.
Period (обов'язково)[]
Визначає тимчасово період, відображений на тимчасовій діаграмі. Обидва параметра обов'язкові. Дати необхідно встановлювати відповідно з DateFormat.
- from:"час"
- Початковий час діаграми. Значення може бути використане в таких командах, як PlotData або TextData.
- till:"час"
- Кінцевий час діаграми. Значення може бути використане у інших командах.
PlotArea (обов'язково)[]
- left:"відстань"
- Відстань між лівою частиною всього зображення і лівої областю діаграми. Підтримує абсолютні і відносні значення.
- top:"расстояни"
- Відстань між верхньою частиною всього зображення і верхній областю діаграми. Підтримує абсолютні і відносні значення.
- right:"відстань" (рекомендується)"
- Відстань між правою частиною всього зображення і правою областю діаграми. Підтримує абсолютні і відносні значення.
- Цей атрибут і атрибут «width» є взаємовиключними.
- bottom:"відстань" (рекомендується)"
- Відстань між нижньою частиною всього зображення і нижньої областю діаграми. Підтримує абсолютні і відносні значення.
- Цей атрибут і атрибут «height» є взаємовиключними.
- Мінімально можливе значення становить 20 пікселів (якщо визначена легенда, див. Legend).
width:"відстань" "(небажано)"- Підтримує абсолютні і відносні значення.
- "'Не рекомендується до використання"'; можна замінити атрибутом «right».
height:"відстань" "(небажано)"- Підтримує абсолютні і відносні значення.
- "'Не рекомендується до використання"'; можна замінити атрибутом «bottom».
"'Зауваження:"'
- Атрибути «width» та «height» залишені тільки для зворотної сумісності зі старими схемами. Раніше, область діаграми могла б встановлена тільки з використанням відступів: «"ширина" та"висота"», «"left"» і «"bottom».
- Новий спосіб завдання області діаграми відрізняється більшою гнучкістю: зміна розміру зображення не вимагає перевизначення відступів. Це особливо важливо, коли розмір визначається автоматично (див.: 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"
- Визначає стовпець, до якого застосовуються атрибути (включаючи опиональные маркерні і позиційні атрибути).
Значення цього атрибута також буде представлено на осі поруч зі стовпцем.
- 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"'
- Може бути використаний тільки з атрибутом "'text"'.
- Визначте посилання або відразу, з допомогою атрибута «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 пікселів.
- Якщо атрибут не встановлений, то інтервал буде визначатися автоматично, на підставі розмірів тексту.
"'Примітки':
- Посилання можна встановити або за допомогою атрибута «text», або з допомогою атрибута «link», але не обох.
TimeAxis (обов'язково)[]
Визначає орієнтацію тимчасової осі, а також текстове представлення часових відрізків вздовж цієї осі.
- format:"time-format" "(опціональний)"
- Визначає формат для дат, які відображаються вздовж осі.
- У цей формат підтримується тільки "'yyyy"' (за замовчуванням). Це означає, що якщо атрибут
unit:
команди ScaleMajor буде мати значення, відмінне відyear
, то сітка не буде синхронна по відношенню до осі.
- orientation:"hor/ver"
- Встановити горизонтальну («horizontal») або вертикальну орієнтацію осі.
За замовчуванням використовується горизонтальна орієнтація.
- order:"reverse" "(опціональний)"
- Визначає "'reverse"' — час на осі буде відображатися в зворотному порядку.
Приклади[]
Вертикальна діаграма[]
Не вдається зібрати вхід EasyTimeline:
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:
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}}
.
Див. також[]
Скіни |
| ||||||
---|---|---|---|---|---|---|---|
Елементи оформлення |
| ||||||
Контент-елементи |