Help:简易时间线语法ほう

维基百科ひゃっか使用しよう手しゅ册さつ

简易时间线的特性とくせい就是从wiki文ぶん本中ほんなか产生一个嵌入式图像。这个图像可か以是一いち维的图表（水平すいへい或ある垂直すいちょく），或ある者もの是ぜ二に维的图表。名めい为“简易时间线”即そく表示ひょうじ可か以用水平すいへい或ある垂直すいちょく的てき方向ほうこう作さく为时间刻度ど，用よう另一个方向来表示其它参数，但ただし也可能かのう是ぜ其他不同ふどう的てき形式けいしき。简易时间线的语法並なみ不ふ支持しじ簡繁轉換てんかん。

参まいり见简易时间线及简易时间线索引さくいん。

简介[编辑]

只ただ要よう脚本きゃくほん介かい于两个专用よう标签之の间就可か以产生せい图像时间线：

<timeline>
腳本
</timeline>

简易时间线就会かい被ひ调用生成せいせい一いち个PNG格式かくしき图像和わ一个链接映射（可か选项）。

注意ちゅうい：即そく使つかい“简易时间线”的てき创造是ぜ为了简单方便ほうべん，但ただし是ぜ制作せいさく一个复杂的时间线表依然不是一件轻松的事情。一个简单的时间线可以花费半个小时来完成（如果有ゆう一个合适的例子用来作为基础可以节省更多时间）大型おおがた的てき时间线可能かのう要よう花はな费几个小时来创作并且修おさむ改あらため。然しか而，对于现有无论多た复杂的てき时间线进行ぎょう增加ぞうか或ある者もの更正こうせい都と是ぜ直接ちょくせつ快かい捷とし的てき，甚至是ぜ对于没ぼつ有ゆう接触せっしょく过这些语法的ほうてき使用しよう者しゃ。

若わか有ゆう问题请联络简易えき时间线的作者さくしゃ。

可か支持しじ字じ型がた[编辑]

對たいUnicode有ゆう少しょう許もと支援しえん，现在只ただ可か以使用しようFreeSans.ttf字じ型がた。此字型がた目前もくぜん還かえ不ふ支援しえん其它字じ型がた。（效果こうか如下）

建議けんぎ使用しよう預あずか定義ていぎ的てき五ご種しゅ字じ號ごう：XS=超ちょう小しょう、S=小しょう（默認もくにん）、M=中ちゅう、L=大だい、XL=超大ちょうだい。

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

可用かよう命令めいれい[编辑]

脚本きゃくほん命令めいれい定てい义：

总体布ぬの局きょく：ImageSize（图像尺寸しゃくすん）、PlotArea（图形区く）、Colors（颜色）、BackgroundColors（背景はいけい颜色）、AlignBars（條じょう塊かたまり位置いち）
日にち期き与あずか时期的てき解かい释和表ひょう达：DateFormat（日にち期き格式かくしき）、Period（时段）、ScaleMajor（主要しゅよう刻こく度ど）、ScaleMinor（次つぎ要よう刻こく度ど）、TimeAxis（时间轴）
事件じけん、时段和わ描述文ぶん本ほん：PlotData（图像数すう据すえ）、TextData（文字数もじすう据すえ）
如何いか定じょう制せい、划分、并且命名めいめい一组事件和时段：BarData（）、Legend（图例）、DrawLines（绘图线）
多た次つぎ出で现的脚本きゃくほん代だい码的简写：Define（定てい义）

下しも述じゅつ命令めいれい是ぜ必选的てき：ImageSize（图像尺寸しゃくすん）、PlotArea（图形区く）、Period（时段）和わTimeAxis（时间轴）。下した述じゅつ命令めいれい至いたり少しょう要よう选一个：PlotData（图形数すう据すえ）和かず/或ある TextData（文字数もじすう据すえ），它们都と可か以重复多次じ。所有しょゆう其它命令めいれい都と是ぜ可か选的。

大小だいしょう写うつし：命令めいれい及其属性ぞくせい都と能のう接受せつじゅ大だい写うつし、小しょう写うつし以及混合こんごう拼写。请在使用しよう时保持ほじ一致以利于维持可读性，例れい如对于命令めいれい使用しよう混合こんごう拼写，而所有しょゆう属性ぞくせい使用しよう小しょう写うつし。

