「テンプレート:Familytree/doc」を編集中

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
<!-- 以下でテンプレートの解説を編集してください -->
{{esoteric}}

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

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

なお英語版テンプレートのFamilytreeは2015年3月に[[WP:MODULE#廃止・削除|廃止]]となっており、{{tl|Chart}}に移管されています。{{See2|FamilytreeとChartの記述方法の対比表は「[[:en:Template:Chart#Migration from familytree]]」を}}

==使用例==
ソース：
<pre><nowiki>
{{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}}
</nowiki></pre>
出力結果：
{{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つで空白のタイルが生成されます。

{| style="float: left; margin-left: 1em;"
|+ '''実線'''
|-
| <code style="font-size:large">,</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|,}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">.</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|.}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">`</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|`}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">'</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|'}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">^</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|^}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">v</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|v}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">(</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|(}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">)</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|)}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">-</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|-}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">!</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|!}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">+</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|+}}{{familytree/end}} || &nbsp;
| <code style="font-size:large"> </code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree| }}{{familytree/end}} || &nbsp;
|}
{| style="float: left; margin-left: 1em;"
|+ '''破線'''
|-
| <code style="font-size:large">F</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|F}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">7</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|7}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">L</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|L}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">J</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|J}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">A</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|A}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">V</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|V}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">C</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|C}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">D</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|D}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">~</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|~}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">:</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|:}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">%</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|%}}{{familytree/end}} || &nbsp;
|}
{| style="float: left; margin-left: 1em;"
|+ '''組み合わせ'''
|-
| <code style="font-size:large">*</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|*}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">}</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|}|}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">{</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|{|}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">#</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|#}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">]</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|]}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">[</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|[}}{{familytree/end}} || &nbsp;
|-
| <code style="font-size:large">y</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|y}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">h</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|h}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">i</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|i}}{{familytree/end}} || &nbsp;
| <code style="font-size:large">j</code> || style="border: 1px solid gray;" | {{familytree/start}}{{familytree|j}}{{familytree/end}} || &nbsp;
|}
<br clear="left" />

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

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

<pre><nowiki>
{{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}}
</nowiki></pre>

出力結果：

{{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}}

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

<pre>
{{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}}
</pre>

出力結果：

{{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}}

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

系図の表全体にCSSのスタイルを適用するには、{{tl|familytree/start}}でオプションの''style''を設定してください。
<includeonly>
<!-- カテゴリは以下に追加してください -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Category:系図テンプレート|*]]

<!-- 言語間リンクは以下に追加してください -->
[[ca:Ajuda:Crear un arbre genealògic]]
[[ca:Plantilla:Arbre genealògic]]
[[cs:Šablona:Rodokmen]]
[[de:Vorlage:Stammbaum]]
[[en:Template:Familytree]]
[[es:Plantilla:Árbol genealógico]]
[[fa:الگو:شجره‌نامه]]
[[fr:Modèle:Arbre généalogique]]
[[lt:Šablonas:Familytree]]
[[ka:თარგი:გენეალოგია]]
[[km:ទំព័រគំរូ:Familytree]]
[[pl:Szablon:Familytree]]
[[pt:Predefinição:Árvore genealógica]]
[[ru:Шаблон:Familytree]]
[[sr:Шаблон:Родослов]]
[[sv:Mall:Släktträd]]
[[th:แม่แบบ:Familytree]]
[[zh:Template:Familytree]]
</includeonly>