Template:Horizontal timeline/doc

これはTemplate:Horizontal timelineの解説サブページです。
使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。

Luaモジュールを使用しています:

Module:Horizontal timeline

Template:Horizontal timeline は横位置の年表を作成するテンプレートです。

→「Wikipedia:井戸端/subj/EasyTimeLine機能は使えなくなったのか？」も参照

パラメータ

区画の基本設定

|border=は区画の枠線。例＝2px solid #CFD2AA
|bgCol=は区画の背景色
|width=は年表の区画の幅を指定。既定は100%で、単位は px も em も可
|caption=を使うと文字列は中央寄せ。本来は軸のラベル（項目名）用で、凡例の表示にも使える。
|from= と |to= は年表に必須のパラメータ。時間の始点と終点を指定。年表全体（プロット全部のまとまり）に種の違う行を含めるときは、このスケールに合わせる。|to= は |from= と同値またはそれ以下であること（詳細は|inc= 参照。）もし以下に示したパラメータで指定した棒グラフがこれらの値を超過する場合、配置の位置にしたがい自動処理で「切り詰め」または「除去」（trimmed or eliminated。）
|inc=は|from=に加算する値を指定するオプションで、軸に沿って|to=にいたる増分に相当。指定しないと自動的に算出。|to= が |from= より大きい場合、|inc= は正の値であり、逆もまた真であること。例外だと出力結果は想定不可能。

列_n のパラメータ

|row_n= を使い、行を水平に引く指定をします。行数の上限はありません。添字は正の整数とし、区画内のどこに行を配置するか指定します。下付き文字は区画内の上寄りに表示します。つまり |row3= は |row4= よりも上に表示されます。

使える行は3種類あります。

axis：座標軸を配置する「位置」を指定。
timeline：年表の棒グラフを配置する位置と方法を指定。
note：引き出し線を添えて注書きを設ける行。グラフに説明をつけます。

共通のパラメータ

|height=はtimeline 行と note 行の高さを指定。

これらの種別の行にはハイフンに続けて個別に属性を指定できます。一例として row_n の指定は |row_n-style= と記述されます。使用できる属性の一覧は下記をご参照ください。

列のスケール

|axis-negativeFmt=、|axis-positiveFmt=、 |axis-zeroFmt=は軸のスケールを指定するオプション。さらにカスタマイズする場合（軸の単体の文字列を常に非表示にするなど）は以下を参照。
- |axis-value= - 軸上の値の文字列をこの値に置換（表示する値と同値の場合のみ作動。）
- |axis-marker-value= - 軸の文字列を指すマーカポイントを変更（表示する値と同値の場合のみ作動。）
|axis-nudge= - 軸と文字列との余白、既定値は-1.8em。

|axis-marker-1878= |axis-1878=

使用例

**`|axis-nudge=`を指定しない例**
マークアップ	描画
{{Horizontal timeline \|from=-2000 \|to=2000 \|inc=500 \|row1=scale }}	scale

**`|axis-nudge=` を指定、ラベルに書式あり**
マークアップ	描画
{{Horizontal timeline \|from=-2000 \|to=2000 \|inc=500 \|row1=scale \|axis-negativeFmt=%s BC \|axis-positiveFmt=%s AD \|axis-zeroFmt= %s AD \|axis-nudge=-0.8em }}	scale

**軸に `|axis-value=`、`|axis-marker-value=` を設定**
マークアップ	描画
{{Horizontal timeline \|from=-2000 \|to=2000 \|inc=500 \|row1=scale \|axis-nudge=-0.8em \|axis--2000= マイナスの2千 \|axis-marker-0=⇑ \|axis-0= 軸のマーカを<br/>変更した }}	scale

年表の行

|row_n-bordertop= と |row_n-borderbottom= はn番目の行の上下の枠線を指定。
|row_n-texttop= はn番目の行全体を対象に、棒グラフのラベルの上下の余白（nudge）を指定。
|row_n-colour= または |row_n-color= は行の背景色を指定。

注記: colour、color はどちらもモジュール全体を対象に利用が認められています。

