Template:Campaignbox/doc: Difference between revisions

Jump to navigation Jump to search
imported>Magicpiano
(update to cover all parameters the template uses)
imported>SWinxy
m (add redirect)
 
(28 intermediate revisions by 18 users not shown)
Line 1: Line 1:
{{#ifeq:{{{noheader|}}}|yes||{{Documentation subpage}}
{{#ifeq:{{{noheader|}}}|yes |
==Usage==
| {{Documentation subpage}}
{{Template display|nomobile}}
{{Template redirect|Campaign}}
{{Navbox visibility}}
== Usage ==
}}
}}
{{#switch:{{ARTICLESPACE}}
{{#switch:{{ARTICLESPACE}}
|Wikipedia=
| Wikipedia =
==== Campaignboxes ====
 
|#default=
====Campaignboxes====
=== Campaignboxes ===
| #default =
 
===Campaignboxes===
}}
}}
One common type of navigational template is the campaignbox template, which provides quick navigation among the battles in a [[military campaign|campaign]], [[theater (warfare)|theatre]], or war (or, more rarely, among several campaigns or wars).
One common type of navigational template in articles concerning conflicts, wars and related topics is the '''campaignbox''' template, intended to provide context and convenient navigation among articles on the [[battles]] in a [[Military campaign|campaign]], [[Front (military)|front]], [[Theater (warfare)|theater]] or [[war]] (or, more rarely, among several campaigns or wars).
 
<div style="float:right;width:26.7em;margin-bottom:1.0em;">
<div style="float: right; width: 320px; margin-bottom: 1em;">{{Campaignbox Second Punic War}}
{{Campaignbox Second Punic War}}
{{Campaignbox Punic Wars}}</div>
{{Campaignbox Punic Wars}}
The campaignbox should generally be included directly after the infobox template (or in its campaignbox parameter, if {{tl|infobox military conflict}} is used), if one is present:
</div>


<div style="width: 300px; background: #ddd; border: 1px solid black; padding: 0.5em 1em;"><pre>
If the article includes an [[Help:Infobox|infobox]], the campaignbox/es are usually placed immediately after it (i.e. just below it). If available, as with infoboxes such as {{tl|Infobox military conflict}}, use the infobox's {{para|campaignbox}} parameter:
{{infobox military conflict
<div style="width:25.0em;border:1px solid black;background:#ddd;padding:0.5em 1.0em;">
<pre>
{{Infobox military conflict
...
...
}}
}}
{{campaignbox XXXX}}
{{Campaignbox XXXX}}
 
</pre>or<pre>
{{infobox military conflict
{{Infobox military conflict
...
...
|campaignbox={{campaignbox XXXX}}
| campaignbox = {{campaignbox XXXX}}
}}
}}
</pre></div>
</pre></div>


Articles may include multiple campaignboxes (which are typically stacked following the infobox). The most common scenario occurs when two levels of campaignboxes are present; for example, an article about a battle can include both a campaignbox listing the battle itself and an "enclosing" campaignbox listing the campaign, theater, or war during which the battle took place.  Similarly, an article about a war can include both a campaignbox listing the war (among a series of wars) and a campaignbox for the war itself, listing the battles that took place during it.
Articles may include multiple campaignboxes; typically, these are stacked under the infobox. The most common scenario occurs when two levels of campaignboxes are present&nbsp;for example, an article about a battle can include both a campaignbox listing the battle itself and an "enclosing" campaignbox listing the campaign, theater or war during which the battle took place.  Similarly, an article about a war can include both a campaignbox listing the war (among a series of wars) and a campaignbox for the war itself, listing the battles that took place during it.


; Creating campaignboxes
=== Creating campaignboxes ===
Existing campaignboxes may be viewed through the [[:Category:Campaignbox templates|automatically generated category]].  If a new one is necessary, it should be named ''Template:Campaignbox XXXX'', where XXXX is the name of the campaign (or a shortened form of it), and should use '''{{tl|campaign}}''', as shown below:


<div style="width: 200px; background: #ddd; border: 1px solid black; padding: 0.5em 1em;"><pre>
Existing campaignboxes may be viewed through the [[:Category:Campaignbox templates|Campaignbox template category]] to which campaignboxes are added automatically.  If a new campaignbox becomes necessary, it should be named ''Template:Campaignbox XXXX'' (where XXXX is the (shortened) name of the campaign) and should use {{tlf|Campaignbox}} thus:
{{campaign
<div style="width:16.7em;border:1px solid black;background:#ddd;padding:0.5em 1.0em;">
| name   =  
<pre>
| title   =  
{{Campaignbox
| name =  
| title =  
| battles =  
| battles =  
| notes   =  
| notes =  
}}
}}
</pre></div>
</pre>
</div>


