Editing Template:File icon/doc

<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
Generates icons from [[:Category:Icons|image files]] and links to an appropriate page with an anchor link. Unlike the {{template|icon}} template icons, these icons do not need to be manually defined.
== Paramaters ==
The icon uses the <code><nowiki>[[File:{pre}_{2}.png|{w}|link={page}#{3}|{3}]]</nowiki></code> format.
{| class="wikitable"
! Parameter !! Description !! Required? !! Default
|-
| 1 || Defines the default file prefix and linked page. || '''required''' || —
|-
| 2 || Icon name || '''required''' || —
|-
| 3 || Display name and anchor link; optional if it matches parameter 2 || optional || [2]
|-
| w || Icon size || optional  || 24px
|-
| pre || Defines the file prefix || optional || depends on file type
|-
| page || Defines the linked page || optional || depends on file type
|-
| type || Modifies part of the default link || optional || depends on file type
|-
| iconify || Appends the text of parameter 3 || optional || —
|}

== Example ==
<code><nowiki>{{file icon|trait|presapient|Serviles|iconify=yes}}</nowiki></code> results in: {{file icon|trait|presapient|Serviles|iconify=yes}}

<code><nowiki>{{file icon|trait robot|Domestic Protocols|iconify=yes}}</nowiki></code> results in: {{file icon|trait robot|Domestic Protocols|iconify=yes}}

== Icon types ==

Icon type, defined by the first parameter, defines the default file prefix, and which page is linked by the icon.

{| class="wikitable"
|+ Default values
! Paramater 1 
! Image prefix<br/>(<code>pre</code>)
! Linked page<br/>(<code>page</code>)
! Images
|-
| auth / authority || <code>auth</code> || rowspan="3" | [[Government]] || rowspan="3" | [[:Category:Authority icons]]
|-
| auth cyber || <code>auth cyber</code>
|-
| auth synth || <code>auth synth</code>
|-
| civic || <code>civic</code> || rowspan="4" | [[Civics]] || rowspan="4" | [[:Category:Civics icons]]
|-
| civic hive || <code>civic hive</code>
|-
| civic machine || <code>civic machine</code>
|-
| civic corporate || <code>civic corporate</code>
|-
| tech || <code>tech</code> || [[Society research]] if <code>type=society</code><br/>[[Physics research]] if <code>type=physics</code><br/>[[Engineering research]] if <code>type=engineering</code> || [[:Category:Technology icons]]
|-
| trait || <code>trait</code> || [[Biological traits]]<br/>[[Machine traits]] if <code>type=machine</code> || rowspan="2" | [[:Category:Trait icons]]
|-
| trait robot || <code>trait robot</code> || [[Machine traits]]
|-
| deposit<br/>planet feature || <code>d</code> || [[Planetary features]] || [[:Category:Planet feature icons]]
|-
| decision || <code>decision</code> || [[Decision]] || [[:Category:Decision icons]]
|-
| job || <code>job</code> || [[Jobs]] || [[:Category:Job icons]]
|-
| ascension perk / ap || <code>ap</code> || [[Ascension perks]] || [[:Category:Ascension perk icons]]
|-
| relic || <code>r</code> || [[Relics]] || [[:Category:Relic icons]]
|-
| resolution || <code>resolution</code> || [[Resolution]] || [[:Category:Resolution images]]
|-
| agenda || <code>agenda</code> || [[Agenda]] || [[:Category:Agenda icons]]
|-
| specimen || <code>specimen</code> || [[Specimen]] || [[:Category:Specimen icons]]
|}