|row_n-i-from= は棒グラフの始点を指定。オプションであり、指定しない場合は |from=の指定値を使います。
|row_n-i-to= は棒グラフの終点を指定。
|row_n-i-text= は棒グラフのラベル文字列を指定。
|row_n-i-fontsize= はラベルのフォントとサイズを指定。
|row_n-i-texttop= i番目（訳注：英語の^th）の棒において、ラベルの上下余白を指定。
|row_n-i-colour= は棒の色を指定。
|row_n-i-border= は棒の枠線を指定（既知の問題をご参照ください。）

サブスクリプトの注記:

|row_n-i-<attribute>= はn番目の行のi番目の棒のattributeに値を指定。
ここではサブスクリプトの添字nは正の整数を取り、行とその引数をグループ化します。スクリプトで連続的に発生しない場合がありますが、昇順に表示されます。
スクリプトの添字 i もやはり正の整数で、特定の行の棒をグループ化します。

年表の行の書式パラメータ

|row_n-style= と |row_n-i-style= を使い、行または棒を指定して書式を付与します。もしすべての行や棒に同じ書式を当てるなら書式としてグループ化し、グローバルに適用する選択肢があります。書式の接頭辞はrow以外であれば自由に指定できます。すべての行に共通の書式を当てる|styleDefault= の使い方の実例は下記にあり、また特定の棒に固有の書式を設定するには |stylePopes=/|styleAntiPopes=が使えます。

使用例

Markup