一般いっぱん语法规则[编辑]

脚本きゃくほん可か包含ほうがん命令めいれい和わ注ちゅう释。每まい个命令めいれい都と有ゆう一个或多个属性。

命令めいれい[编辑]

命令めいれい应该从行首くび开始。有ゆう些命令めいれい带有多た行くだり的てき数すう据すえ和わ/或ある选项。这些另外的てき行ぎょう应该以至少しょう一个空格或完整的空行开始。（下面かめん示しめせ范相关的数すう据すえ行くだり）

根ね据すえ命令めいれい的てき类型，它可表示ひょうじ为以下か的てき多た种形式しき之の一いち：

命令めいれい = 属性ぞくせい（或ある多た个属性せい）

DateFormat = dd/mm/yyyy

命令めいれい名字みょうじ = 属性ぞくせい（或ある多た个属性せい）

Color Jp = value:red legend:Japan

命令めいれい =
  属性ぞくせい（或ある多た个属性せい）
  属性ぞくせい（或ある多た个属性せい）
  等とう等とう……

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

注ちゅう释[编辑]

可用かよう单行和わ多た行くだり注ちゅう释：

# 号ごう后きさき文字もじ就是一いち行ぎょう注ちゅう释
介かい于#>和わ<#之これ间的文字もじ也是注ちゅう释。用よう这种方式ほうしき标记，可か使用しよう多た行来いきき书写注ちゅう释。

例れい如：

Dateformat = dd/mm/yyyy # European date format
Period = from:01/09/1939 till:02/09/1945 #> 该图表ひょう将はた表おもて现二に战的
  整せい个历史し。 <#

属性ぞくせい[编辑]

当とう有ゆう许多属性ぞくせい指定してい到いた同どう一いち个命令めいれい时，它们可か以用成なり对的 '名称めいしょう:数かず值'来らい表示ひょうじ。当とう有ゆう许多数すう值指定してい到いた同どう一いち个属性せい时，它们必须放ひ入にゅう圆括号ごう中ちゅう。

例れい如：

AlignBars = justify
Color SB = value:rgb(0.8,0,0.7) legend:Sea_Battles

参まいり数すう和わ数すう据すえ项[编辑]

大だい部分ぶぶん命令めいれい只ただ接受せつじゅ在ざい同どう一いち行ぎょう指定してい的てき属性ぞくせい。

数かず据すえ块： 有ゆう一いち些命令めいれい、像ぞう是ぜBarData、PlotData、TextData、Colors认为一いち个数かず据すえ块是ぜ由よし一个或多个数かず据すえ行くだり组成。数かず据すえ行くだり应该以一个或多个空格开始，遇ぐう到いた以非空そら字じ符ふ开始的てき行ぎょう就认为数据すえ块已结束（例外れいがい：应忽略りゃく空行くうぎょう，它们可能かのう用よう来らい对同一个块中相关的数据行进行分组）。

数かず据すえ块内的てき属性ぞくせい按照概念がいねん可分かぶん成なり参さん数すう和わ数かず据すえ项。数かず据すえ块可同どう时包含ほうがん参さん数すう和わ数すう据すえ项。

数かず据すえ项：在ざい数すう据すえ行くだり属性ぞくせい中ちゅう，text、from、till和わat仅在它们所出しょしゅつ现的行ぎょう起おこり作用さよう。

参さん数すう：在ざい数すう据すえ行くだり属性ぞくせい中ちゅう，像ぞう是ぜcolor和わfontsize，根ね据すえ上下じょうげ文ぶん的てき不同ふどう会かい有ゆう不同ふどう的てき含义。如果它们出で现在没ぼつ有数ゆうすう据すえ项的行ぎょう中ちゅう，它们将はた为后面めん的てき数すう据すえ行くだり设定新しん的てき默だま认属性せい。如果它们出で现的行ぎょう中ちゅう同どう时也有数ゆうすう据すえ项，那な么它们只能のう在ざい此行起おこり作用さよう，取と代だい前面ぜんめん设定的てき默だま认属性せい。

