Template:Familytree/doc

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

このテンプレートの記述は複雑な構成となっています。編集後の結果が予想できないか、または変更にともなう影響を修正する用意ができていない場合は編集をお控えください。練習や実験はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページでお願いします。

簡単な系図を生成するためのテンプレート。ボックスをアスキーアート的につないで系図をつくります。系図はHTMLのテーブルで表示され、CSSやウィキのマークアップが使えます。

使用の際には、系図の根拠となる出典を必ず明記するようにします。

Familytreeを使って記事ページを直接編集する場合は、記事ページ内に出典を記述します。
Familytreeを参照読み込みして系図の子テンプレートを作成する場合は、子テンプレート内に出典を明記します。子テンプレートの解説Doc内に出典を記述しても、一般の記事閲覧者は参照できないためです。

なお英語版テンプレートのFamilytreeは2015年3月に廃止となっており、{{Chart}}に移管されています。

→FamilytreeとChartの記述方法の対比表は「en:Template:Chart#Migration from familytree」を参照

使用例

ソース：

{{familytree/start}}
{{familytree | | | | GRM |~|y|~| GRP | | GRM=祖母|GRP=祖父}}
{{familytree | | | | | | | |)|-|-|-|.| }}
{{familytree | | | MOM |y| DAD | |DAISY| MOM=母|DAD=父|DAISY=[[花子叔母]]}}
{{familytree | |,|-|-|-|+|-|-|-|.| | | }}
{{familytree | JOE | | ME  | | SIS | | | JOE=太郎|ME='''私！'''|SIS=妹}}
{{familytree/end}}

出力結果：

祖母

祖父

母

父

花子叔母

太郎

私！

妹

可変要素

このテンプレートでは、1つのテンプレートが表を利用した系図の1列を生成します。テンプレートには最大99の任意のパラメーターを用いることができます。パラメーターには「タイル」と「ボックス」があります。

タイルは、人物間をつなぐ、縦線や横線を生成します。下記の通り、各種組み合わせに記号が1つ割り当てられています。また、半角スペース1つで空白のタイルが生成されます。

,

.

`

'

^

v

(

)

-

!

+

F

7

L

J

A

V

C

D

~

:

%

*

}

{

#

]

[

y

h

i

j

ボックスは、タイルに用いられていないものであれば、任意のパラメーターの名前を設定できます。ボックス1つがタイル3つ分で、特に指定しない限り2ピクセル幅の黒線の枠に囲まれます。ボックスの内容には任意のマークアップが使えます。

スタイル

ボックスの外見は、オプションのborderとboxstyleのパラメーターを使って変えられます。borderはボックスの外枠のピクセル幅を指定します。boxstyleには、任意のCSSによるスタイルを指定できます。下記の例を参照してください。

{{familytree/start}}
{{familytree|border=0|boxstyle=background:#dfd;| | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}}
{{familytree|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{familytree|border=0|boxstyle=background:#dfd; white-space:nowrap;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4 XXXXXXX}}
{{familytree/end}}

出力結果：

Box 1

Box 2

Box 3

Box 4 XXXXXXX

個別のボックスの色を変えることもできます。

{{familytree/start}}
{{familytree| | | | |WHITE| | | | |WHITE=白}}
{{familytree| |,|-|-|'|!|`|-|-|.| }}
{{familytree|RED  |~|GREEN|~|BLUE |RED=赤|GREEN=緑|BLUE=青 123456789
|boxstyle_RED  =background-color: #faa;
|boxstyle_GREEN=background-color: #afa;
|boxstyle_BLUE =background-color: #aaf; white-space:nowrap;
}}
{{familytree/end}}

出力結果：

白

赤

緑

青 123456789

各ボックスのスタイルを指定する時には、パラメータを指定する時にパイプ記号のあとにスペースが入らないように注意してください（"| RED |" ではなく "|RED |" のようにする）。スペースが入っていると、スペースもパラメータの一部として認識されてしまいます。

系図の表全体にCSSのスタイルを適用するには、{{familytree/start}}でオプションのstyleを設定してください。