Bản mẫu:Cây phả hệ
Bản mẫu này sử dụng những tính năng phức tạp của cú pháp bản mẫu.
Bạn được khuyến khích làm quen với cấu trúc thiết lập của bản mẫu và các hàm cú pháp trước khi sửa đổi bản mẫu. Nếu chỉnh sửa của bạn gây ra lỗi không mong muốn, hãy sửa chữa hoặc lùi lại nhanh chóng, vì bản mẫu này có thể xuất hiện trên một số lượng lớn các trang. Bất kỳ thử nghiệm và tất cả các thay đổi lớn nào cần thận trọng và nên được thử kiểm tra trước ở trang con thử chung của bản mẫu hoặc không gian trang cá nhân của bạn trước khi áp dụng thay đổi nào ở đây. |
Bản mẫu:Cây phả hệ này đã lỗi thời. Thay vào đó, vui lòng sử dụng Bản mẫu:Biểu đồ cây. |
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
sửaThis code:
{{familytree/start}} {{familytree | | | | GMa |~|y|~| GPa | | GMa=Grandma|GPa=Grandpa}} {{familytree | | | | | | | |)|-|-|-|.| }} {{familytree | | | MOM |y| DAD | |DAISY| MOM=Mom|DAD=Dad|DAISY=[[Aunt Daisy]]}} {{familytree | |,|-|-|-|+|-|-|-|.| | | }} {{familytree | JOE | | ME | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}} {{familytree/end}}
Produces this:
Grandma | Grandpa | ||||||||||||||||||||||||
Mom | Dad | Aunt Daisy | |||||||||||||||||||||||
My brother Joe | Me! | My little sister | |||||||||||||||||||||||
Parameters
sửaThis template produces one row in a family tree table. The template accepts up to 80 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 |
V |
7 |
|||||||||||||||
D |
% |
C |
|||||||||||||||
L |
A |
J |
|||||||||||||||
~ |
: |
|
r |
y |
n |
|||||||||||||||
] |
# |
[ |
|||||||||||||||
c |
h |
j |
|||||||||||||||
~ |
! |
|
p |
u |
q |
|||||||||||||||||
} |
* |
{ |
|||||||||||||||||
b |
t |
d |
|||||||||||||||||
- |
: |
|
T |
|||||||||||||||||||||
G |
X |
K |
k |
- 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.
Style attributes
sửaThe 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:
{{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;| | FOO | | BAR | |FOO=Box 3|BAR=Box 4}} {{familytree/end}}
produces a result like this:
Box 1 | Box 2 | ||||||||||||||||
Box 3 | Box 4 | ||||||||||||||||
Style attributes can even be set for individual boxes, as in the example below:
{{familytree/start}} {{familytree| | | | |WHITE| | | | |WHITE=White box}} {{familytree| |,|-|-|'|!|`|-|-|.| }} {{familytree|RED |~|GREEN|~|BLUE |RED=Red box|GREEN=Green box|BLUE=Blue box |boxstyle_RED =background-color: #faa; |boxstyle_GREEN=background-color: #afa; |boxstyle_BLUE =background-color: #aaf; }} {{familytree/end}}
which produces the output:
White box | |||||||||||||||||||||
Red box | Green box | Blue box | |||||||||||||||||||
NOTE: When specifying style attributes for individual named boxes, make sure the box names are aligned to the left side of area reserved for them in the template call (as in "|RED |
" instead of "| RED |
" in the example above). Otherwise the template will end up looking for a style parameter with spaces in its name.
The {{familytree/start}} template also accepts an optional style parameter that can be used to set CSS styles for the entire table.
Accessibility
sửaBản mẫu:AccessibilityDispute
This template has accessibility problems for screen reader users. The relationships between boxes (the lines) will be hidden, effectively reducing the chart to a series of paragraphs in order by row. Charts with each generation on separate rows (rather than in columns) should be a bit more accessible. It is also recommended that you add a summary
parameter to the start tag to describe the overall layout of the table. For example:
{{familytree/start| summary=Family tree diagram for Barack Obama, connecting 29 individuals in 4 generations. Generations are arranged in rows, with Barack appearing 3rd on the 3rd such row. The bottom right corner breaks out some additional relationships of his father.}}
See also
sửa- {{chart}} – supports more complex family trees
- familytree.js – tool to easily create or update diagrams using these templates
- Wikipedia:Family trees – other methods