例れい如：

# 在ざい该例子こ中将ちゅうじょう分ぶん别画出で红蓝两条系列けいれつ，
# 但ただし在ざい每まい一系列中将有一段使用绿色描绘以标示战争时期。

PlotData =
  color:red fontsize:S                               # 默だま认值
  bar:USSR from:1919 till:1922 text:Lenin            # 红条
  bar:USSR from:1922 till:1953 text:Stalin           # 红条
  bar:USSR from:1939 till:1945 text:WWII color:green # 绿条
  bar:USSR from:1953 till:1964 text:Krushchev        # 红条
   
  color:blue                                         # 改あらため变默认颜色しょく
  bar:US from:1913 till:1921 text:Wilson             # 蓝条
  bar:US from:1917 till:1918 text:WWI color:green    # 绿条
  bar:US from:1921 till:1923 text:Harding            # 蓝条

#> 此多行ぎょう注ちゅう释并不ふ终止PlotData命令めいれい，
   即そく使つかい前まえ一行并未以空格开头。<#

   bar:US from:1923 till:1929 text:Coolidge          # 蓝条

TextData =                                           # 此处PlotData命令めいれい结束
   tabs:...etc

特殊とくしゅ字じ符ふ[编辑]

#、#>、<#（井い号ごう、井い号ごう+大だい于号、小しょう于号+井い号ごう）：参まいり见Comments
~（波浪はろう线）在ざい文字もじ中ちゅう：换行
^在ざい文字もじ中ちゅう：缩进
_（下しも划线）在ざい文字もじ中ちゅう：空そら格かく
$（美よし元もと符号ふごう）用よう在任ざいにん何なん用よう户自定てい义常量りょう前まえ

命令めいれい参考さんこう[编辑]

每まい一个命令都列出了有效的属性，一些命令或属性是可选的［表示ひょうじ为（可か选）］。

一些命令的某些属性是互斥的。（应用时再解かい释）

AlignBars[编辑]

条じょう块（Bar）总是以相同どう的てき距离绘制。这个命令めいれい用よう来らい说明是ぜ否ひ条じょう块应该排列はいれつ得とく尽つき可能かのう分ぶん开，或ある者もの保留ほりゅう空白くうはく在ざい图表的てき左ひだり（或ある上うえ）边与第だい一いち条じょう之の间，还是保留ほりゅう空白くうはく在ざい图表的てき右みぎ（或ある下した）边与最さい后きさき一いち栏之间。

early（默だま认）: 第だい一条放置在图表最左（或ある最上さいじょう）的てき位置いち（'粘ねば贴'到いた轴上），在ざい最さい后きさき一条与图表的右（或ある下した）边之间留出で空白くうはく。
late: 与あずかearly相反あいはん，最さい后きさき一条尽可能地放置在图表的右（或ある下した）边，在ざい轴线（图表的てき左ひだり/上うえ边）与あずか第だい一条之间留出空白。
justify: 第だい一条和最后一条放置得尽可能分开，图表的てき两边都と不ふ留とめ空白くうはく。当とう只ただ有ゆう一いち条じょう存在そんざい时，justify就表示ひょうじ"居中きょちゅう"。

例れい如：

TimeAxis =	orientation:horizontal			orientation:vertical
Alignbars =

BackgroundColors[编辑]

这个命令めいれい允まこと许指定してい图表不同ふどう部分ぶぶん的てき背景はいけい颜色。任にん何なん颜色id的てき指定してい在ざい首くび次じ使用しよう时都应该先さき进行定てい义Colors.

canvas (可か选): 为全部ぶ图像指定してい背景はいけい颜色。
bars (可か选): 为所有しょゆうbars指定してい背景はいけい颜色。

例れい如：

BackgroundColors = bars:darkgrey

BackgroundColors = canvas:lightgrey bars:darkgrey

BackgroundColors = canvas:lightgrey

BarData[编辑]

这是一いち个可选命令めいれい，它可以调整せい哪些条じょう块将被ひ显示、以何种顺序じょ显示。如果它被省略しょうりゃく，栏将按照它在PlotData命令めいれい中ちゅう的てき出で现的顺序进行绘制。

