Шаблон:Graphical timeline/документація

Простий спосіб

Уведіть в свою статтю {{include timeline}}, натисніть попередній перегляд і слідуйте створеному посиланню. Вам буде наведено готовий шаблон; як тільки це буде завершено, поверніться до своєї статті і { {include timeline} } буде відображатися у вашій хронологічній шкалі.

Розробка

Хоча я тестував цей шаблон настільки ретельно, наскільки я можу, я підозрюю, що його можна було б ще поліпшити. Якщо ви виявите будь-які збої або області, які ви хочете налаштувати, повідомте мене про це! Verisimilus T 12:02, 12 червня 2007 (UTC)

Функції шаблону

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

Для чого цей шаблон?

Альтернативою цьому шаблону є m:EasyTimeline, використовуючи синтаксис <template>. EasyTimeline має такі недоліки:

• Створюються піксельовані зображення, які виглядають по-іншому і це збільшує час завантаження сторінки
• Тривалий час налаштування – додаткових 30 хвилин навіть коли ви знаєте, що робите
• "Непробивний" код, який потребує точного синтаксису
• Важко розмістити панелі саме там, де ви їх хочете
• Зміна мінімальних даних і розмірів вимагає модифікацій в багатьох місцях
• Все повинно бути вказано, нічого не автоматизовано
• Шаблон не масштабується, розмір тексту не збільшується.

Використання шаблону

Де використовувати

Хоча короткі часові шкали можуть бути вставлені безпосередньо до статті, деякі редактори скаржаться, що довгі складні графіки розбивають потік сторінки і ускладнюють редагування. Тому ви можете використовувати {{Include timeline}} для розміщення коду часової шкали на окремій сторінці, яка буде автоматично включена.

Починаючи

Ви можете встановити перемикач |help=on в шаблоні, щоб створити швидкі покажчики.
Коли ви розпочнете, ви можете використовувати {{Graphical timeline|help=on}} для створення готового порожнього шаблону, або введіть {{subst:Graphical timeline/blank}} на сторінці пісочниці, збережіть її і відредагуйте отриманий код. Будемо сподіватися, що назви параметрів досить очевидні.

Що означають числа

Числові значення за замовчуванням в одиницях em, тобто висота і ширина з великою M.

Винятком є лівий і правий параметри панелі, які встановлюються з використанням дробових координат. Тобто, код |bar1-left=0 |bar1-right=0.5 |bar2-left=0.666 |bar3-left=0.5 |bar3-right=0.666 вироблятиме bar1, що покриватиме ліву половину області, bar2, що охоплюватиме найправішу третину, і bar3 між ними. Крім того, з експлуатаційних причин одиниці висоти завжди використовуються для створення ширини межі.

Межі панелей

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

Стиль кордону може бути встановлений відповідно до стандартів CSS: solid, dotted, dashed, double, groove, ridge, inset та outset. Ширина знаходиться в тих же одиницях, що і висота, і, якщо нічого не вказано, буде значення у 0.1 чи 0.2, що дорівнює ширині волосини.

Порожні рядки

Якщо залишити порожній параметр, це НЕ те ж саме, що не вказувати його - воно визначить значення для шаблону за замовчуванням. Обов'язково видаліть всі рядки, які ви не будете вказувати.

Геологічні періоди

Щоб вставити геологічний період, використовуйте синтаксис |period3=Кайнозой, з |period3-left=0.1. Потім шаблон вирахує початок, кінець і потрібний колір рядка. Для приклада дивиться Template:Часова шкала кайнозою (backlinks, edit)

Поради

Браузери

На жаль, у різних браузерів є різні способи обробки рядків тексту, в яких знаходиться їх зміст – деякі розтягують зміст, в той час як інші стискають текст. Це означає, що, ймовірно, варто перевірити закінчену часову шкалу, принаймні, в IE і Firefox, особливо якщо ви створюєте складну часову шкалу.

Кольори

Якщо ви задаєте кольори, використовуючи значення html, які виглядають як #e0b539, враховуйте, що деякі старі монітори і багато проєкторів не можуть відображати деякі кольори. Дотримання Web-придатних кольорів забезпечує максимальну сумісність; тобто кратні 33-ом, наприклад, #ff99cc чи #03C.

Додатковий простір

Якщо ви виявите, що панелі, замітки або леґенди з пронумерованими номерами не відображаються, то це може бути через те, що шаблон не закодований для їх обробки. У коді шаблону є інструкції, як додати простору для більшої кількості панелей і т. д. (треба просто копіювати і вставляти); якщо ви не впевнені в цьому, повідомте Verisimilus T.

