WikiDer > Справка: синтаксис EasyTimeline - Википедия

Эта справочная страница является практическое руководство. В нем подробно описаны процессы или процедуры некоторых аспектов норм и практики Википедии. Это не один из Политика или рекомендации Википедии, и может отражать разные уровни консенсус и проверка.

Ярлык H: ET

В EasyTimeline функция создает встроенный изображение из викитекста. Изображение может быть одномерной схемой (по горизонтали или вертикали) или двухмерной. Название «EasyTimeline» относится к возможности применить функцию с временной шкалой по горизонтали или вертикали, возможно, с другим параметром в другом направлении, но есть также и другие возможности.

Смотрите также Википедия: Хронология, mw: Расширение: EasyTimeline, mw: Расширение: EasyTimeline / синтаксис, Активация EasyTimeline на других установках MediaWiki

Вступление

Графические временные шкалы могут быть созданы путем размещения скрипта между специальными тегами:

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

Затем будет вызван EasyTimeline для рендеринга изображения PNG и (необязательно) интерактивной карты.

Отказ от ответственности: Несмотря на то, что EasyTimeline разработан для простоты использования, сложная графическая шкала времени - нетривиальное дело. Составление простой шкалы времени может занять полчаса (или даже меньше, если за основу взят подходящий пример). Композиция и корректировка больших временных шкал могут занять несколько часов. Однако добавление или исправление временной шкалы, независимо от того, насколько она сложна, должно быть относительно простым делом даже для участников, не обладающих экспертными знаниями синтаксиса, описанного здесь.

Не стесняйтесь спросить автор EasyTimeline За советом.

Доступные команды

Команды скрипта определяют:

• Общий вид: Размер изображения, Участок, Цвета, ФонЦвета, AlignBars
• Толкование и представление дат и периодов: Формат даты, Период, ScaleMajor, ScaleMinor, TimeAxis
• События, периоды и описательные тексты: PlotData, TextData
• Как упорядочивать, разделять и называть группы событий и периодов: BarData, Легенда, LineData
• Сокращения для фрагментов кода сценария, которые встречаются несколько раз: Определять

Следующие команды являются обязательными: Размер изображения, Участок, Период и TimeAxis. Требуется хотя бы одна из следующих команд: PlotData и / или TextData. Одно или оба могут встречаться несколько раз. Все остальные команды необязательны.

Дело: Команды и их атрибуты могут быть указаны в нижнем, верхнем или смешанном регистре. Пожалуйста, постарайтесь быть последовательным в применении, так как это улучшит читаемость, например используйте смешанный регистр для всех команд и строчные буквы для всех атрибутов.

Общие правила синтаксиса

Скрипт может содержать команды и комментарии. За каждой командой следует один или несколько атрибутов.

Команды

Команды должны начинаться с первой позиции строки. За некоторыми командами может следовать несколько строк данных и / или параметров. Эти дополнительные строки должны начинаться как минимум с одного пробела или быть полностью пустыми (последнее полезно для визуальной группировки связанных данных. линий).

Команды имеют одну из следующих форм, в зависимости от типа команды:

Команда = атрибут (ы)

DateFormat = дд / мм / гггг

Имя команды = атрибут (ы)

Цвет Jp = значение: красный; легенда: Япония.

Команда =  атрибут (ы)  атрибут (ы)  и Т. Д.

PlotData = fontsize: XS ширина: 20 бар: Япония с: начало по: 19.02.1945 цвет: JT bar: Япония с: 19.02.1945 по: 14.03.1945 цвет: AI

Комментарии

Можно указать однострочные и многострочные комментарии:

• Текст после знака решетки # будет рассматриваться как комментарий
• Текст между #> и <# также будет рассматриваться как комментарий. Комментарии могут занимать несколько строк, если помечены таким образом.

Примеры:

Dateformat = dd / mm / yyyy # Европейский формат датыPeriod = с: 01.09.1939 по: 02.09.1945 #> эта диаграмма покажет полную продолжительность Второй мировой войны <#

Атрибуты

Если для одной команды можно указать несколько атрибутов, они помечаются как пары «имя: значение». Если для одного атрибута может быть указано несколько значений, их следует заключать в круглые скобки.

Примеры:

AlignBars = justifyColor SB = значение: rgb (0.8,0,0.7) легенда: Sea_Battles

Параметры и элементы данных

Большинство команд принимают только атрибуты, указанные в той же строке.

Блоки данных: некоторые команды, например BarData, PlotData, TextData, Цвета ожидать блок данных состоящий из одного или нескольких строки данных. Строки данных должны начинаться с одного или нескольких пробелов. Блок данных считается завершенным, когда встречается начало линии с непустым пробелом (исключение: пустые строки игнорируются, они могут использоваться для группировки связанных строк данных внутри блока).