对于使用しよう许多条じょう的てき复合时间线，推荐使用しよう这个命令めいれい：

这将简化对显示しめせ数すう据すえ的てき重おも新しん布置ふち；
PlotData中ちゅう指定してい的てき条じょう块名字みょうじ将はた和わ此列表ひょう比ひ对，从而减少输入错误的てき可能かのう。

bar: 定てい义了条じょう块的识别号ごう，其他的てき命令めいれい（特とく别是PlotData）将しょう使用しよう该识别作为对其之引用いんよう。它也是ぜ坐すわ标轴上じょう显示的てき标签，除じょ非ひ设置了りょうtext属性ぞくせい。bar识别号ごう不可ふか包含ほうがん空そら格かく：使用しよう下か划线代替だいたい，它们将はた被ひ自じ动转换为空そら格かく。
text (可か选): 指定してい显示于坐标轴上じょう的てき标签，以取代だい条じょう块识别号。参まいり见text input。该文本ほん可か以包含ほうがん一いち个内部ぶ链接（参まいり见注ちゅう释1）。
link (可か选): 指定してい一いち个链接せっ（URL）。参まいり见注ちゅう释1。坐すわ标轴上じょう的てき标签即そく显示为一个超链接。

注ちゅう释

要よう么使用しようlink属性ぞくせい、要よう么在text属性ぞくせい中ちゅう使用しよう内部ないぶ链接，二に者しゃ不能ふのう并用。

示しめせ例れい

BarData =
  bar:Japan
  bar:US       text:"美国びくに"          # 将はたPlotData数すう据すえ定位ていい到いた条じょう块“US”但ただし显示为“美国びくに”
  bar:China    text:[[中国ちゅうごく]]        # “中国ちゅうごく”标签将しょう指向しこう维基百科ひゃっか中ちゅう的てき中国ちゅうごく条目じょうもく

以下いか代だい码产生せい同どう样的输出（只ただ列れつ出でPlotData的てき改あらため变）：

bar:US        text:[[United_States]]

bar:US        text:"United States"     link:http://www.wikipedia.org/wiki/United_States

bar:United_States                      link:http://www.wikipedia.org/wiki/United_States

Colors[编辑]

这个命令めいれい可用かよう来き定てい义颜色しょく并用一いち个id（身み份识别）来らい表示ひょうじ。其它命令めいれい将しょう用よう在ざい这里指定してい的てきid来らい调用颜色。这个命令めいれい可か指定してい一个或多个的颜色定义，每ごと一个都必须位于独立的缩进行。

id: 其它命令めいれい将はた使用しよう这个id来らい指定してい文ぶん本ほん、栏或背景はいけい的てき颜色。
value: 实际颜色定てい义。颜色值可用よう下か述じゅつ任にん一いち种方式しき表示ひょうじ：

预定义颜色しょく值,有ゆう32种预定てい义的颜色名称めいしょう是ぜ公こう认的（参まいり见Ploticus color page，在ざい这里定てい义了这些颜色值）。 rgb (红,绿,蓝): 指定してい3个介于0（最小さいしょう）和わ1（最大さいだい）之の间的数字すうじ hsv (色いろ调,饱和度ど,值): 指定してい3个介于0和わ1之これ间的数字すうじ gray (值): 指定してい一いち个介于0 (黑くろ) 和わ 1 (白しろ)

legend (可か选): 指定してい图例中ちゅう对于使用しよう该种颜色的てき项目的もくてき文字もじ说明，如果该属性せい被ひ忽ゆるがせ略りゃく，图例中ちゅう则不显示任にん何なん文ぶん本ほん。参まいり见Text Input以获得とく详细规则。

Example:

Colors =
  id:war       value:red   legend:War Period
  id:peace     value:blue  legend:Peace Time
  id:treaty    value:rgb(0.6,0,0.6)
  id:lightgrey value:gray(0.9)
  id:darkgrey  value:gray(0.1)

DateFormat[编辑]

