Шаблон:Chart

Материал из Википедии — свободной энциклопедии
Перейти к навигации Перейти к поиску
Документация

Шаблон для рисования простых диаграмм, состоящих из блоков соединенных линиями, основанный на ASCII-подобном синтаксисе. Деревья прорисовываются как HTML таблицы используя CSS, и могут содержать произвольный вики-код внутри блоков. Этот шаблон основан на {{familytree}} шаблоне и предоставляет дополнительные возможности для создания диаграмм.

Пример

[править код]

Этот код:

{{chart/start}}
{{chart| | | | GrMa |~|y|~| GRP | | GrMa=Grandma|GRP=Grandpa}}
{{chart| | | | | | | |)|-|-|-|.| }}
{{chart| | | MOM |y| DAD | |DAISY| MOM=Mom|DAD=Dad|DAISY=Aunt Daisy}}
{{chart| |,|-|-|-|+|-|-|-|.| | | }}
{{chart| JOE | | ME  | | SIS | | | JOE=My brother Joe|ME='''Me!'''|SIS=My little sister}}
{{chart/end}}

формирует следующую диаграмму:

GrandmaGrandpa
MomDadAunt Daisy
My brother JoeMe!My little sister

Параметры

[править код]

Этот шаблон добавляет одну строку в таблицу дерева семьи. Шаблон может содрежать до 50 неназванных параметров, описывающих содержание таблицы. Каждый параметр определяет tile или box.

  • Tiles are line drawing symbols consisting of horizontal and vertical lines and various corners and crossings thereof. Tiles are specified using one- or two-character symbols: for the most common tiles, that character is 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 available tiles is given below.
Solid lines:
,
  .
  `
  '
 
^
  v
  (
  )
 
-
  !
  +
 
 
Dashed lines:
F
  7
  L
  J
 
A
  V
  C
  D
 
~
  :
  %
 
 
Dotted lines:
S
  T
  Y
  Z
 
W
  M
  G
  H
 
P
  Q
  R
 
 
Mixed:
*
  d
  c
        a
  k
  l
        a2
  k2
  l2
 
t
  y
  h
        b
  m
  n
        b2
  m2
  n2
 
f
  e
  i
  j
  o
  p
  q
  r
  o2
  p2
  q2
  r2
 


  • Boxes can contain arbitrary wiki markup. The content of each box is specified using additional named parameters appended to the template call. Each box is three tiles wide and normally has a black border two pixels wide. Boxes can have any name that is a valid template parameter name, subject to a minimum of two alphabetical characters.

Style attributes

[править код]

The appearance of the boxes may be controlled by the following optional template parameters:

  • border specifies the width of the box border in pixels,
  • boxstyle can be used to append arbitrary CSS declarations directly to the box style attributes.

For example, the following code:

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

produces this chart:

Box 1Box 2
Box 3Box 4

Style attributes can even be set for individual boxes, as in the example below:

{{chart/start}}
{{chart| | | | |CLEAR| | | | |CLEAR=Clear box}}
{{chart| |,|-|-|'|!|`|-|-|.| }}
{{chart|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;
}}
{{chart/end}}

which produces this:

Clear box
Red boxGreen boxBlue box

NOTE: When specifying style attributes for individual named boxes, make sure the box names are aligned to the left side of the 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 {{chart/start}} template also accepts an optional style parameter that can be used to set CSS styles for the entire diagram.

Migration from familytree

[править код]

The {{chart}} template is largely compatible with the earlier {{familytree}} template. However, to use the additional functionality offered with this template, diagrams must be updated to use {{chart}} instead. Many {{familytree}} diagrams can be altered to use {{chart}} and its sub-templates simply by replacing the wikitext familytree with chart. A few of the «mixed» tiles had to be renamed, and {{familytree}} diagrams using these tiles will have to make a few changes. Additionally, two new «mixed» tiles have been added, joining solid lines to dashed lines. The following table summarises the differences:

Tile {{familytree}} {{chart}}
{ c
} d
# t
[ e
] f
  i
  j

Lastly, if any uses of the {{familytree}} template end with |}}, that vertical bar should be removed, leaving the last cell in that row containing either some text or a space.

The familytree.js tool below can be used to convert between syntaxes. Just change the start tag when in edit view, then click «Art → Templates» to toggle back to wikitext view. The other templates will be updated to match.

Ошибки

[править код]
  • :Шаблон:Chart/cellb вызывается любым элементом |}}, следует изменить на }}
  • :Шаблон:Chart/celltШаблон:Chart/cellb вызывается любым элементом ||, следует изменить на | |

См. также

[править код]
  • familytree.js — инструмент для быстрого создания и обновления диаграмм, использующих данный шаблон