Атрибуты в блоке данных концептуально можно разделить на параметры и элементы данных. Блоки данных могут содержать смешанные параметры и элементы данных.

Элементы данных: в атрибутах строк данных текст, из, до и в всегда применяются только к той строке, в которой они встречаются.

Параметры: в атрибутах строк данных, таких как цвет и размер шрифта имеют разные последствия в зависимости от контекста. Если эти параметры встречаются в строке без элементов данных, они устанавливают новые значения по умолчанию для следующих строк данных. Если они появляются в строке, смешанной с элементами данных, они применяются только к этой строке, тем самым отменяя значение по умолчанию, которое было установлено ранее.

Пример:

# В этом примере нарисованы два набора полосок, красного и синего цвета соответственно, # но в каждом наборе одна полоса (обозначающая периоды войны) будет нарисована зеленым. PlotData = color: red fontsize: S # Установить панель по умолчанию: СССР из : 1919 - 1922 текст: Ленин # красная полоса: СССР с: 1922 по: 1953 текст: Сталин # красная полоса: СССР с: 1939 по: 1945 текст: Вторая мировая война цвет: зеленый # зеленая полоса: СССР с: 1953 до: 1964 текст: Krushchev # красный цвет полосы: синий # изменить цвет полосы по умолчанию: США с: 1913 по: 1921 текст: Wilson # синяя полоса: США с: 1917 по: 1918 текст: Первая мировая война цвет: зеленый # зеленая полоса : США с: 1921 по: 1923 текст: Harding # синяя полоса #> этот многострочный комментарий не завершает команду PlotData, даже если предыдущая строка не начинается с пробела <# bar: США с: 1923 по: 1929 текст: Кулидж # blue barTextData = # теперь учитываются PlotData ed полные вкладки: ... и т. д.

Специальные символы

• #, #>, <# (хеш, хеш + «больше», «меньше» + хеш): см. Комментарии
• ~ (тильда) в тексте означает: разрыв строки
• ^ (каретка) в текстах означает: табуляция
• _ (подчеркивание) в текстах означает: пробел
• $ (знак доллара) предшествует любой пользовательской константе

Справочник команд

Для каждой команды перечислены допустимые атрибуты. Некоторые команды и атрибуты / orattributes необязательны (O).

Для некоторых команд определенные атрибуты являются взаимоисключающими (будут объяснены в соответствующих случаях).

AlignBars

Полосы всегда будут рисоваться на равных расстояниях. Эта команда указывает, должны ли столбцы быть разнесены как можно дальше друг от друга, или между левой / верхней стороной диаграммы и первой полосой или между последней полосой и правым должен быть зарезервирован некоторый пробел. / нижняя часть диаграммы.

рано (по умолчанию)

Первый столбец будет помещен в крайнее левое / крайнее верхнее положение диаграммы («приклеен» к оси), оставляя пространство между последним столбцом и правой / нижней стороной диаграммы.

поздно

Напротив рано: последняя полоса будет помещена как можно дальше к правой / нижней стороне диаграммы, оставляя пространство между линией оси (левая / верхняя сторона диаграммы) и первой полосой.

оправдывать

Первый и последний столбцы будут размещены как можно дальше друг от друга, не оставляя пустого места с обеих сторон графика. Когда присутствует только одна полоса, выравнивание будет интерпретировано как «центрированное».

Примеры:

	TimeAxis = ориентация: горизонтальная			TimeAxis = ориентация: вертикальная
Alignbars =

ФонЦвета

Эта команда позволяет указать цвет фона для различных частей диаграммы. Любой цвет. я быУказанные s должны быть определены сначала с использованием Цвета.

холст (O)

Укажите цвет фона для всего изображения.

бары (O)

Укажите цвет фона для всех полос.

Примеры:

BackgroundColors = полосы: темно-серыйBackgroundColors = холст: светло-серый полосы: темно-серыйBackgroundColors = холст: светло-серый

BarData

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

Для сложных временных шкал с большим количеством полос рекомендуется использовать эту команду:

• Это упростит переупорядочивание отображаемых данных.
• Названия бара, указанные в PlotData можно проверить по этому списку, что предотвратит опечатки.

бар

определяет идентификатор бара. Другие команды (особенно PlotData) будет ожидать этот идентификатор для справки. Это также будет метка, которая будет отображаться вдоль оси, если атрибут текст настоящее. Идентификатор панели не должен содержать пробелов: используйте вместо них подчеркивания, они будут преобразованы в пробелы, как и в случае с заголовками статей.

текст (O)

Если указано, это указывает текст, который будет представлен вдоль оси, вместо идентификатора полосы. См. Также правила для ввод текста. В текст может быть включена одна встроенная ссылка (см. Примечание 1).