这个命令めいれい定てい义了在ざい其它命令めいれい中出なかいで现的日び期き应该如何いか解かい释。

有效ゆうこう的てき日び期き格式かくしき：

dd/mm/yyyy: 日にち期き解かい释为日び/月つき/年とし; 注意ちゅうい: 这种格式かくしき只ただ允まこと许用于01/01/1800以后的てき日び期き
mm/dd/yyyy: 日にち期き解かい释为月がつ/日にち/年とし; 注意ちゅうい: 这种格式かくしき只ただ允まこと许用于01/01/1800以后的てき日び期き
yyyy: 这种格式かくしき使用しよう从 -9999 到いた +9999的てき整数せいすう

例れい如：

DateFormat = mm/dd/yyy

Define[编辑]

这一个命令允许定义本文常数，例れい如，为在多た个时间段出で现的部分ぶぶん脚本きゃくほん代だい码定义速记。本文ほんぶん常数じょうすう应该总是以一个$（美よし元もと符号ふごう）开始。

例れい如：

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

DrawLines[编辑]

Some timelines extend over several clearly distinct periods. A line demarcating these periods may serve as a visual aid.

Lines specified here will be drawn over the whole width/length of the chart (depending on the orientation defined by TimeAxis).

at: Specify the date/year where the line should be drawn, in compliance with the specified DateFormat.
color: Specify the color in which the line should drawn.; Note: The color id specified should be defined first with command Colors.

Example:

LineData=
  at:start      color:red
  at:end        color:red
  at:07/12/1941 color:red

ImageSize (必选)[编辑]

This command defines the overall size of the final image. Specify values in absolute measurements.

width: Width of final image: maximum is 1600 pixels
height: Height of final image: maximum is 1200 pixels

Example:

ImageSize = width:800 height:600

Legend[编辑]

A legend will only be shown when this command is present. There are several ways to define the appearance and position of the legend. Some attributes are mutually exclusive (see below).

orientation (O): Specify hor[izontal] or ver[tical] (default).; Restriction: orientation = 'horizontal' and position = 'right' are mutually exclusive
position (O): Defines placement of the legend relative to the chart area. Specify top, bottom (default) or right.; Restriction: orientation = 'horizontal' and position = 'right' are mutually exclusive
columns (O): Specify 1, 2, 3 or 4. When this attribute is omitted the number of columns is determined as follows:

Orientation horizontal : Attribute columns does not apply here. All entries will be on the same line.
Orientation vertical :
- Position right : All entries will be in one column
- Position top or bottom : The number of columns depends on the number of entries to be shown:
  1-5 entries: 1 column, 6-10 entries: 2 columns, 11 or more entries: 3 columns.

Tip: you may consider omitting the following parameters at first, and only add them when defaults settings are not satisfactory.

columnwidth (O): Defines the distance between columns. You can specify an absolute distance or a relative distance (as percentage of the page width).; Restriction: this parameter is ignored when columns = 1 is defined or implied.
left (O): Defines the distance between the left side of the legend and the left side of the page. You can specify an absolute distance or a relative distance (as percentage of the page width).
top (O): Defines the distance between the top of the legend and the bottom of the page. You can specify an absolute distance or a relative distance (as percentage of the page height).

Examples:

Legend = orientation:vertical position:bottom columns:3 columnwidth:140

Legend = orientation:horizontal position:bottom

Legend = left:100 top:120 columns:3

Period (必选)[编辑]

Defines the time period that will be displayed in the chart. Both parameters are mandatory. Specify dates in compliance with specified DateFormat.

from: Timeline starts here. The specified value can be referenced as start in commands like PlotData and TextData.
till: Time ends here. The specified value can be referenced as end in other commands.

Example:

Period = from:01/09/1939 till:02/09/1945

PlotArea (必选)[编辑]

width: 以绝对或相しょう对测量来らい指定してい数すう值。
height: 以绝对或相しょう对测量りょう来らい指定してい数すう值。
left: 图像左ひだり边和图形区く左ひだり边的空白くうはく余あまり量りょう。以绝对或相しょう对测量りょう来らい指定してい数すう值。
bottom: 图像底そこ边和图形区く底そこ边的空白くうはく余あまり量りょう。以绝对或相しょう对测量りょう来らい指定してい数すう值。

