Template:Flag: Difference between revisions

Latest revision as of 20:35, 3 April 2024

Template Documentation [View] [Edit] [History] [Help] [Refresh]

This document transclude from Template:Flag/doc.

This template generates a standardized flag header.

Usage

A separate flag header should be used for each context the flag is used in. Distinct contexts include files and sections where flag usage differs. For example, Type is used in rules(md).ini for SuperWeaponTypes, sound(md).ini for VocTypes, and eva(md).ini for VoxTypes. This ensures that contextual flag usage is documented with accuracy.

This template includes Category:INI Flags automatically.

{{Flag
|name=
|files={{Categ|ini{{=}}''ini-name''}}, ...
|values={{values|''value-type''}}
|special=
|default=
|extver=
|types={{Categ|''section-name''}}, ...
|ra2obsolete=
|tsobsolete=
|rponly=
|aresflag=
|hpflag=
|''games''
}}

Copy-paste the code above and fill out the parameters as follows:

`name`	The exact name of the flag. Defaults to `{{PAGENAME}}`.
`files`	Which file the flag can be used in. Template:Categ, with {{{ini}}} set to the correct ini-name, should be used for consistency. Defaults to `{{Categ\|ini=rules}}`.
`values`	Possible values the flag accepts. Template:Values should be used for consistency.
`special`	Special values, if any. For example, −1¹ is a special value for Ammo. This parameter is optional².
`default`	The default value for the flag. This parameter is optional².
`extver`	What version of the appropriate EXE extension (Ares or HyperPatch) is required before this flag can be used. This parameter should only be used if `rponly`, `aresflag` or `hpflag` is set to yes.
`types`	The sections the flag pertains to. Template:Categ should be used for consistency.
`games`	Which games the flag is parsed in. To select a game, add a parameter in the form of `code=yes`. For example, `yr=yes` indicates that the flag is parsed in Yuri's Revenge.
`ra2obsolete`	If this flag is obsolete in Red Alert 2 and Yuri's Revenge, then add this to include the Obsolete banner.
`tsobsolete`	Add this one instead of 'ra2obsolete' if the flag is obsolete in Tiberian Sun as well as Red Alert 2 and Yuri's Revenge.
`rponly`	If this is a flag introduced in the RockPatch, add this.
`aresflag`	If this is a flag introduced in Ares, add this.
`hpflag`	If this flag is introduced by HyperPatch, add this.

Parameter Codes for games

Code	Game
`td`	Tiberian Dawn
`co`	The Covert Operations
`ra`	Red Alert
`cs`	Counterstrike
`am`	Aftermath
`ts`	Tiberian Sun
`fs`	Firestorm
`hp`	HyperPatch
`ra2`	Red Alert 2
`yr`	Yuri's Revenge
`ares`	Ares
`gen`	Generals
`zh`	Zero Hour
`tw`	Tiberium Wars
`kw`	Kane's Wrath

Notes

¹ ↑ For negative numbers, − should be used for the sign instead of a hyphen.

² ↑ If there is no explicit value, do not set this parameter.