{{Horizontal timeline

|from=1003
|to=1281
|inc=12
|axis-nudge=-0.5em

|styleDefault-height=1.5em
|styleDefault-1-border=none;
|styleDefault-3-border=none;text-align:left
|styleDefault-3-texttop=0em;left:0.5em;
|styleDefault-5-border=none;text-align:left
|styleDefault-5-texttop=0em;left:0.5em;

|stylePopes-boxcolour=#F7C000
|stylePopes-border=none;border:2px solid #D0A200

|styleAntiPopes-boxcolour=#DD4444
|styleAntiPopes-border=none;border:2px solid #E20000

|row1=timeline
|row1-style=styleDefault
|row1-1-to=1003
|row1-2-to=1003.9
|row1-2-style=stylePopes
|row1-3-text=[[Pope John XVII|John XVII]] (1003)

|row1-3-to=1124
|row1-4-to=1130
|row1-4-style=stylePopes
|row1-5-text=[[Pope Honorius II|Honorius II]] (1124–1130)

|row2=timeline
|row2-style=styleDefault
|row2-1-to=1004
|row2-2-to=1009
|row2-2-style=stylePopes
|row2-3-text=[[Pope John XVIII|John XVIII]] (1004–1009)

|row2-3-to=1124
|row2-4-to=1124.9
|row2-4-style=styleAntiPopes
|row2-5-text=[[Antipope Celestine II|Celestine II]] (1124), antipope

|row3=timeline
|row3-style=styleDefault
|row3-1-to=1009
|row3-2-to=1012
|row3-2-style=stylePopes
|row3-3-text=[[Pope Sergius IV|Sergius IV]] (1009–1012)

|row3-3-to=1130
|row3-4-to=1143
|row3-4-style=stylePopes
|row3-5-text=[[Pope Innocent II|Innocent II]] (1130–1143)

|row4=timeline
|row4-style=styleDefault
|row4-1-to=1012
|row4-2-to=1024
|row4-2-style=stylePopes
|row4-3-text=[[Pope Benedict VIII|Benedict VIII]] (1012–1024)

|row4-3-to=1130
|row4-4-to=1138
|row4-4-style=styleAntiPopes
|row4-5-text=[[Antipope Anacletus II|Anacletus II]] (1130–1138), antipope

|row5=timeline
|row5-style=styleDefault
|row5-1-to=1012
|row5-2-to=1012.9
|row5-2-style=styleAntiPopes
|row5-3-text=[[Antipope Gregory VI|Gregory VI]] (1012), antipope

|row5-3-to=1138
|row5-4-to=1138.9
|row5-4-style=styleAntiPopes
|row5-5-text=[[Antipope Victor IV (1138)|Victor IV]] (1138), antipope

|row6=timeline
|row6-style=styleDefault
|row6-1-to=1024
|row6-2-to=1032
|row6-2-style=stylePopes
|row6-3-text=[[Pope John XIX|John XIX]] (1024–1032)

|row6-3-to=1143
|row6-4-to=1144
|row6-4-style=stylePopes
|row6-5-text=[[Pope Celestine II|Celestine II]] (1143–1144)

|row7=timeline
|row7-style=styleDefault
|row7-1-to=1032
|row7-2-to=1044
|row7-2-style=stylePopes
|row7-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row7-3-to=1144
|row7-4-to=1145
|row7-4-style=stylePopes
|row7-5-text=[[Pope Lucius II|Lucius II]] (1144–1145)

|row8=timeline
|row8-style=styleDefault
|row8-1-to=1045
|row8-2-to=1045.9
|row8-2-style=styleAntiPopes
|row8-3-text=[[Pope Silvester III|Silvester III]] (1045)

|row8-3-to=1145
|row8-4-to=1153
|row8-4-style=stylePopes
|row8-5-text=[[Pope Eugene III|Eugene III]] (1145–1153)

|row9=timeline
|row9-style=styleDefault
|row9-1-to=1045
|row9-2-to=1045.9
|row9-2-style=stylePopes
|row9-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row9-3-to=1153
|row9-4-to=1154
|row9-4-style=stylePopes
|row9-5-text=[[Pope Anastasius IV|Anastasius IV]] (1153–1154)

|row10=timeline
|row10-style=styleDefault
|row10-1-to=1045
|row10-2-to=1046
|row10-2-style=stylePopes
|row10-3-text=[[Pope Gregory VI|Gregory VI]] (1045–1046)

|row10-3-to=1154
|row10-4-to=1159
|row10-4-style=stylePopes
|row10-5-text=[[Pope Hadrian IV|Hadrian IV]] (1154–1159)

|row11=timeline
|row11-style=styleDefault
|row11-1-to=1046
|row11-2-to=1047
|row11-2-style=stylePopes
|row11-3-text=[[Pope Clement II|Clement II]] (1046–1047)

|row11-3-to=1159
|row11-4-to=1181
|row11-4-style=stylePopes
|row11-5-text=[[Pope Alexander III|Alexander III]] (1159–1181)

|row12=timeline
|row12-style=styleDefault
|row12-1-to=1047
|row12-2-to=1048
|row12-2-style=stylePopes
|row12-3-text=[[Pope Benedict IX|Benedict IX]] (1032–1044, 1045 and 1047–1048)

|row12-3-to=1159
|row12-4-to=1164
|row12-4-style=styleAntiPopes
|row12-5-text=[[Antipope Victor IV (1159-1164)|Victor IV]] (1159–1164), antipope

|row13=timeline
|row13-style=styleDefault
|row13-1-to=1048
|row13-2-to=1048.9
|row13-2-style=stylePopes
|row13-3-text=[[Pope Damasus II|Damasus II]] (1048)

|row13-3-to=1164
|row13-4-to=1168
|row13-4-style=styleAntiPopes
|row13-5-text=[[Antipope Paschal III|Paschal III]] (1164–1168), antipope

|row14=timeline
|row14-style=styleDefault
|row14-1-to=1049
|row14-2-to=1054
|row14-2-style=stylePopes
|row14-3-text=[[Pope Leo IX|Leo IX]] (saint) (1049–1054)

|row14-3-to=1168
|row14-4-to=1178
|row14-4-style=styleAntiPopes
|row14-5-text=[[Antipope Callixtus III|Callixtus III]] (1168–1178), antipope

|row15=timeline
|row15-style=styleDefault
|row15-1-to=1055
|row15-2-to=1057
|row15-2-style=stylePopes
|row15-3-text=[[Pope Victor II|Victor II]] (1055–1057)

|row15-3-to=1179
|row15-4-to=1180
|row15-4-style=styleAntiPopes
|row15-5-text=[[Antipope Innocent III|Innocent III]] (1179–1180), antipope

|row16=timeline
|row16-style=styleDefault
|row16-1-to=1057
|row16-2-to=1058
|row16-2-style=stylePopes
|row16-3-text=[[Pope Stephen IX|Stephen IX]] (1057–1058)

|row16-3-to=1181
|row16-4-to=1185
|row16-4-style=stylePopes
|row16-5-text=[[Pope Lucius III|Lucius III]] (1181–1185)

|row17=timeline
|row17-style=styleDefault
|row17-1-to=1058
|row17-2-to=1061
|row17-2-style=stylePopes
|row17-3-text=[[Pope Nicholas II|Nicholas II]] (1058–1061)

|row17-3-to=1185
|row17-4-to=1187
|row17-4-style=stylePopes
|row17-5-text=[[Pope Urban III|Urban III]] (1185–1187)

|row18=timeline
|row18-style=styleDefault
|row18-1-to=1058
|row18-2-to=1059
|row18-2-style=styleAntiPopes
|row18-3-text=[[Antipope Benedict X|Benedict X]] (1058–1059), antipope

|row18-3-to=1187
|row18-4-to=1187.9
|row18-4-style=stylePopes
|row18-5-text=[[Pope Gregory VIII|Gregory VIII]] (1187)

|row19=timeline
|row19-style=styleDefault
|row19-1-to=1061
|row19-2-to=1064
|row19-2-style=styleAntiPopes
|row19-3-text=[[Antipope Honorius II|Honorius II]] (1061–1064), antipope

|row19-3-to=1187
|row19-4-to=1191
|row19-4-style=stylePopes
|row19-5-text=[[Pope Clement III|Clement III]] (1187–1191)

|row20=timeline
|row20-style=styleDefault
|row20-1-to=1061
|row20-2-to=1073
|row20-2-style=stylePopes
|row20-3-text=[[Pope Alexander II|Alexander II]] (1061–1073)

|row20-3-to=1191
|row20-4-to=1198
|row20-4-style=stylePopes
|row20-5-text=[[Pope Celestine III|Celestine III]] (1191–1198)

|row21=timeline
|row21-style=styleDefault
|row21-1-to=1073
|row21-2-to=1085
|row21-2-style=stylePopes
|row21-3-text=[[Pope Gregory VII|Gregory VII]] (saint) (1073–1085)

|row21-3-to=1198
|row21-4-to=1216
|row21-4-style=stylePopes
|row21-5-text=[[Pope Innocent III|Innocent III]] (1198–1216)

|row22=timeline
|row22-style=styleDefault
|row22-1-to=1084
|row22-2-to=1100
|row22-2-style=styleAntiPopes
|row22-3-text=[[Antipope Clement III|Clement III]] (1084–1100), antipope

|row22-3-to=1216
|row22-4-to=1227
|row22-4-style=stylePopes
|row22-5-text=[[Pope Honorius III|Honorius III]] (1216–1227)

|row23=timeline
|row23-style=styleDefault
|row23-1-to=1085
|row23-2-to=1087
|row23-2-style=stylePopes
|row23-3-text=[[Pope Victor III|Victor III]] (1085–1087)

|row23-3-to=1227
|row23-4-to=1241
|row23-4-style=stylePopes
|row23-5-text=[[Pope Gregory IX|Gregory IX]] (1227–1241)

|row24=timeline
|row24-style=styleDefault
|row24-1-to=1088
|row24-2-to=1099
|row24-2-style=stylePopes
|row24-3-text=[[Pope Urban II|Urban II]] (1088–1099)

|row24-3-to=1241
|row24-4-to=1241.9
|row24-4-style=stylePopes
|row24-5-text=[[Pope Celestine IV|Celestine IV]] (1241)

|row25=timeline
|row25-style=styleDefault
|row25-1-to=1099
|row25-2-to=1118
|row25-2-style=stylePopes
|row25-3-text=[[Pope Paschal II|Paschal II]] (1099–1118)

|row25-3-to=1243
|row25-4-to=1254
|row25-4-style=stylePopes
|row25-5-text=[[Pope Innocent IV|Innocent IV]] (1243–1254)

|row26=timeline
|row26-style=styleDefault
|row26-1-to=1100
|row26-2-to=1100.9
|row26-2-style=styleAntiPopes
|row26-3-text=[[Antipope Theodoric|Theodoric]] (1100), antipope

|row27=timeline
|row27-style=styleDefault
|row27-1-to=1102
|row27-2-to=1102.9
|row27-2-style=styleAntiPopes
|row27-3-text=[[Antipope Adalbert|Adalbert]] (1102), antipope

|row28=timeline
|row28-style=styleDefault
|row28-1-to=1105
|row28-2-to=1111
|row28-2-style=styleAntiPopes
|row28-3-text=[[Antipope Silvester IV|Silvester IV]] (1105–1111), antipope

|row29=timeline
|row29-style=styleDefault
|row29-1-to=1118
|row29-2-to=1119
|row29-2-style=stylePopes
|row29-3-text=[[Pope Gelasius II|Gelasius II]] (1118–1119)

|row30=timeline
|row30-style=styleDefault
|row30-1-to=1118
|row30-2-to=1121
|row30-2-style=styleAntiPopes
|row30-3-text=[[Antipope Gregory VIII|Gregory VIII]] (1118–1121), antipope

|row31=timeline
|row31-style=styleDefault
|row31-1-to=1119
|row31-2-to=1124
|row31-2-style=stylePopes
|row31-3-text=[[Pope Callixtus II|Callixtus II]] (1119–1124)

|row32=scale
|caption=Popes and Antipopes of the Catholic Church from 1003 - 1254
}}