例れい如：

PlotArea = width:640 height:420 left:160 bottom:120

PlotArea = width:80% height:70% left:20% bottom:20%

PlotData[编辑]

用よう于定义栏 (用よう符号ふごう表示ひょうじ时间周期しゅうき), 并且在ざい栏后的てき特定とくてい位置いち上じょう加入かにゅう文字もじ。

For texts which are not related to a certain period or date/year or which require extensive formatting use command TextData.

Attributes text, at, from and till always apply only to the line on which they occur. All other attributes, when not combined with one these four, act as default for the remainder of the command block or until a new default is specified, and may be overruled for a single line. See Parameters vs Data Items for more info and an example.

图形区く有ゆう许多的てき属性ぞくせい，其中有ちゅうう些时互斥的てき。这些属性ぞくせい可か被ひ分ぶん为以下か几种：

位置いち属性ぞくせい
栏相关属性せい
文字もじ属性ぞくせい
标记属性ぞくせい

位置いち属性ぞくせい[编辑]

at

Specifies at which date/year a text should be positioned. Depending on attribute align the text either starts, ends or is centered at this position. Use date/year format as specified in DateFormat or specify start or end which refers to time frame defined by command Period.

NB: This attribute can not be combined with attributes from or till.

from

Specifies at which date/year a bar should start. Use date/year format as specified in DateFormat or specify start which refers to time frame defined by command Period.

NB: This attribute should be used in combination with attribute till and can not be combined with attribute at.

till

Specifies at which date/year a bar should end. Use date/year format as specified in DateFormat or specify end which refers to time frame defined by command Period.

NB: This attribute should be used in combination with attribute from and can not be combined with attribute at.

shift

Specifies a horizontal and vertical displacement in absolute measurements for a text. This allows:

Texts to be shifted to avoid overlaps
Placement of text beside a bar, instead of on top of it.

Examples:

PlotData=
  bar:Japan from:start      till:19/02/1945 color:JT
  bar:Japan from:19/02/1945 till:14/03/1945 color:AI
  bar:Japan from:02/09/1945 till:end        color:AO

  at:07/12/1941 shift:(0,-15) text:"<-- WW2 reaches Asia"

栏相关属性せい[编辑]

bar: Specifies to which bar all other attributes apply.; When command BarData has not been used, bars will be drawn in the order in which they occur in any PlotData data block. The id specified here will also be the text presented along the axis, next to the bar.; When command BarData has been used, bars will presented in the order specified there, also the bar id specified here will be validated against that list. Also the text presented along the axis will depend on the definition in BarData.
color: 指定してい栏应该被绘制的てき颜色。; The color id specified should be defined first with command Colors.
width: Specifies the width of the bar in absolute or relative measurements.

例れい如：

BarData=
  id:US text:United States
  id:SB text:Sea Battles

Colors=
  id:US value:blue legend:United_States
  id:SB value:rgb(0.8,0,0.7) legend:Sea_Battles

PlotData=
  width=0.3                                                            # see note 1
  bar:SB     from:07/08/1942 till:09/02/1943 text:Guadalcanal color:SB # see note 2
  bar:US     from:start      till:end color:US                         # see note 3
  bar:Midway from:start      till:end color:US                         # see note 4
  bar:US     at:07/12/1941   text:7/12 Pearl Harbour                   # see note 5

Notes:

this line establishes a default bar width for the remainder of the data block
this line specifies a bar to be drawn and a text to placed on it at the same time
bar US will be drawn before bar SB, even when specified after it, because command BarData determines the sequence
bar Midway will be rejected because it is not declared with command BarData
the last line will not result in a bar being plotted, it merely specifies on which bar the text should be placed

文字もじ属性ぞくせい[编辑]

