View source for TemplateDoc:Acronym/Comic

{{Notice/TemplateDoc}}

==Usage==
This template is used to sanitise Halopedia [[Halopedia:Acronyms|comic and graphic novel acronyms]] before they are used in other templates. It does ''not'' guarantee that an acronym is valid, as the correct response to an invalid acronym will vary between templates that call this one. However, it guarantees that what it returns will be in lower case and that, if it ''was'' a valid acronym, it will have been replaced with the '''primary''' acronym for that topic. For instance, <code>HEsc</code> will have been replaced with <code>he</code>. This allows template pages to only have to consider the primary acronym cases, while still providing support for the secondary acronyms.

Usually, if no acronym match is found, the template will simply return exactly what was passed to it, albeit in lower case. However, by setting the <code>NoPassthrough</code> parameter, the template can be made to output nothing if the acronym does not exist.

===Parameters===
{| width=100% class="wikitable"
!width=12%|''Field Name''
!width=12%|''Field Aliases''
!width=12%|''Optional or Required?''
!width=auto|''Description''
!width=24%|''Example''
|-
|'''1''' {{C|Unnamed field}}
| -
|'''Required'''
|The acronym to sanitise.
|<code>FoR</code>
|-
|'''NoPassthrough'''
| -
|''Optional''
|Determines whether or not to pass the original argument through if no acronym match was found. If this flag is set - to anything at all - passthrough will be disabled. Otherwise, passthrough is enabled by default. 
|<code>yes</code>
|-
|'''Strict'''
| -
|''Optional''
|Determines whether or not the test should strictly adhere to the standard acronym defined on [[Halopedia:Acronyms|this page]]. If this is set (to any value whatsoever), it will only check against the standard acronyms. Otherwise, it may check against non-standard acronyms, that are specific to the comics.

'''IMPORTANT:''' Non-standard acronyms are permitted to clash with acronyms in other categories! For instance, with the strict flag disabled, this template treats <code>TFoR</code> and <code>HTFoR</code> as valid acronyms for ''[[Halo: Fall of Reach]]'' (comic), even though they're assigned to the novel ''[[Halo: The Fall of Reach]]'' according to the standard acronyms. Always set strict to enabled if your template deals with other types of media as well as comics.
|<code>yes</code>
|}

===Error states===
This template has no error states.

===Examples===
Here are some examples of what the template will output, when used:
{| class="wikitable"
!Wiki markup
!Result
|-
|
<pre><nowiki>
*Strict w/ passthrough: "{{Acronym/Comic|FoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|FoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|FoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|FoR|NoPassthrough=yes}}"
</nowiki></pre>
|
*Strict w/ passthrough: "{{Acronym/Comic|FoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|FoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|FoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|FoR|NoPassthrough=yes}}"
|-
|
<pre><nowiki>
*Strict w/ passthrough: "{{Acronym/Comic|HFoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|HFoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|HFoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|HFoR|NoPassthrough=yes}}"
</nowiki></pre>
|
*Strict w/ passthrough: "{{Acronym/Comic|HFoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|HFoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|HFoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|HFoR|NoPassthrough=yes}}"
|-
|
<pre><nowiki>
*Strict w/ passthrough: "{{Acronym/Comic|TFoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|TFoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|TFoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|TFoR|NoPassthrough=yes}}"
</nowiki></pre>
|
*Strict w/ passthrough: "{{Acronym/Comic|TFoR|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|TFoR}}"
*Strict w/o passthrough: "{{Acronym/Comic|TFoR|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|TFoR|NoPassthrough=yes}}"
|-
|
<pre><nowiki>
*Strict w/ passthrough: "{{Acronym/Comic|banana|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|banana}}"
*Strict w/o passthrough: "{{Acronym/Comic|banana|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|banana|NoPassthrough=yes}}"
</nowiki></pre>
|
*Strict w/ passthrough: "{{Acronym/Comic|banana|Strict=yes}}"
*Not strict w/ passthrough: "{{Acronym/Comic|banana}}"
*Strict w/o passthrough: "{{Acronym/Comic|banana|Strict=yes|NoPassthrough=yes}}"
*Not strict w/o passthrough: "{{Acronym/Comic|banana|NoPassthrough=yes}}"
|}

<noinclude>[[Category:Acronym template documentation]]</noinclude>