Renders as
timelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimelinetimeline Popes and Antipopes of the Catholic Church from 1003 - 1254

注の行

|row_n-i-at= 必須のパラメータ。注をどこに配置するか指定。
|row_n-i-text=は注の内容を指定
|row_n-i-shift= と|row_n-i-lift= は注の周りの余白を指定。既定は0em
|row_n-i-arrow= は引き出し線の記号を指定。既定は↓。非表示にするには を使用。

使用例

マークアップ

{{Horizontal timeline

|from=-600
|to=0

|row1=note
|row1-1-text='''Minor events'''
|row1-1-shift=-2.8em
|row1-1-arrow= 
|row1-1-at=-590
|row1-2-at=-542
|row1-2-text=[[:en:End-Ediacaran extinction|End-Ediacaran?]]
|row1-3-at=-420
|row1-3-text=[[:en:Lau event]]
|row1-4-at=-183
|row1-4-text=[[:en:Toarcian turnover]]
|row1-4-lift=-1em
|row1-4-shift=-4.8
|row1-6-at=-91.5
|row1-6-text=[[:en:Cenomanian-Turonian boundary event|Cenomanian-Turonian]]
|row1-6-lift=-1.3em
|row1-6-shift=-5.1

|row2=scale
|axis-nudge=-0.8em
|caption=現在よりも百万年単位で遡る

}}