text: Defines a text that should be plotted on or near a bar. The anchor position can be defined either explicitly with attribute at, or implicitly with attributes from and till. In the latter case the text will be positioned in the middle of the defined bar segment. See also Text Input for rules; The text may include embedded links (see Notes 1 & 2) for use in clickable maps.
textcolor (O): Defines the color of the text. The color id specified should be defined first with command Colors. When not specified color black will be assumed.
fontsize (O): Specify a point size between 6 and 30, or (preferably) one of tags XS, S (default), M, L or XL. See Font Support for more details.
align (O): Specify center (default), left or right.
link (O): Specify a web link (see Note 1) (URL) for use in clickable maps. The text will be shown as a blue clickable link.

Notes

Either use attribute link, or an embedded link in attribute text, not both.
On PNG images only one clickable link will be shown per text segment (text with line breaks (~) constitutes several segments).

Example:

PlotData=
   bar:US at:07/12/1941 align:left textcolor:black fontsize:XS text:7/12 [[Pearl Harbour]]

produces the same result as:

PlotData=
   bar:US at:07/12/1941 align:left textcolor:black fontsize:XS text:"7/12 Pearl Harbour" link:http://www.wikipedia.org/wiki/Pearl_Harbour

标记属性ぞくせい[编辑]

mark: Places a marker in a bar at the specified position. Specify as mark:(symbol, color). The only value for symbol supported to date is line. The color id specified should be defined first with command Colors. When not specified color black will be assumed.

Example:

PlotData=
  bar:test width:15 color:red
  from:1900 till:2000
  at:1990 mark:(line,white)

will be shown as:

ScaleMajor[编辑]

This command divides the timeline into smaller periods, either

Graphically, through thin vertical or horizontal lines in the chart
Textually, through stubs in the time axis, below or to the left of the chart
Both graphically and textually

Note: the orientation of the lines and/or placement of the stubs depends on the orientation of the TimeAxis.

gridcolor (O): Defines the color for the grid lines. When this attribute is omitted no grid lines will be drawn.; Note: The color id specified should be defined first with command Colors.
unit (O): Specifies the unit by which the grid spacing is incremented. Specify day, month or year (default).; Note: When DateFormat yyyy is specified, only unit year is allowed.
increment (O): Specifies the numbers of units by which the grid spacing is incremented. Default is 1.
start (O): Specifies where the first grid line and/or stub should be displayed. Defaults to start of defined Period.

Examples:

ScaleMajor = gridcolor:red start:1940

ScaleMajor = gridcolor:red unit:month increment:3 start:01/09/1939

ScaleMinor[编辑]

This command defines a further subdivision of the timescale. See ScaleMajor for syntax .

Example:

ScaleMajor = grid:red  unit:year  increment:1 start:01/01/1940
ScaleMinor = grid:blue unit:month increment:3 start:01/10/1939

TextData[编辑]

Used to define a text block that can be positioned anywhere on the chart.

text

The actual text. See also Text Input for rules. The text may include embedded links (see Notes 1 & 2).

pos

Defines the top-left corner of the text block in absolute or relative measurements. Define as pos:(x,y).

link (O)

Specify a web link (see Note 1) (URL) for use in clickable maps. The label along the axis will be shown as a blue clickable link.

textcolor (O)

Defines the color of the text. The color id specified should be defined first using Colors. When not specified, the color is black.

fontsize (O)

Specify a point size between 6 and 30, or (preferably) one of tags XS, S (default), M, L or XL (see Font Support for more details).

tabs (O)

Defines position and alignment for tab character: ^ (caret). Specify multiple tab settings as tabs: (x¹-a¹,x²-a²,x³-a³, etc..) where

xⁿ is the horizontal displacement in absolute measurements from the left side of the text
aⁿ is the alignment for the text segment (specify center, left or right)

lineheight (O): Defines spacing between consecutive lines in absolute measurements. Specify a value up to 40 pixels or 0.4in. When not specified a default lineheight will be based on the font size currently in use.

Notes:

Either use attribute link, or an embedded link in attribute text, not both.
On PNG images only one clickable link will be shown per text segment (text with tabs (^) constitutes several segments).

Example:

TextData =
  pos:(20,67) textcolor:black fontsize:S
  tabs:(10-right,14-left,50-left,90-left,230-left)
  text:^1^1940^27/9^Germany,Italy and Japan sign [[Tripartite Pact]]
  text:^10^1944^1-22/7^Bretton Woods 44 nations establish
  text:^^^^^IMF and World Bank