Просте редагування

Якщо ви створюєте часову шкалу на підсторінці, використовуйте параметр | link-to= . Вкажіть назву сторінки (наприклад, «Шаблон:Моя графічна шкала»), посилання «Редагувати» і «Історія»

Список параметрів

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

Замініть будь-який екземпляр з # на число.

Параметри to і from є обов'язковими, всі інші параметри необов'язкові.

Загальні параметри

Параметри часової шкали

Параметр	Функція	Обов'язково?
from	Початкова дата часової шкали. Може бути від'ємною.	Так
to	Остаточна (найвища) дата часової шкали. Може бути від'ємною.	Так
width	ширина часової шкали	Ні
title	Те, що відображається в рядку заголовка	Ні
title-colour	Колір тла для рядка заголовку	Ні
instance-id	Суфікс для генерованих ідентифікаторів щоб уникнути конфліктів з іншою часовою шкалою	Ні

Геологічні періоди

Параметри періодів

Параметр	Функція
period#	Вкажіть назву періоду; шаблон автоматично виставить початок, кінець і потрібний колір.

Панелі

Параметри панелі

Параметр	Функція
width	ширина часової шкали

Лаґенди

Параметри леґенди

Параметр	Функція
width	ширина часової шкали

Примітки

Параметри приміток

Параметр	Функція
width	ширина часової шкали

При використанні: приклад

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

{{Graphical timeline

|title=Приклад часової шкали
|align=right

|plot-colour=#bbeebb

|from=-550
|to=-500
|scale-increment=10

|width=10
|height=250
|height-unit=px

|legend1=[[Фанерозой]]

|bar1-from=-542
|bar1-left=0
|bar1-right=0.1

|legend2=[[Докембрій]]

|bar2-to=-542
|bar2-left=0
|bar2-right=0.2


|legend3=[[Інфракембрій]]
|legend3-colour=#e0aacc

|bar3-to=-534
|bar3-left=0.1
|bar3-right=0.2
|bar3-colour=#e0aacc

|<!-- If this was bar 4 it would be overlapped by the Botomian bar -->
|bar14-from=-530
|bar14-to=-520
|bar14-left=0.95
|bar14-right=1.05
|bar14-colour=red
|legend14=[[Кембрійський вибух]]

|<!--Epochs & stages-->
|bar5-text=[[Едіакарій]]
|bar5-to=-540
|bar5-left=0.2
|bar5-border-width=1
|bar5-colour=#cc9999

|bar6-text=[[Кембрій]]
|bar6-from=-542
|bar6-to=-534
|bar6-left=0.2
|bar6-border-width=0.1
|bar6-colour=#99cc99

|bar7-text=[[Томотський ярус]]
|bar7-from=-534
|bar7-to=-530
|bar7-left=0.1
|bar7-colour=#99cc99
|bar7-border-width=0.1

|bar8-from=-530.1
|bar8-to=-529.9
|bar8-left=0.2
|bar8-colour=black

|bar9-text=[[Атдабанський ярус]]
|bar9-from=-530
|bar9-to=-524
|bar9-left=0.1
|bar9-right=0.95
|bar9-colour=#99cc99

|bar10-text=[[Ботомьский ярус]]
|bar10-from=-524
|bar10-to=-518
|bar10-left=0.1
|bar10-colour=#99cc99
|bar10-border-width=0.1

|bar11-text=[[Тойонський ярус]]
|bar11-from=-518
|bar11-to=-513
|bar11-left=0.1
|bar11-border-width=0.1
|bar11-colour=#99cc99


|note1=Основа кембрію
|note1-at=-542
|note1-colour=green

|note2=[[Середній кембрій]]
|note2-nudge-left=8.5
|note2-nudge-down=0
|note2-at=-507
|note2-remove-arrow=yes

|caption=Приблизний часовий масштаб подій на початку [[Кембрій|кембрійського]] [[Період (геологія){{!}}періоду]].
<br>Шкала осей у мільйонах років тому.
}}

Примітки

• Якщо вам потрібно вставити | у посиланні, то використовуйте {{!}} замість цього (наприклад, у заголовку)
• Якщо ви не вкажете, коли повинна починатися або закінчуватися рядок, вона триватиме до краю графіка
• Текст не повинен бути занадто довгим для панелі
• Переповнені панелі з текстом також обробляються по-різному: текст виштовхується праворуч від рядка у Firefox, але тримається в межах у IE. Спробуйте вручну вводити переноси рядків у міру необхідності, замість того щоб покладатися на браузери.