描画

notescale

現在よりも百万年単位で遡る

注： |row1-5-lift= が不足。n 値とi 値は連続する必要はない。

使い方

{{navbox}} 内に使い、折りたたんで表示できます。実例と詳細は{{ tl|Restoration Movement Timeline graphical timeline}}。
- {{navbox}} のせいで行間の表示に影響したら、前後をに{{hidden begin}}と {{hidden end}}で挟みます。実例と詳細は{{tl|Vietnam War graphical timeline}}。
1列のみ抽出して表示するには、{{#invoke:Horizontal timeline | showOneRow | ...}} と書いてモジュールを直接、呼び出します。実例と詳細は{{tl|Geological eras}} または {{tl|Geological periods}}。
- 1列限定のテンプレートを作成すると、他のテンプレートに組み込みが可能で、規模とは無関係です。自動処理が1列限定テンプレートを切り詰め、親テンプレートに適合させます。実例として{{tl|Geological eras}}と {{tl|Geological periods}}は{{tl|Extinction events graphical timeline}}に組み込まれています。
ブラウザによりレンダリングに差があります。年表が完成したら、特に複雑なものの場合には、念のために最低でもIE、 Firefox、Chromeの3種で表示させると確実です。

使用例

既知の問題

バー表示の（行ではなく）外枠の左端と下端の処理に失敗する場合があり、原因はブラウザにボックスの領域指定 CSS3 box-sizing が未導入であると見られます（対応するブラウザの一覧はこちら（英語））。最近のブラウザは最低限の表示ができるようになっています。またバー表示で外枠がどうしても必要な事例は稀ともいえます。多くの場合、行間の枠線さえあれば役に立ちます。そこで本件は問題視の必要がありません。