will be shown as:

TimeAxis[编辑]

Defines the orientation of the time axis, and textual representation of stubs along that axis.

format (O): Specify in which format dates should be presented along the time axis.; Currently only format yyyy (default) is supported. More formats may follow.
orientation (O): Specify hor[izontal] (default) or ver[tical].

Example:

TimeAxis = orientation:horizontal format:yyyy

Presets[编辑]

At the moment two presets are available:

Preset = TimeVertical_OneBar_UnitYear
Preset = TimeHorizontal_AutoPlaceBars_UnitYear

Not clear if whether there is documentation about them.

输入规则[编辑]

尺寸しゃくすん和わ位置いち比例ひれい[编辑]

Absolute measures may be used for specifying sizes, positions and position shifts, measured in pixels.

Example:

PlotArea = width:800 height:600 left:50 bottom:50

Relative measures may be used for specifying sizes and positions. Specify a number between 0 and 100, immediately followed by a % (percentage) sign. For horizontal measurements the percentage is related to image width, for vertical measurements to image height.

The first coordinate is horizontal from left to right, the second is vertically upward.

Example:

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

文字もじ输入[编辑]

Text input is subject to a few rules:

1 No unicode is allowed yet. See also font support.

2 When text should contain spaces, either specify these by using underscores or place the text between double quotes.

Exception: when the text attribute is the last attribute on a line, spaces are allowed (no confusion will arise where the text stops and the next attribute starts, that is—to be precise—when no colons occur in the text).

Example: (the following are all equivalent)

BarData =
  text:Japanese_mandate_since_1914 bar:Marshalls

BarData =
  text:"Japanese mandate since 1914" bar:Marshalls

BarData =
  bar:Marshalls text:Japanese mandate since 1914

3 In data lines following command TextData two characters have special meaning:

~ (tilde) means line break

^ (caret) means tab

Example showing line breaks:

TextData =
  .. text:Generated for Wikipedia~Version 1.1 - 2 Januari 2004

# will be shown as:
#
#  Generated for Wikipedia
#  Version 1.1 - 2 Januari 2004

Example showing tabs:

TextData =
  tabs:(4-right,12-right,14-left,34-left)
  text:^1^1940^27/9^Berlin Ger,It,Jap sign Tripartite Pact
  text:^10^1944^1-22/7^Bretton Woods 44 nations establish
  text:^^^^^IMF and World Bank

# will be shown as:
#
#      1    27/9 Berlin Ger,It,Jap sign Tripartite Pact
#     10  1-22/7 Bretton Woods 44 nations establish
#                                    IMF and World Bank

可か点てん击的图[编辑]

Both output formats available in MediaWiki, i.e. PNG and SVG, can contain clickable links. Texts shown in blue, and bars, may then be clicked, to surf to another web page.

Links can be specified with commands BarData, PlotData and TextData, either with attribute link, or as embedded links, via attribute text.

嵌入かんにゅう式しき链接[编辑]

Embedded links are links that are (part of a) displayable text, specified with attribute text. Their counterpart are explicit links (URL only) which are defined with attribute link.

Both type of links can be specified with commands BarData, PlotData and TextData and are used for clickable maps.

In embedded links, internal link style is as usual, interwiki link style does not work, external link style is as usual with single brackets, but here with a pipe instead of a space. Blank spaces and underscores in the url should be written as %20.

Examples:

  text:example [[Help:Link]] internal link

will be shown as:

  text:[[Help:Link|Link]]

will be shown as:

  text:[http://en.wikipedia.org/wiki/Rembrandt|Rembrandt van Rijn] paints Night Watch

will be shown as:

Attempt to use interwiki link style:

  text:[[en:Main_Page]]

and similar with nl: and m: give:

The third one to Meta-Wikipedia works properly, except from Meta itself, the other links work like Main_Page (internal page, the prefix is ignored) or e.g. //zh.wikipedia.org/w/Main_Page (gives File not found), depending on the URL of the referring page (e.g. different for a preview page and a diff page).

EasyTimeline code with a template parameter is not allowed[编辑]