Template:AppearanceMarkup

From BIONICLEsector01

Documentation

This template produces the markup necessary to render an appearance in a piece of media. It is used by Template:Appearance and should not be placed directly on articles.

Parameters

Parameter Function
section The section header under which the appearance should be categorized. Valid values are Books, Online, Comics, and Multimedia.
subsection The subsection header under which the appearance should be categorized. Valid values depend on the value of section as outlined below.
  • If section is set to Books: Novels, Chapter Books, Early Readers, Activity Books, Guides
  • If section set to Online: Chronicle, Story Serials, Animations, LEGO Club Articles
  • If section set to Comics: Main Series, Graphic Novel Exclusives, Promotional Comics, Graphic Novels
  • If section set to Multimedia: Movies, Television, Online Games, Video Games, Board Games, Card Games, CDs, Advertisements, Other
shortcut The shortcut (as listed in Template:FormattedTitleText) for this appearance's piece of media. For example, to note an appearance in "Showdown", set shortcut to IC3.
seriesshortcut

(optional)

The shortcut (as listed in Template:FormattedTitleText) for the series that this appearance's piece of media is a part of. For example, when noting an appearance in "Showdown", the seriesshortcut should be set to IC because that comic book is part of the BIONICLE Ignition series. If the piece of media is not part of a series, this parameter should not be set.
unnamed parameters

(optional; may provide up to five)

Additional notes that should be placed after inside parantheses using Template:C. For example, if an appearance took place in a vision, you may pass an in additional unnamed parameter with the value V, in which case '''{{C|V}}''' will be placed at the end of the appearance, yielding the following: (V).

How it works

The template produces several special ref tags that help fill in Template:Appearancelist.

Based on their group attributes, the tags get placed in appropriate references tags within the appearance list. When those references tags get filled in, the sections and headers nearby them appear thanks to CSS. As a result, the appearance list displays the proper headers for its appearances. (For example, if a character only appears in comics, then the appearance list will display its comic-related headers, but not other headers, such as book headers.)

For example, when this template generates an appearance for BIONICLE Heroes, it creates two ref tags.

The first is a dummy tag whose actual text is unimportant. What matters is that its group corresponds to BIONICLE Heroes' section header ("Multimedia"), so it is placed in a (hidden) references tag directly above the "Multimedia" section in Template:Appearancelist. Then a CSS rule causes the "Multimedia" section to appear. Since the references tag is hidden, the dummy ref does not actually appear and mess up the layout of the appearance list.

The second tag contains the actual information on BIONICLE Heroes that should be displayed. Its group corresponds to BIONICLE Heroes' subsection header ("Video Games"), so it is placed in a references tag directly underneath the "Video Game" header in Template:Appearancelist. Then a CSS rule causes the "Video Games" header to appear.

Overall, the ref tags work together to display BIONICLE Heroes in its correct section with the correct headers.