ссылка (O)

Укажите веб-ссылку (см. Примечание 1) (URL). Метка вдоль оси будет отображаться в виде синей интерактивной ссылки.

Примечания

1. Либо используйте атрибут связь, или встроенная ссылка в атрибуте текст, не оба.

Примеры:

BarData = bar: Япония bar: US text: "United States" # ссылка в PlotData на bar "US", но показывает полосу "United States": текст для Китая: [[China]] # label Китай будет отображаться в виде синей интерактивной ссылки на статья в английской Википедии о Китае

Следующие строки производят тот же результат (только ссылка в PlotData изменения):

bar: текст для США: [[United_States]] bar: текст для США: ссылка "United States": http: //www.wikipedia.org/wiki/United_Statesbar: ссылка United_States: http: //www.wikipedia.org/wiki/ Соединенные Штаты

Цвета

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

я бы

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

ценить

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

• предопределенная цветовая константа, для которой распознаются 32 предопределенных названия цвета (см. Цветная страница Ploticus где все эти константы определены).
• rgb (красный, зеленый, синий): укажите 3 числа от 0 (минимальное) до 1 (максимальное)
• серый (значение): укажите число от 0 (черный) до 1 (белый)

легенда (O)

Задает текст, который должен отображаться в легенде для этого цвета. Если этот атрибут опущен, в легенде не будет вообще никаких записей. Видеть Ввод текста для правил.

Пример:

Цвета = id: значение войны: красная легенда: идентификатор периода войны: мирное значение: синяя легенда: мирное время id: значение договора: rgb (0,6,0,0,6) id: светло-серый значение: серый (0,9) id: темно-серый значение: серый (0,1)

Формат даты

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

Допустимые форматы даты:

дд / мм / гггг

Даты интерпретируются как день / месяц / год.

Примечание: этот формат разрешен только для дат, начинающихся с 01.01.1800

мм / дд / гггг

Даты интерпретируются как месяц / день / год.

Примечание: этот формат разрешен только для дат, начинающихся с 01.01.1800

гггг

это касается целые числа от -9999 до +9999

Пример:

DateFormat = мм / дд / гггг

Определять

Эта команда позволяет определять текстовые константы, т. Е. Сокращения для фрагментов кода сценария, которые встречаются несколько раз. Текстовые константы всегда должны начинаться с символа $ (знак доллара).

Пример:

Определить $ wide = width: 30 Определить $ thin = width: 10 Определить $ bardefaults = $ wide fontsize: S

ImageSize (обязательно)

Эта команда определяет общий размер окончательного изображения. Укажите значения в абсолютные измерения.

ширина

Ширина конечного изображения: максимум 1600 пикселей, минимум 25

высота

Высота конечного изображения: максимум 1200 пикселей, минимум 25

Для максимальной гибкости вы можете позволить сценарию вычислять высоту или ширину изображения на основе количества полосок и количества в пикселях, добавляемых на каждую полосу. Уточнить высота: авто (для горизонтальной оси времени) или ширина: авто (для вертикальной оси времени).

Это особенно полезно, когда количество столбцов на временной шкале может со временем меняться снова и снова. Или обеспечить равные расстояния между полосами на изображениях с большим количеством узких полос, где вскоре будут заметны различия в количестве белого пространства (см. Реальный пример Шаблон: Вокальные и инструментальные диапазоны высоты тона). Или чтобы убедиться, что несколько связанных временных шкал всегда используют одинаковое расстояние между барами, независимо от того, сколько тактов каждая содержит (см. Реальный пример Список пап (графический)). Короче говоря, в большинстве случаев это хорошая идея.

бар

Сумма в пикселях, которая должна быть добавлена ​​к размеру изображения для каждой указанной полосы (обязательно и разрешено только в сочетании с width: auto или height: auto).

Примеры:

ImageSize = width: 800 height: 600ImageSize = width: 800 height: автоинкремент полосы: 30

Легенда

Легенда будет отображаться только при наличии этой команды. Есть несколько способов определить внешний вид и положение легенды. Некоторые атрибуты являются взаимоисключающими (см. Ниже).

ориентация (O)

Укажите горизонтальный или вертикальный (по умолчанию).

ограничение: direction = 'horizontal' и position = 'right' являются взаимоисключающими

позиция (O)

Определяет размещение легенды относительно области диаграммы. Укажите верх, низ (по умолчанию) или справа.

ограничение: direction = 'horizontal' и position = 'right' являются взаимоисключающими

столбцы (O)

Укажите 1, 2, 3 или 4. Если этот атрибут опущен, количество столбцов определяется следующим образом:

