Template:Appearance/doc

If you encounter any notable strangeness, need any help, have any suggestions, or want to request any features, please leave a note on this template's talk page so that it can be addressed or contemplated. It is currently updated through the third arc of Campaign Three.

Description

This template is used to create a list of appearances and mentions on a character article that will auto-categorize them into the correct appearances (both at the campaign and arc level) and into the mentioned categories by campaign, such as Category:Characters mentioned in Campaign Two, Category:Characters in the pre-stream, and Category:Characters in the Swords and Angels arc.

Limitations

• Not very effective for the articles of main player characters, which will likely take the form of "Appeared in all episodes of Campaign Two, except for...". Categorization for main player characters may need to be done manually instead of using this template.

Dependencies

• Uses {{ep}}.

Syntax

Type {{appearance|< episode (CxEE) or name of work >|< type of appearance or mention >|< optional notes >}} somewhere.

• 1: The first parameter is the item. This is usually the stream episode in CxEE format. Do not use the {{ep}} template as the template automatically uses this. Use "pre-stream" (with the hyphen) if the appearance or mention is the pre-stream. Otherwise, you can insert anything applicable into this parameter, including the formatted name of a comic or novel, such as ''[[Kith & Kin]]'' or ''[[The Tales of Exandria: The Bright Queen]]'' or ''[[Call of the Netherdeep]]''.
• 2: The second parameter is the type of appearance or mention. The following are valid values and what they output:
  • "appear" adds the relevant appeared category
  • "mention" outputs "mentioned only" and adds the relevant mentioned category
  • "indirect" outputs "indirectly mentioned only". Note, an indirect mention is not the same as an unnamed mention such as "my brother" or "the marquis".
  • "vision" outputs "in a vision" and adds the relevant appeared category
  • "scrying" outputs "via Scrying" and adds the relevant appeared category
  • "sending" outputs "via Sending" and adds the relevant appeared category
  • Leaving this blank or not including this at all functions identically to as if you put "appear". If you wish to use the third parameter (see next), you must put "appear". This functionality only works if you do not intend to insert appearance notes.
  • Anything other than the above will display what you inserted into the parameter and be treated as a mention. To add a type of appearance not covered here and add the relevant appeared category, use "appear" in the second parameter and put what you wanted into the third parameter (see next).

{{1st}}	Template:1st
{{1stID}}	Template:1stID
{{1stm}}	Template:1stm
{{as}}	Template:As
{{DM}}	Template:DM
{{jaeger}}	[{{{1}}}]
{{flash}}	Template:Flash
{{imo}}	Template:Imo
{{mo}}	Template:Mo
{{po}}	Template:Po
{{vision}}	Template:Vision

• 3: The third parameter is optional notes. Whatever is added to this parameter will be added to the end. It can be formatted. You may consider using one of the following templates in the table at right, though it is not strictly necessary.
• nocat: This is used to prevent the template from adding the relevant mention category. This is intended to be used only for characters who are mentioned in the campaign before they appear because characters who appear in the campaign are discluded from the paired mentioned category. You can enable this by putting anything into this parameter, such as "true", "1", or "yes".
• nocomma: If you do not wish to have a comma between the type of appearance or mention and the optional notes (the third parameter), such as in the case of wanting "mentioned only as the Ruby of the Sea". You can enable this by putting anything into this parameter, such as "true", "1", or "yes". If you use one of the templates in the table at right or manually input a note beginning with a left parenthesis, the template will detect this and automatically remove the comma, so in those cases, it is not necessary to manually set this.

Examples

{{appearance|2x98|appear}}

"Dark Waters" (2x98)

{{appearance|2x72|scrying}}

"Clay and Dust" (2x72), via Scrying

{{appearance|pre-stream|vision|as the Traveler|nocomma=true}}

Pre-stream, in a vision as the Traveler

{{appearance|2x113|mention}}

"A Heart Grown Cold" (2x113), mentioned only

{{appearance|2x01|appear|first named as the Traveler}}

"Curious Beginnings" (2x01), first named as the Traveler

{{appearance|''[[Explorer's Guide to Wildemount]]''|appear|Figures of Interest entry}}

Explorer's Guide to Wildemount, Figures of Interest entry

{{appearance|''[[Kith & Kin]]''|appear|first named as Lyre}}

Kith & Kin, first named as Lyre

{{appearance|2x22|appear|{{1st}}}}

"Lost Treasures" (2x22), Template:1st

{{appearance|3x04|mention|{{1stm}}}}

"On the Trail of a Killer" (3x04), mentioned only, Template:1stm

Note that the following pairs, and ones of similar syntax, are functionally identical and produce the same categorization.

{{appearance|2x76|Scrying}} "Refjorged" (2x76), via Scrying	{{appearance|2x76|appear|via ''Scrying''}} "Refjorged" (2x76), via Scrying
{{appearance|3x04|vision}} "On the Trail of a Killer" (3x04), in a vision	{{appearance|3x04|appear|{{vision}}}} "On the Trail of a Killer" (3x04), Template:Vision
{{appearance|2x141|mention}} "Fond Farewells" (2x141), mentioned only	{{appearance|2x141|{{mo}}}} "Fond Farewells" (2x141), Template:Mo
{{appearance|2x80|mention|seen in a painting}} "The Folding Halls" (2x80), mentioned only, seen in a painting	{{appearance|2x80|in a painting}} "The Folding Halls" (2x80), in a painting
{{appearance|2x22|appear}} "Lost Treasures" (2x22)	{{appearance|2x22}} "Lost Treasures" (2x22)

Again, inserting anything into the second parameter that is not among the canonical uses listed in the section above defaults to a mention, not an appearance. Thus, the output being the same does not necessarily mean it is identical:

Identical:

{{appearance|2x76|Scrying}} — "Refjorged" (2x76), via Scrying

{{appearance|2x76|appear|via ''Scrying''}} — "Refjorged" (2x76), via Scrying

Not identical:

{{appearance|2x99|via ''Speak with Dead''}} — "High Seas, High Stakes" (2x99), via Speak with Dead

{{appearance|2x99|appear|via ''Speak with Dead''}} — "High Seas, High Stakes" (2x99), via Speak with Dead

Not identical:

{{appearance|2x36|appear|{{1st}}}} — "O Captain, Who's Captain?" (2x36), Template:1st

{{appearance|2x36|{{1st}}}} — "O Captain, Who's Captain?" (2x36), Template:1st