Template:Appearance

Template documentation (for the above template, sometimes hidden or invisible)

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 or reach out to User:CaptainOfTheTidesBreath, the template's author, so that it can be addressed or contemplated.

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 2, 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 2, 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}}	(first appearance)
{{1stID}}	(first identified as {{{1}}})
{{1stm}}	(first mentioned)
{{as}}	(as "{{{1}}}")
{{DM}}	[DM]
{{jaeger}}	[{{{1}}}]
{{flash}}	(appears in a flashback)
{{imo}}	(indirect mention only)
{{mo}}	(mentioned only)
{{po}}	(picture only)
{{vision}}	(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.
• subsection: If the appearance section is divided into subsections (to prevent a large number of mentions from overwhelming a small number of appearances), this parameter will remove the visible "mentioned only" text to cut down on redundancy while maintaining the proper categorization. You can enable this by putting anything into this parameter, such as "true", "1", or "yes".

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) (first appearance)

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

"On the Trail of a Killer" (3x04), mentioned only (first mentioned)

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) (vision)
{{appearance|2x141|mention}} "Fond Farewells" (2x141), mentioned only	{{appearance|2x141|{{mo}}}} "Fond Farewells" (2x141) (mentioned only)
{{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) (first appearance)

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

The above text is transcluded from Template:Appearance/doc; you can change it or view its history. (How does this work?)
If you're done making changes, please refresh the text. (Why?)
You can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Please add categories and interwikis to Template:Appearance/doc. (View all subpages of this page.)