• ориентация горизонтальная : Столбцы атрибутов здесь не применяются. Все записи будут в одной строке.
• ориентация вертикальная :
  • положение право : Все записи будут в одном столбце
  • позиция наверху или же Нижний : Количество столбцов зависит от количества отображаемых записей:
    1-5 записей: 1 столбец, 6-10 записей: 2 столбца, 11 или более записей: 3 столбца.

Совет: сначала вы можете пропустить следующие параметры и добавлять их только тогда, когда настройки по умолчанию вас не устраивают.

ширина колонки (O)

Определяет расстояние между столбцами. Вы можете указать абсолютное расстояние или относительное расстояние (в процентах от ширины страницы).

ограничение: этот параметр игнорируется, если указано или подразумевается columns = 1.

оставили (O)

Определяет расстояние между левой стороной легенды и левой стороной страницы. Вы можете указать абсолютное или относительное расстояние (в процентах от ширины страницы).

верх (O)

Определяет расстояние между верхом легенды и низом страницы. Вы можете указать абсолютное или относительное расстояние (в процентах от высоты страницы).

Примеры:

Легенда = ориентация: вертикальное положение: нижние столбцы: 3 ширина столбца: 140 Легенда = ориентация: горизонтальное положение: нижняя легенда = слева: 100 верхняя часть: 120 столбцов: 3

LineData

Некоторые временные рамки охватывают несколько четко различающихся периодов, и линия, разделяющая эти периоды, может служить наглядным пособием.

в

Рисует линию, перпендикулярную оси времени (по умолчанию максимальная длина, см. Также ниже).
Укажите дату / год, где должна быть проведена линия в соответствии с указанным Формат даты.

цвет

Укажите цвет, которым должна рисоваться линия.

Примечание: Указанный идентификатор цвета должен быть сначала определен командой Цвета.

слой

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

ширина

укажите значение от 0,1 (очень тонкий) до 10 (очень толстый)

Только в редких случаях для полной гибкости могут потребоваться следующие дополнительные атрибуты:

Расширенные возможности позиционирования

Вы можете рисовать линии в любом направлении. Доступны следующие варианты:

• Перпендикулярно оси времени с произвольными точками запуска и остановки: в:Дата frompos:позиция тилпос:позиция
• Параллельно оси времени с произвольными точками старта и останова из:Дата до:Дата atpos:позиция
• В любом направлении с произвольными точками запуска и остановки: точки: (x1, y1) (x2, y2)

Атрибуты в, из и до ожидайте дату или год в соответствии с указанным Формат даты.
Атрибуты frompos, тилпос, atpos ожидать координаты (например, значения пикселей)

Пример:

LineData = layer: front # все линии перед полосами, если не указано иное в: 1 цвет: желтый # перпендикулярно оси времени на всю длину в: 2 цвет: оранжевый слой: задний # перпендикулярно оси времени на всю длину, но за решетками в: 4 frompos: 50 доpos: 105 цвет: зеленый # перпендикулярно оси времени, с указанными точками начала и остановки от: 5 до: 8 atpos: 50 цвет: красный # параллельно точкам оси времени: (100,20) (170,105) цвет: синяя ширина: 3 # от одной произвольной абсолютной позиции к другой, очень толстая 

Обратите внимание, что в приведенном выше примере эти «абсолютные позиции» отображаются в контексте ImageSize = ширина: 200 высота: 120 и PlotArea = left: 20 right: 10 top: 10 bottom: 20.

Период (обязательно)

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

из

Хронология начинается здесь. На указанное значение можно ссылаться как на начало в таких командах, как PlotData и TextData.

до

Время здесь заканчивается. На указанное значение можно ссылаться как на конец в других командах.

Пример:

Период = с: 09.01.1939 по: 09.02.1945

PlotArea (обязательно)

ширина

Укажите значение в абсолютном или относительном измерения. (не использовать больше, Смотри ниже)

высота

Укажите значение в абсолютных или относительных измерениях. (не использовать больше, Смотри ниже)

оставили

Поле между левой стороной изображения и левой стороной области графика. Укажите значение в абсолютных или относительных измерениях.

верх

Поле между верхом изображения и верхом области графика. Укажите значение в абсолютных или относительных измерениях.

верно

Поле между правой стороной изображения и правой стороной области графика. Укажите значение в абсолютных или относительных измерениях.

Нижний

Поле между низом изображения и низом области графика. Укажите значение в абсолютных или относительных измерениях.

атрибуты ширины / высоты

Эти атрибуты сохранены только для обратной совместимости. Раньше площадь участка можно было определить только по его общей ширина и высота, и оставили и Нижний поля. Теперь вы можете указать все четыре поля, и рекомендуется сделать это, а не использовать ширина и высота атрибутов больше. Преимущество заключается в дополнительной гибкости: при изменении общего размера изображения вам также не нужно настраивать определение области печати. Это еще более важно, когда размер изображения рассчитывается автоматически (см. Размер изображения).