; name: The actual name of the created template (i.e. "Campaignbox XXX"); this can be produced by using <code><nowiki>{{subst:PAGENAME}}</nowiki></code>.
==== Parameters ====
; title: The name of the campaign or war, which should be linked to an article about the campaign if one exists. Dates should not be indicated unless needed for clarity.  Note that long links may cause alignment problems; see [[WP:MILMOS#NAVPROBLEMS|the troubleshooting guide]] for a workaround.
; ''name''    : The name by which Wikipedia refers to the template, i.e. "Template:Campaignbox XXXX". This can be produced by using <code><nowiki>{{subst:PAGENAME}}</nowiki></code>.
; battles: A chronological list of battles and operations in the campaign, linked as <code><nowiki>[[Battle of YYYY|YYYY]]</nowiki></code>. Assigning <code>bodyclass=hlist</code> or <code>listclass=hlist</code> provides an provides a convenient and accessible method for separating the items; just use standard <tt>*</tt> bulleted list format.
; ''title''  : The name of the campaign or war, which, if an article about the campaign or war exists, should link to it. Dates should not be indicated unless needed for clarity.  Note that long links may cause alignment problems; see [[WP:MILMOS#NAVPROBLEMS|the troubleshooting guide]] for more information.
; notes: (''optional'') Any needed explanatory notes for the list of operations; this field should be used sparingly.
; ''battles'' : A chronological list of battles and operations in the campaign, linked as <code><nowiki>[[Battle of YYYY|YYYY]]</nowiki></code>. A convenient and accessible way to separate the items in the list is to add <code>| listclass = hlist</code> and then use the standard <kbd>*</kbd> (asterisk)-based [[Help:List|listing format]].
; raw_name: (''optional'', ''deprecated'') This parameter is present for backward compatibility, and overrides the use of the name and title in determining the template name. In creating a new campaignbox, both title and name should be specified, and this parameter should be omitted.
; ''notes''  : (optional) Any explanatory notes needed to clarify the list. This option should be used sparingly.
; (''raw_name'') : (optional; deprecated) This parameter overrides the use of the title in determining the template name and exists for the sake of backward compatibility. When creating a new campaignbox, both title and name should be specified as above and this parameter omitted.


The following optional parameters are passed on to {{tl|Military navigation}} or {{tl|navbox}}, and affect the styling of the template. See their documentation pages for further details:
The following optional parameters are passed on to the templates {{tl|Military navigation}} or {{tl|Navbox}} used to create campaignboxes and so can affect their styling. See these two templates' documentation pages for further details.
; state: whether the box is fully visible or not
; ''state'' : To set whether the campaignbox appears fully visible or collapsed (to titlebar only) when it is first presented by a page.
; bodyclass: CSS style for the box body
; ''bodyclass'' : CSS styling to affect the whole template.
; listclass: CSS style for the box list
; ''listclass'' : CSS styling to affect the list of battles, operations, etc. (e.g. to affect {{para|battles}}).


The use of special formatting (such as bolding or changes in font size) in the list of battles—particularly to mark battles as "important"—is generally discouraged; while there are a ''few'' cases where such approaches may be both helpful to the reader and sufficiently well-sourced that they do not constitute original research, they are both unnecessary and confusing in most circumstances.  Similarly, dividing the list of battles into multiple blocks by inserting heading-like separations is not recommended in the average case; if such a division is needed, it is typically best accomplished by splitting the template into multiple campaignboxes.<noinclude>[[Category:WikiProject Military history template instructions|Campaignbox]]</noinclude>
The use of special formatting (such as bolding or changes in font size) in the list of battles{{spaced ndash}}particularly to mark battles as "important"{{spaced ndash}}is generally discouraged; while there are a ''few'' cases where such approaches may be both helpful to the reader and sufficiently well-sourced that they do not constitute original research, they are usually both unnecessary and potentially confusing.  Similarly, dividing the list of battles into multiple blocks by inserting heading-like separations should be exceptional; if such a division is felt to be needed, a better solution may be to split the one campaignbox into two or more.<noinclude>


<includeonly>{{#ifeq:{{{noheader|}}}|yes||
[[Category:WikiProject Military history template instructions|Campaignbox]]
</noinclude><includeonly>{{Sandbox other||
[[Category:Campaignbox templates| ]]
{{#ifeq:{{{noheader|}}}|yes | |
[[Category:Navigational box wrapper templates]]
[[Category:Navigational box wrapper templates]]
[[Category:Military navigational boxes|Campaignbox]]
[[Category:Military navigational boxes|Campaignbox]]
 
[[Category:Templates that add a category]]
[[ar:قالب:صندوق حملة]]
}}}}</includeonly>
[[da:Skabelon:Kampagneboks]]
[[es:Plantilla:Ficha de campaña]]
[[fr:Modèle:Campagne militaire]]
[[ja:Template:Campaign]]
[[ca:Plantilla:VPHISMILCAT Campanya]]
[[pt:Predefinição:Campaign]]
[[sv:Mall:Kampanj]]
[[th:แม่แบบ:การทัพ]]
[[vi:Bản mẫu:Các trận đánh]]
[[uk:шаблон:Військова кампанія]]
 
}}
[[Category:Exclude in print]]
</includeonly>

Latest revision as of 18:50, 3 August 2022

Template:Template display Template:Template redirect Template:Navbox visibility

Usage

Campaignboxes

One common type of navigational template in articles concerning conflicts, wars and related topics is the campaignbox template, intended to provide context and convenient navigation among articles on the battles in a campaign, front, theater or war (or, more rarely, among several campaigns or wars).

If the article includes an infobox, the campaignbox/es are usually placed immediately after it (i.e. just below it). If available, as with infoboxes such as {{Infobox military conflict}}, use the infobox's |campaignbox= parameter:

{{Infobox military conflict
...
}}
{{Campaignbox XXXX}}
or

{{Infobox military conflict ... | campaignbox = {{campaignbox XXXX}} }}

Articles may include multiple campaignboxes; typically, these are stacked under the infobox. The most common scenario occurs when two levels of campaignboxes are present – for example, an article about a battle can include both a campaignbox listing the battle itself and an "enclosing" campaignbox listing the campaign, theater or war during which the battle took place. Similarly, an article about a war can include both a campaignbox listing the war (among a series of wars) and a campaignbox for the war itself, listing the battles that took place during it.

Creating campaignboxes

Existing campaignboxes may be viewed through the Campaignbox template category to which campaignboxes are added automatically. If a new campaignbox becomes necessary, it should be named Template:Campaignbox XXXX (where XXXX is the (shortened) name of the campaign) and should use {{Campaignbox}} thus:

{{Campaignbox
| name = 
| title = 
| battles = 
| notes = 
}}

Parameters

name
The name by which Wikipedia refers to the template, i.e. "Template:Campaignbox XXXX". This can be produced by using {{subst:PAGENAME}}.
title
The name of the campaign or war, which, if an article about the campaign or war exists, should link to it. Dates should not be indicated unless needed for clarity. Note that long links may cause alignment problems; see the troubleshooting guide for more information.
battles
A chronological list of battles and operations in the campaign, linked as [[Battle of YYYY|YYYY]]. A convenient and accessible way to separate the items in the list is to add | listclass = hlist and then use the standard * (asterisk)-based listing format.
notes
(optional) Any explanatory notes needed to clarify the list. This option should be used sparingly.
(raw_name)
(optional; deprecated) This parameter overrides the use of the title in determining the template name and exists for the sake of backward compatibility. When creating a new campaignbox, both title and name should be specified as above and this parameter omitted.

The following optional parameters are passed on to the templates {{Military navigation}} or {{Navbox}} used to create campaignboxes and so can affect their styling. See these two templates' documentation pages for further details.

state
To set whether the campaignbox appears fully visible or collapsed (to titlebar only) when it is first presented by a page.
bodyclass
CSS styling to affect the whole template.
listclass
CSS styling to affect the list of battles, operations, etc. (e.g. to affect |battles=).

The use of special formatting (such as bolding or changes in font size) in the list of battles – particularly to mark battles as "important" – is generally discouraged; while there are a few cases where such approaches may be both helpful to the reader and sufficiently well-sourced that they do not constitute original research, they are usually both unnecessary and potentially confusing. Similarly, dividing the list of battles into multiple blocks by inserting heading-like separations should be exceptional; if such a division is felt to be needed, a better solution may be to split the one campaignbox into two or more.