使用者:Hillgentleman/家譜/doc
 |
是模板也，其源代碼暨原始碼，囊括可選之參數、特殊之構造，而悉皆精密。 欲改模板，宜先通其構造，知解析器函數。大典諸頁，引用此模板者，不爲不多。是故如有加筆，而致意外，宜立去之。 凡欲有所試驗，宜就沙盒模板，或造書齋爲之。 |
This is a template for rendering simple family trees consisting of boxes and connecting lines based on an ASCII art-like syntax. The trees are displayed as HTML tables using CSS attributes, and may contain arbitrary wiki markup within the boxes.
Example usage
[纂]This code:
{{User:Hillgentleman/家譜/始}}
{{User:Hillgentleman/家譜 | | | | GRM |~|y|~| GRP | | GRM=Grandma|GRP=Grandpa}}
{{User:Hillgentleman/家譜 | | | | | | | |)|-|-|-|.| }}
{{User:Hillgentleman/家譜 | | | MOM |y| DAD | |DAISY| MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}}
{{User:Hillgentleman/家譜 | |,|-|-|-|+|-|-|-|.| | | }}
{{User:Hillgentleman/家譜 | JOE | | ME | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}}
{{User:Hillgentleman/家譜/終}}
Produces this:
| Grandma | Grandpa | ||||||||||||||||||||||||
| Mom | Dad | Aunt Daisy | |||||||||||||||||||||||
| My brother Joe | Me! | My little sister | |||||||||||||||||||||||
Parameters
[纂]This template produces one row in a family tree table. The template accepts up to 99 unnamed parameters describing the contents of the table. Each parameter specifies a tile or a box.
- Tiles are line drawing symbols consisting of horizontal and vertical lines and various corners and crossings thereof. Tiles are specified using single-character symbols that more or less approximate the shape of the tile in appearance. A special case of a tile is the empty tile, specified by a single space character. A table of supported tiles is given below.
| , | . | ` | ' | ||||||||||||||||||||
| ^ | v | ( | ) | ||||||||||||||||||||
| - | ! | + | |||||||||||||||||||||
| F | 7 | L | J | |||||||||||||||||||
| A | V | C | D | |||||||||||||||||||
| ~ | : | % | ||||||||||||||||||||
| * | # | y | } | |||||||||||||||||||||
- Boxes can contain arbitrary wiki markup. The contents of boxes are specified using additional named parameters appended to the template call. Each box is three tiles wide and normally has a 2 pixels wide black border. Boxes can have any name that is a valid template parameter name, although single character names should be avoided to prevent conflicts with tile symbols.
The appearance of the boxes may be controlled by the optional template parameters border and boxstyle. The former sets the width of the box border in pixels, while the latter can be used to append arbitrary CSS declarations directly to the box style attributes. For example, the following code:
{{User:Hillgentleman/家譜/始}}
{{User:Hillgentleman/家譜|border=0|boxstyle=background:#dfd;| | FOO |y| BAR | |FOO=Box 1|BAR=Box 2}}
{{User:Hillgentleman/家譜|border=0|boxstyle=background:#dfd;| | |,|-|^|-|.| | }}
{{User:Hillgentleman/家譜|border=0|boxstyle=background:#dfd;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4}}
{{User:Hillgentleman/家譜/終}}
produces a result like this:
| Box 1 | Box 2 | ||||||||||||||||
| Box 3 | Box 4 | ||||||||||||||||
The {{familytree/start}} template also accepts an optional style parameter that can be used to set CSS styles for the entire table.
</includeonly>