Пример:

# например дополнительное пространство слева и под областью графика для меток осей и легенды PlotArea = left: 40 bottom: 60 top: 10 right: 10 

PlotData

Используется для определения полос (символизирующих период времени) и добавления текста рядом с этими полосами в определенной позиции.

Для текстов, не относящихся к определенному периоду или дате / году или требующих обширного форматирования, используйте команду TextData.

Атрибуты text, at, from и till всегда применяются только к той строке, в которой они встречаются. Все остальные атрибуты, если они не объединены с одним из этих четырех, действуют по умолчанию для оставшейся части командного блока или до тех пор, пока не будет указано новое значение по умолчанию, и могут быть отменены для одной строки. См. «Параметры и элементы данных» для получения дополнительной информации и примера.

PlotData принимает множество атрибутов, некоторые из которых исключают друг друга. Эти атрибуты можно сгруппировать следующим образом:

• Позиционные атрибуты
• Атрибуты, связанные с панелью
• Текстовые атрибуты
• Маркер атрибут

Позиционные атрибуты

в

Задает дату / год размещения текста. В зависимости от атрибута выровнять текст либо начинается, заканчивается или центрируется в этой позиции. Используйте формат даты / года, как указано в Формат даты или укажите Начните или же конец который относится к временным рамкам, определенным командой Период.

NB: Этот атрибут нельзя комбинировать с атрибутами из или же до.

из

Определяет, с какой даты / года должна начинаться полоса. Используйте формат даты / года, как указано в Формат даты или укажите Начните который относится к временным рамкам, определенным командой Period.

NB: Этот атрибут следует использовать в сочетании с атрибутом до и не может сочетаться с атрибутом в.

до

Указывает, в какой день / год должен заканчиваться столбец. Используйте формат даты / года, как указано в DateFormat, или укажите конец который относится к временным рамкам, определенным командой Period.

NB: Этот атрибут следует использовать в сочетании с атрибутом из и не может сочетаться с атрибутом в.

сдвиг

Задает абсолютное смещение по горизонтали и вертикали. измерения для текста. Это позволяет:

• Тексты нужно сдвинуть, чтобы избежать дублирования
• Размещение текста рядом с полосой, а не поверх нее.

Примеры:

DateFormat = dd / mm / yyyyPeriod = с: 01.01.1939 по: 02.09.1945 PlotData = width: 15 bar: Япония с: 01.09.1939 по: 27.09.1940 цвет: зеленая полоса: Япония с : 27.09.1940 до: 19.02.1945 цвет: желтая полоса: Япония с: 19.02.1945 по: 14.03.1945 цвет: синяя полоса: Япония с: 02.09.1945 до: конечный цвет : red at: 12.07.1941 смена: (0, -2) текст: "<- Атака на Перл-Харбор"

Атрибуты, связанные с панелью

бар

Определяет, к какой полосе применяются все остальные атрибуты.

Когда команда BarData не использовался, столбцы будут отображаться в том порядке, в котором они встречаются в любом PlotData блок данных. Указанный здесь идентификатор также будет текстом, представленным вдоль оси рядом с полосой.

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

барсет

Перезапускает отображение полосок «сверху», позволяя размещать несколько полосок на одной строке. Синтаксис: barset: имя
Можно добавить пустые строки, чтобы пропустить строки, которые вы не хотите добавлять с помощью таких объявлений, как в: 1234 без дополнительных атрибутов.

цвет

Задает цвет, которым должна быть нарисована полоса.

Указанный идентификатор цвета следует сначала определить с помощью команды Цвета.

ширина

Определяет ширину полосы в абсолютном или относительном измерения.

Пример:

BarData = bar: американский текст: United States bar: SB text: Sea BattlesColors = id: значение US: синяя легенда: United_States id: значение SB: rgb (0.8,0,0.7) легенда: Sea_BattlesPlotData = width: 0.3 # см. Примечание 1 бар: SB с: 08.07.1942 по: 02.09.1943 текст: Guadalcanal цвет: SB # см. примечание 2 бар: США от: начало до: конец цвет: США # см. примечание 3 бар: середина от: начало до : end color: US # см. примечание 4 бар: US at: 12.07.1941 текст: 7/12 Pearl Harbor # см. примечание 5

Примечания:

1. эта строка устанавливает ширину полосы по умолчанию для оставшейся части блока данных
2. эта строка определяет полосу, которую нужно нарисовать, и текст, который нужно разместить на ней одновременно
3. bar US будет нарисован перед тактом SB, даже если он указан после него, потому что команда BarData определяет последовательность
4. bar Midway будет отклонен, потому что он не объявлен командой BarData
5. последняя строка не приведет к отображению полосы, она просто указывает, на какой полосе следует разместить текст

