Πρότυπο:Familytree/τεκμηρίωση

Από Γνωσιακή Βάση Υπηρεσιών και Διαδικασιών του Δημοσίου Τομέα
< Πρότυπο:Familytree
Αναθεώρηση ως προς 16:48, 11 Ιουνίου 2015 από τον Dkalo (Συζήτηση | συνεισφορές) (Εισήχθη 1 αναθεώρηση)
(διαφορά) ← Παλαιότερη αναθεώρηση | Τελευταία αναθεώρηση (διαφορά) | Νεότερη αναθεώρηση → (διαφορά)
Μετάβαση σε: πλοήγηση, αναζήτηση

Αυτό το πρότυπο χρησιμεύει στη δημιουργία απλών διαγραμμάτων, πχ για γενεαλογικά δέντρα. Η σύνταξή του μοιάζει με αυτή των διαγραμμάτων ΑSCII.

Παράδειγμα

Αυτός ο κώδικας:

{{familytree/start}}
{{familytree | | | | ΓΙΑ |~|y|~| ΠΑ | | ΓΙΑ=Γιαγιά|ΠΑ=Παππούς}}
{{familytree | | | | | | | |)|-|-|-|.| }}
{{familytree | | | ΜΑ |y| ΜΠΑ | |ΘΕΙ| ΜΑ=Μητέρα|ΜΠΑ=Πατέρας|ΘΕΙ=[[Θεία Ευτυχία]]}}
{{familytree | |,|-|-|-|+|-|-|-|.| | | }}
{{familytree | ΚΩΣΤΑΣ | | ΝΙΚΟΣ  | | ΜΑΡΙΑ | | | ΚΩΣΤΑΣ=Κωνσταντίνος|ΝΙΚΟΣ=Νικόλαος|ΜΑΡΙΑ=Μαρία}}
{{familytree/end}}

Παράγει το παρακάτω γενεαλογικό διάγραμμα:

 
 
 
Γιαγιά
 
 
 
Παππούς
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Μητέρα
 
Πατέρας
 
Θεία Ευτυχία
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Κωνσταντίνος
 
Νικόλαος
 
Μαρία
 
 

Parameters

This 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.
Solid lines:
,
 
 
 
 
v
 
 
 
.
 
 
 
)
 
 
 
+
 
 
 
 
(
 
 
 
`
 
 
 
^
 
 
 
'
 
 
 
-
 
 
!
 
 
 
Dashed lines:
F
 
 
 
 
V
 
 
 
7
 
 
 
D
 
 
 
%
 
 
 
 
C
 
 
 
L
 
 
 
A
 
 
 
J
 
 
 
~
 
 
:
 
 
 
Mixed (1):
r
{{{r}}}
y
 
 
 
n
{{{n}}}
]
 
 
 
#
 
 
 
 
[
 
 
 
c
{{{c}}}
h
 
 
 
j
{{{j}}}
~
 
 
!
 
 
 
Mixed (2):
p
{{{p}}}
u
{{{u}}}
q
{{{q}}}
}
 
 
 
*
 
 
 
 
{
 
 
 
b
{{{b}}}
t
{{{t}}}
d
{{{d}}}
-
 
 
:
 
 
 
Misc.:
T
{{{T}}}
G
{{{G}}}
X
{{{X}}}
K
{{{K}}}
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

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:

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

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.
Solid lines:
,
 
 
 
 
  .
 
 
 
  `
 
 
 
  '
 
 
 
 
^
 
 
 
  v
 
 
 
  (
 
 
 
  )
 
 
 
 
-
 
 
  !
 
 
  +
 
 
 
 
 
 
 
Dashed lines:
F
 
 
 
 
  7
 
 
 
  L
 
 
 
  J
 
 
 
 
A
 
 
 
  V
 
 
 
  C
 
 
 
  D
 
 
 
 
~
 
 
  :
 
 
  %
 
 
 
 
 
 
 
Mixed:
*
 
 
 
 
  }
 
 
 
  {
 
 
 
 
#
 
 
 
 
  y
 
 
 
  h
 
 
 
 
]
 
 
 
  [
 
 
 
 


  • 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

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:

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