@@ Line 1: / Line 1: @@
-<includeonly><div style="position: relative; top: -1em; left: 0em;">
+<includeonly><div style="position:relative;">
 {| class="template_modbar_table gamegallery"
-|[[Image:Game_td_{{ #ifeq: {{{td}}} | yes | yes | no }}.png|Tiberian Dawn]]
+|[[Image:Game_td_{{#switch:{{{td}}}|yes|true|1=yes|no}}.png|Tiberian Dawn]]
-|[[Image:Game_co_{{ #ifeq: {{{co}}} | yes | yes | no }}.png|The Covert Operations]]
+|[[Image:Game_co_{{#switch:{{{co}}}|yes|true|1=yes|no}}.png|The Covert Operations]]
-|[[Image:Game_ra_{{ #ifeq: {{{ra}}} | yes | yes | no }}.png|Red Alert]]
+|[[Image:Game_ra_{{#switch:{{{ra}}}|yes|true|1=yes|no}}.png|Red Alert]]
-|[[Image:Game_cs_{{ #ifeq: {{{cs}}} | yes | yes | no }}.png|Counterstrike]]
+|[[Image:Game_cs_{{#switch:{{{cs}}}|yes|true|1=yes|no}}.png|Counterstrike]]
-|[[Image:Game_am_{{ #ifeq: {{{am}}} | yes | yes | no }}.png|Aftermath]]
+|[[Image:Game_am_{{#switch:{{{am}}}|yes|true|1=yes|no}}.png|Aftermath]]
-|[[Image:Game_ts_{{ #ifeq: {{{ts}}} | yes | yes | no }}.png|Tiberian Sun]]
+|[[Image:Game_ts_{{#switch:{{{ts}}}|yes|true|1=yes|no}}.png|Tiberian Sun]]
-|[[Image:Game_fs_{{ #ifeq: {{{fs}}} | yes | yes | no }}.png|Firestorm]]
+|[[Image:Game_fs_{{#switch:{{{fs}}}|yes|true|1=yes|no}}.png|Firestorm]]
-|[[Image:Game_ets_{{ #ifeq: {{{ets}}} | yes | yes | no }}.png|Extended Tiberian Sun]]
+|[[Image:Game_hp_{{#switch:{{{hp}}}|yes|true|1=yes|no}}.png|HyperPatch|32px]]
-|[[Image:Game_ra2_{{ #ifeq: {{{ra2}}} | yes | yes | no }}.png|Red Alert 2]]
+|[[Image:Game_ra2_{{#switch:{{{ra2}}}|yes|true|1=yes|no}}.png|Red Alert 2]]
-|[[Image:Game_yr_{{ #ifeq: {{{yr}}} | yes | yes | no }}.png|Yuri's Revenge]]
+|[[Image:Game_yr_{{#switch:{{{yr}}}|yes|true|1=yes|no}}.png|Yuri's Revenge]]
-|[[Image:Game_rp_{{ #ifeq: {{{rp}}} | yes | yes | no }}.png|RockPatch]]
+|[[Image:Game_ares_{{#switch:{{{ares}}}|yes|true|1=yes|no}}.png|Ares]]
-|[[Image:Game_gen_{{ #ifeq: {{{gen}}} | yes | yes | no }}.png|Generals]]
+|[[Image:Game_gen_{{#switch:{{{gen}}}|yes|true|1=yes|no}}.png|Generals]]
-|[[Image:Game_zh_{{ #ifeq: {{{zh}}} | yes | yes | no }}.png|Zero Hour]]
+|[[Image:Game_zh_{{#switch:{{{zh}}}|yes|true|1=yes|no}}.png|Zero Hour]]
-|[[Image:Game_tw_{{ #ifeq: {{{tw}}} | yes | yes | no }}.png|Tiberium Wars]]
+|[[Image:Game_tw_{{#switch:{{{tw}}}|yes|true|1=yes|no}}.png|Tiberium Wars]]
+|[[Image:Game_kw_{{#switch:{{{kw}}}|yes|true|1=yes|no}}.png|Kane's Wrath]]
 |}
 {|align="left" width="100%" cellspacing="0" cellpadding="0" class="template_flag" height="100%"
@@ Line 22: / Line 23: @@
 |-
 |'''File(s):'''
-|{{{files|{{ini|rules|catinc=yes}}}}}
+|{{{files|{{Categ|ini=rules}}}}}
 |-
 |'''Values:'''
-|{{{values|ERROR &ndash; No value type or list set! Please [{{fullurl:{{FULLPAGENAME}}|action=edit}} edit] this page and fix the [[Template:Flag|Flag template]]! [[Category:Flags missing value types]]}}}
+|{{{values|ERROR &ndash; No value types set! Please <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit}} edit]</span> this page and fix the [[Template:Flag|Flag template]]![[Category:Flags missing value types]]}}}
-|-{{#if: {{{special|}}} |<br>
+|-{{#if:{{{special|}}}|<br />
 {{!}}'''Special Values:'''
 {{!}}{{{special}}}
-{{!}}- }}{{#if: {{{default|}}} |<br>
+{{!}}-}}{{#if:{{{default|}}}|<br />
 {{!}}'''Default:'''
 {{!}}{{{default}}}
-{{!}}- }}{{#if: {{{types|}}} |<br>
+{{!}}-}}{{#if:{{{extver|}}}|<br />
+{{!}}'''Extension Version:'''
+{{!}}{{{extver}}}
+{{!}}-}}{{#if:{{{types|}}}|<br />
 {{!}}'''Applicable to:'''
-{{!}}{{{types}}} }}{{ #ifeq: {{{deezire}}} | yes | <br>
+{{!}}{{{types}}}|[[Category:Flags missing object types they can be applied to]]}}{{#ifeq:{{{deezire}}}|yes|<br />
 {{!}}-
-{{!}}colspan="2" style="background-color: #FF8888"{{!}}<p style="font-size: 85%; padding: 0.1em;">'''This entry was copied from [[DeeZire's Red Alert 2 and Yuris Revenge INI Editing Guide]] for the sake of completeness. As it is not our intention to rip off DeeZire's work, this article is subject to a re-write and update with the latest community knowledge.'''</p><p style="font-size: x-small; padding: 0.1em;">For further information, please read [[ModEnc:Inclusion of DeeZire's Red Alert 2 and Yuris Revenge INI Editing Guide|this]].</p> }}{{ #ifeq: {{{xgamer}}} | yes | <br>
+{{!}}colspan="2" style="background-color:#ff8888"{{!}}<p style="font-size:85%; padding:0.1em;">'''This entry was copied from {{theguide}} for the sake of completeness. As it is not our intention to rip off [[DeeZire]]'s work, this article is subject to a re-write and update with the latest community knowledge.'''</p><p style="font-size:x-small; padding:0.1em;">For further information, please read [[ModEnc:Inclusion of DeeZire's Red Alert 2 and Yuris Revenge INI Editing Guide|Inclusion of The Guide]].</p>}}{{#ifeq: {{{xgamer}}}|yes|<br />
 {{!}}-
-{{!}}colspan="2" style="background-color: #FF8888"{{!}}<p style="font-size: 85%; padding: 0.1em;">'''This entry was copied from [[Red Alert 2 ART.INI Guide|XGamer's Red Alert 2 ART.INI Guide]] for the sake of completeness. As it is not our intention to rip off xgamer's work, this article is subject to a re-write and update with the latest community knowledge.'''</p><p style="font-size: x-small; padding: 0.1em;">For further information, please read [[ModEnc:Inclusion of XGamer's ART.INI Guide|this]].</p> }}{{ #ifexpr: {{ #ifexist: {{PAGENAME}} I | 1 | 0 }} or {{ #ifexist: {{PAGENAME}} II | 1 | 0 }} or {{ #ifexist: {{PAGENAME}} III | 1 | 0 }} or {{ #ifexist: {{PAGENAME}} IIII | 1 | 0 }} | <br>
+{{!}}colspan="2" style="background-color:#ff8888"{{!}}<p style="font-size:85%; padding:0.1em;">'''This entry was copied from [[Red Alert 2 ART.INI Guide|XGamer's Red Alert 2 ART.INI Guide]] for the sake of completeness. As it is not our intention to rip off [[XGamer]]'s work, this article is subject to a re-write and update with the latest community knowledge.'''</p><p style="font-size:x-small; padding:0.1em;">For further information, please read [[ModEnc:Inclusion of XGamer's ART.INI Guide|Inclusion of ART.INI Guide]].</p>}}{{#ifeq:{{{ra2obsolete}}}|yes|<br />
 {{!}}-
-{{!}}style="background-color: #FF5E5E"{{!}}'''Warning:'''
+{{!}}colspan="2" style="background-color:#ff8888"{{!}}<p style="font-size:85%; padding:0.1em;">'''[[Image:Cc_cnrdelete-all.png]]Logic related to {{tt|{{PAGENAME}}}}, as a whole or in part, is ''obsolete'' in {{ra2}} and/or {{yr}}.</p>[[Category:Obsolete]]}}{{#ifeq:{{{tsobsolete}}}|yes|<br />
-{{!}}style="background-color: #FF8888"{{!}}One or more numbered subpages exist: {{ #ifexist: {{PAGENAME}} I | [[{{PAGENAME}} I]] |}}{{ #ifexist: {{PAGENAME}} II | , [[{{PAGENAME}} II]] |}}{{ #ifexist: {{PAGENAME}} III | , [[{{PAGENAME}} III]] |}}{{ #ifexist: {{PAGENAME}} IIII | , [[{{PAGENAME}} IIII]] |}}. These should be merged into '''this''' page. [[Category:Flags with import-generated subpages]] |}}
+{{!}}-
-|}</div>{{clr}}[[Category:INI Flags]]{{#if: {{{types|}}} ||[[Category:Flags missing object types they can be applied to]]}}</includeonly><noinclude>This template generates a standardized flag header.
+{{!}}colspan="2" style="background-color:#ff8888"{{!}}<p style="font-size:85%; padding:0.1em;">'''[[Image:Cc_cnrdelete-all.png]]Logic related to {{tt|{{PAGENAME}}}}, as a whole or in part, is ''obsolete'' in {{ts}}, {{ra2}} and/or {{yr}}.</p>[[Category:Obsolete]]}}{{#ifeq:{{{rponly}}}|yes|<br />
+{{!}}-
-==Usage==
+{{!}}colspan="2" style="background-color:#8A2BE2"{{!}}<p style="font-size:100%; padding:0.1em">'''[[Image:Game_rp_yes.png]]{{co|This flag is part of the |white}}<b>[[RockPatch]]</b>.</p>[[Category:RockPatch Flags]]}}{{#ifeq:{{{aresflag}}}|yes|<br />
-A separate flag header should be used for each context the flag is used in. Distinct contexts include files and sections where flag usage differs. For example, {{TTL|Type}} is used in {{ini|rules}} for [[SuperWeaponTypes]], {{ini|sound}} for [[VocTypes]], and {{ini|eva}} for [[VoxTypes]]. This ensures that contextual flag usage is documented with accuracy.
+{{!}}-
+{{!}}colspan="2" style="background-color:#0E2765"{{!}}<p style="font-size:100%; padding:0.1em;color:#E0E8FB">'''[[Image:Game_ares_yes.png]]This flag is part of <b>[[Ares|{{Co|Ares|white}}]]</b>. Do not use it without Ares installed.</p>[[Category:Ares Flags]]}}{{#ifeq:{{{hpflag}}}|yes|<br />
-This template includes [[:Category:INI Flags]] automatically.
+{{!}}-
+{{!}}colspan="2" style="background-color:#F0C420"{{!}}<p style="font-size:100%; padding:0.1em">'''[[Image:Game_hp_yes.png|32px]]This flag is part of <b>[[HyperPatch]]</b>. Do not use it without HyperPatch installed.</p>[[Category:HyperPatch Flags]]}}{{#ifexpr:{{#ifexist:{{PAGENAME}}_I|1|0}} or {{#ifexist:{{PAGENAME}}_II|1|0}} or {{#ifexist:{{PAGENAME}}_III|1|0}} or {{#ifexist:{{PAGENAME}}_IIII|1|0}}|<br />
- {{Flag
+{{!}}-
- {{!}}name=
+{{!}}style="background-color:#ff5e5e"{{!}}'''Warning:'''
- {{!}}files={{ini{{!}}''ini-name''{{!}}catinc=yes}}
+{{!}}style="background-color:#ff8888"{{!}}One or more numbered subpages exist: {{ #ifexist: {{PAGENAME}}_I|[[{{PAGENAME}} I]]|}}{{ #ifexist: {{PAGENAME}}_II|, [[{{PAGENAME}} II]]|}}{{ #ifexist: {{PAGENAME}}_III|, [[{{PAGENAME}} III]]|}}{{ #ifexist: {{PAGENAME}}_IIII|, [[{{PAGENAME}} IIII]]|}}. These should be merged into ''this'' page. [[Category:Flags with import-generated subpages]]|}}
- {{!}}values={{values{{!}}''value-type''}}
+|}{{clr}}[[Category:INI_Flags]]<br /></includeonly><noinclude>
- {{!}}special=
+{{Doc}}</noinclude>
- {{!}}default=
- {{!}}types=
- {{!}}''games''
- }}
-{| cellpadding="5" class="table_descrow" style="float: right;"
-!Code
-!Game
-!Code
-!Game
-|-
-|td
-|{{td}}
-|co
-|{{cop}}
-|-
-|ra
-|{{ra}}
-|cs
-|{{cs}}
-|-
-|am
-|{{am}}
-|ts
-|{{ts}}
-|-
-|fs
-|{{fs}}
-|ets
-|{{ets}}
-|-
-|ra2
-|{{ra2}}
-|yr
-|{{yr}}
-|-
-|rp
-|{{rp}}
-|gen
-|{{gen}}
-|-
-|zh
-|{{zh}}
-|tw
-|{{tw}}
-|}
-Copy-paste the code above and fill out the parameters as follows:<br>
-; <code>name</code> : The exact name of the flag. Defaults to <code><nowiki>{{PAGENAME}}</nowiki></code>.
-; <code>files</code> : Which file the flag can be used in. [[Template:Ini]], with the <code>catinc</code> parameter set to <code>yes</code>, should be used for consistency. Defaults to <code><nowiki>{{ini|rules|catinc=yes}}</nowiki></code>.
-; <code>values</code> : Possible [[Help:Values|values]] the flag accepts. [[Template:Values]] should be used for consistency.
-; <code>special</code> : Special values, if any. For example, &minus;1{{fnl|1}} is a special value for {{TTL|Ammo}}. This parameter is optional{{fnl|2}}.
-; <code>default</code> : The default value for the flag. This parameter is optional{{fnl|2}}.
-; <code>types</code> : The sections the flag pertains to.
-; <code>''games''</code> : Which games the flag is parsed in. To select a game, add a parameter in the form of <code>''code''=yes</code>. For example, <code>yr=yes</code> indicates that the flag is parsed in {{yr}}. A list of available codes is to the right of this text.
-==Notes==
-{{fn|1|For negative numbers, <code>&amp;minus;</code> should be used for the sign instead of a hyphen.}}
-{{fn|2|If there is no explicit value, do not set this parameter.}}
-</noinclude>

Template:Flag: Difference between revisions

Latest revision as of 20:35, 3 April 2024

Contents

Usage

Parameter Codes for games

Notes

Navigation menu

Template:Flag: Difference between revisions

Latest revision as of 20:35, 3 April 2024

Usage

Parameter Codes for games

Notes

Navigation menu

Search