Текстовые атрибуты

текст

Определяет текст, который должен быть нанесен на полосу или рядом с ней. Положение привязки может быть определено явно с помощью атрибута "в"или неявно с атрибутами"из" и "до".

В последнем случае текст будет расположен в середине определенного сегмента полосы. Смотрите также Ввод текста для правил

В текст могут быть встроены ссылки (см. Примечания 1 и 2) для использования в интерактивных картах.

цвет текста (O)

Определяет цвет текста. Указанный идентификатор цвета следует сначала определить с помощью команды Цвета. Если не указано иное, предполагается черный цвет.

размер шрифта (O)

Укажите размер кегля от 6 до 30 или (предпочтительно) один из тегов XS, S (по умолчанию), M, L или XL. Видеть Поддержка шрифтов Больше подробностей.

выровнять (O)

Укажите центр (по умолчанию), слева или справа.

ссылка (O)

Укажите веб-ссылку (см. Примечание 1) (URL) для использования в интерактивных картах. Текст будет отображаться в виде синей интерактивной ссылки.

Примечания

1. Либо используйте ссылку атрибута, либо встроенную ссылку в текст атрибута, но не то и другое вместе.
2. На изображениях PNG будет отображаться только одна интерактивная ссылка для каждого сегмента текста (текст с разрывами строки (~) составляет несколько сегментов).

Пример:

PlotData = bar: США в: 12.07.1941 выровнять: левый цвет текста: черный размер шрифта: XS текст: 7/12 [[Перл-Харбор]]

дает тот же результат, что и:

PlotData = bar: США по адресу: 12.07.1941 выровнять: левый цвет текста: черный размер шрифта: XS текст: "7/12 Pearl Harbor" ссылка: http: //www.wikipedia.org/wiki/Pearl_Harbour

Маркер атрибут

отметка

Помещает маркер на полосу в указанное положение. Укажите как отметку: (символ, цвет). Единственное значение для символ поддерживается на сегодняшний день линия. В цвет Указанный идентификатор должен быть определен первым с помощью команды Цвета. Если не указано иное, предполагается черный цвет.

Пример:

PlotData = bar: тестовая ширина: 15 цвет: красный с: 1900 по: 2000 в: 1990 метка: (линия, белый)

будет отображаться как:

ScaleMajor

Эта команда делит временную шкалу на более мелкие периоды, либо

• Графически через тонкие вертикальные или горизонтальные линии на графике
• В текстовом виде через заглушки на оси времени ниже или слева от диаграммы
• Графически и текстуально

Примечание: ориентация линий и / или размещение заглушек зависит от ориентации TimeAxis.

цвет сетки (O)

Определяет цвет линий сетки. Если этот атрибут не указан, линии сетки рисоваться не будут.

Примечание: Указанный идентификатор цвета должен быть сначала определен командой Цвета.

единица (O)

Задает единицу, на которую увеличивается шаг сетки. Укажите день, месяц или год (по умолчанию).

Примечание: Когда Формат даты yyyy, допускается только единичный год.

приращение (O)

Задает количество единиц, на которое увеличивается шаг сетки. По умолчанию 1.

начало (O)

Указывает, где должна отображаться первая линия сетки и / или заглушка. По умолчанию - начало определенного Период.

Примеры:

ScaleMajor = цвет сетки: красный начало: 1940ScaleMajor = цвет сетки: красный единица измерения: приращение месяца: 3 начало: 01.09.1939

ScaleMinor

Эта команда определяет дальнейшее деление шкалы времени. См. Синтаксис в ScaleMajor.

Пример:

ScaleMajor = сетка: красная единица: приращение года: 1 начало: 01.01.1940ScaleMinor = сетка: синяя единица: приращение месяца: 3 начало: 01.10.1939

TextData

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

текст

Фактический текст. Смотрите также Ввод текста для правил. В текст могут быть встроены ссылки (см. Примечания 1 и 2).

позиция

Определяет верхний левый угол текстового блока в абсолютном или относительном измерения. Определить как поз: (x, y).

ссылка (O)

Укажите веб-ссылку (см. Примечание 1) (URL) для использования в интерактивных картах. Метка на оси будет отображаться в виде синей интерактивной ссылки.

цвет текста (O)

Определяет цвет текста. Указанный идентификатор цвета следует сначала определить с помощью Цвета. Если не указано иное, цвет черный.

размер шрифта (O)

Укажите размер пункта от 6 до 30 или (желательно) один из тегов XS, S (дефолт), M, L или же XL (видеть Поддержка шрифтов Больше подробностей).

вкладки (O)

Определяет положение и выравнивание символа табуляции: ^ (каретка). Укажите несколько настроек вкладок как вкладок: (Икс¹-а¹,Икс²-а²,Икс³-а³и т.д ..) где

• Икс^п это горизонтальное смещение в абсолютных измерениях от левой части текста
• а^п выравнивание текстового сегмента (укажите центр, оставили или же верно)

lineheight (O)

Определяет интервал между последовательными линиями в абсолютных измерениях. Укажите значение до 40 пикселей или 0,4 дюйма. Если не указано иное, высота строки по умолчанию будет основана на размере шрифта, который используется в данный момент.

Примечания:

1. Либо используйте атрибут связь, или встроенная ссылка в атрибуте текст, не оба.
2. На изображениях PNG будет отображаться только одна интерактивная ссылка для каждого сегмента текста (текст с табуляцией (^) составляет несколько сегментов).

Пример:

TextData = pos: (20,67) цвет текста: черный размер шрифта: S вкладки: (10 справа, 14 слева, 50 слева, 90 слева, 230 слева) текст:^1^1940^27/9^Знак Германии, Италии и Японии [[Трехсторонний пакт]]  текст:^10^1944^1-22/7^44 страны Бреттон-Вудса устанавливают текст:^^^^^МВФ и Всемирный банк

будет отображаться как:

TimeAxis

Определяет ориентацию оси времени и текстовое представление заглушек вдоль этой оси.

формат (O)

Укажите, в каком формате даты должны отображаться по оси времени.

В настоящее время поддерживается только формат yyyy (по умолчанию). Могут последовать и другие форматы.

ориентация (O)

Укажите горизонтальный (по умолчанию) или вертикальный (горизонтальный).

заказ (O)

уточнить обеспечить регресс как возможность изменить ход времени

Пример:

TimeAxis = ориентация: горизонтальный формат: гггг

Пресеты

Пресеты - это сокращение для часто используемых настроек. Они сохраняют несколько строк кода и способствуют стандартизации, но могут сбивать с толку, поскольку сценарий шкалы времени становится менее самодокументированным.

На данный момент доступны два пресета:

• Предустановка = TimeVertical_OneBar_UnitYear, который расширяется до

PlotArea = left: 45 right: 10 top: 10 bottom: 10TimeAxis = ориентация: вертикальный формат: yyyyDateFormat = yyyy; AlignBars = earlyScaleMajor = unit: yearScaleMinor = unit: yearPlotData = mark: (line, white) align: left fontsize: S width : 20 смена: (20,0)

• Предустановка = TimeHorizontal_AutoPlaceBars_UnitYear, который расширяется до

ImageSize = height: auto barincrement: 20PlotArea = left: 25 right: 25 top: 15 bottom: 30TimeAxis = ориентация: горизонтальный формат: yyyyColors = id: значение холста: серый (0,7) id: значение grid1: серый (0,4) id: grid2 значение: серый (0.2) BackgroundColors = canvas: canvasDateFormat = yyyy; AlignBars = justifyScaleMajor = unit: year grid: grid1ScaleMinor = unit: yearLegend = ориентация: вертикальное левое: 35 сверху: 130PlotData = align: left anchor: from fontsize: M width: 15 смещение: (4, -6) цвет текста: черный

Правила ввода

Весы по размеру и положению

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

Пример:

PlotArea = ширина: 800 высота: 600 слева: 50 низ: 50

Относительные меры может использоваться для указания размеров и позиций. Укажите число от 0 до 100, сразу за которым следует знак% (процент). Для горизонтальных измерений процент соотносится с шириной изображения, для вертикальных измерений - с высотой изображения.

Первая координата горизонтальна слева направо, вторая - вертикально вверх.

Пример:

PlotArea = width: 80% height: 80% left: 10% bottom: 5%

Ввод текста

Ввод текста подчиняется нескольким правилам:

1). Только подмножество Unicode разрешен для рендеринга шрифтов, но Unicode в ссылках должен работать для всех символов. Смотрите также Поддержка шрифтов.

2). Если текст должен содержать пробелы, укажите их с помощью подчеркивания или поместите текст в двойные кавычки.

Исключение: когда текстовый атрибут является последним атрибутом в строке, допускаются пробелы (не возникнет путаницы, когда текст останавливается и начинается следующий атрибут, то есть, если быть точным, когда в тексте нет двоеточий).

Пример: (все перечисленные ниже эквиваленты)

BarData = текст: Japanese_mandate_since_1914 bar: MarshallsBarData = text: «Японский мандат с 1914 г.» bar: MarshallsBarData = bar: текст Маршалла: японский мандат с 1914 г.

3). В строках данных после команды TextData один символ имеет особое значение:

^ (каретка) означает вкладка

Пример отображения вкладок:

TextData = tabs: (4-справа, 12-справа, 14-слева, 34-слева) текст:^1^1940^27/9^Берлин Гер, Оно, Япончик подписывают текст Трехстороннего пакта:^10^1944^1-22/7^44 страны Бреттон-Вудса устанавливают текст:^^^^^МВФ и Всемирный банк# будет отображаться как:## 1 27/9 Berlin Ger, It, Jap подписывают Тройственный пакт# 10 1-22 / 7 Бреттон-Вудс Учреждение 44 стран# МВФ и Всемирный банк

Интерактивные карты

Оба формата вывода, доступные в MediaWiki, то есть PNG и SVG, могут содержать интерактивные ссылки. Тексты, показанные синим цветом, и полосы затем можно щелкнуть для перехода на другую веб-страницу.

Ссылки можно указывать с помощью команд BarData, PlotData и TextData, либо с атрибутом связь, или как встроенные ссылки через атрибут текст.

Вы можете указать одну ссылку на каждый текстовый сегмент.

Встроенные ссылки

Встроенные ссылки - это ссылки, которые являются (частью) отображаемым текстом, указанным с помощью атрибута текст. Их аналог - явные ссылки (только URL), которые определены с атрибутом связь.

Оба типа ссылок можно указать с помощью команд BarData, PlotData и TextData и используются для интерактивные карты.

Во встроенных ссылках стиль внутренней ссылки такой же, как обычно, стиль межвики-ссылки не работает, стиль внешней ссылки, как обычно, с одиночными скобками, но здесь с вертикальной чертой вместо пробела.

Примеры:

  text: example [[Help: Link]] внутренняя ссылка

будет отображаться как:

  текст: [[Справка: Ссылка | Ссылка]]

будет отображаться как:

  текст: [http://en.wikipedia.org/wiki/Rembrandt|Рембрандт ван Рейн] рисует «Ночной дозор»

будет отображаться как:

Попытка использовать стиль интервики-ссылки:

  текст: [[Main_Page]]

и аналогично с nl: и m: give:

Третий в Мета-Википедии работает нормально, кроме самой Меты, остальные ссылки работают как Главная страница (внутренняя страница, префикс игнорируется) или, например, //en.wikipedia.org/w/Main_Page (дает "Файл не найден"), в зависимости от URL-адреса ссылающейся страницы (например, отличается для страницы предварительного просмотра и страницы сравнения).

Специальные символы:

Пробелы и подчеркивания в URL-адресе должны быть записаны как% 20.

Символ тильды (~) обычно интерпретируется как разрыв строки. Если тильда является частью URL-адреса, пишите ее как две тильды.
Например, ссылка на www.site.com/~mysite в качестве:

  текст: [www.site.com/~~mysite| Мой сайт]

Знак числа (#) обычно интерпретируется как начало комментария. Когда числовой знак является частью URL-адреса, убедитесь, что текст заключен в двойные кавычки, как показано ниже:

  текст: "Подробнее на [www.site.com/~~mysite#section2| Мой сайт]"

На самом деле было бы неплохо всегда помещать текст в двойные кавычки.

Поддержка шрифтов

Timeline имеет несколько ограниченную поддержку Unicode. Он использует шрифт FreeSans.ttf, который поддерживает подмножество всех возможных глифов (например, поддерживает кириллицу, восточноевропейские диалекты и кану, но не использует кандзи). No other fonts are available at this time.

Пример:

ImageSize = width:180 height:90PlotArea  = width:180 height:90 left:0 bottom:0TimeAxis  = orientation:vertical #dummyColors    =  id:gray  value:gray(0.95)Backgroundcolors = canvas:grayPeriod   = from:1 till:2 # dummyTextData=  pos:(10,90) fontsize:L text:"维基百科"  pos:(10,70) fontsize:L text:"Zażółć gęślą jaźń"  pos:(10,50) fontsize:L text:"ウィキペディア"

will be shown as:

As a legacy of bitmap font usage, only five font tags are predefined. They will render at slightly different sizes in PNG and SVG images to produce optimal readability for both platforms.It is advised to use these tags instead of numbers whenever possible.They are: XS=eXtra Small, S=Small (default), M=Medium, L=Large, XL=eXtra large

This documentation is originally a wikified version of the original EasyTimeline documentation.

EasyTimeline code with a template parameter is not allowed

{{etl|a}} gives

Apparently EasyTimeline code with a parameter, in a template, is not allowed.

Bug fixed by Brion Vibber on 2008-12-10. Note that some editors were finding timelines are not rendering properly on Wikipedia. (Видеть http://www.mediawiki.org/wiki/Extension_talk:EasyTimeline#possible_bug) and bug: phab:T18085 было сообщено. -84user (разговаривать) 01:20, 4 November 2008 (UTC)