Editing Project:WikiProject Military history/Military navigation

{{template other|{{lua|Module:Military navigation|Module:Navbox|Module:WPMILHIST Infobox style}}}}
=== Navigation templates === 
{{Grand Armee Corps}}
The various [[Wikipedia:Manual of Style/Military history#Navigation templates|navigation templates]] maintained by the Military history WikiProject are all intended to be implemented through a single base template, which combines the project's [[Template:WPMILHIST Infobox style|common template style]] with the [[Template:Navbox|standard navigation box format]].  This is needed primarily to allow multiple such templates to be stacked together—with each other, or with [[Wikipedia:Manual of Style/Military history#Infobox templates|infobox templates]]—to present the appearance of a continuous block; it is also beneficial for providing a consistent appearance to the entire set of articles within our scope.

Any military-related navigational template should be created using the '''{{tl|military navigation}}''' base template, as shown below:

<div style="width: 350px; background: #ddd; border: 1px solid black; padding: 0.5em 1em;">
<pre>
{{Military navigation
| name = 
| raw_name =
| state = 
| style = 
| title = 
| image = 
| imageleft = 
| odd_color = 
| even_color = 
| above = 
| listclass = 

| group1 = 
| list1 = 

| group2 = 
| list2 = 

| group3 = 
| list3 = 
...
| group30 = 
| list30 = 

| below = 
}}
</pre>
</div>

; name : The actual page name (i.e. "XYZ" for [[Template:XYZ]]) of the newly-created template.
:; raw_name : Use instead of "'''name'''" to omit the&nbsp; V · T · E&nbsp; links from the title bar.
; title : The displayed title of the navigation box.
; listclass : ''Optional'' – but typically <code>hlist</code>, to format content as [[WP:HLIST|horizontal lists]]. In the case of hlists in above or below fields, set bodyclass=hlist, instead.
; style : ''Optional'' – an alternative style for the template; this may be set to "''wide''" to produce a full-width box.  The alternative style should be used sparingly; it is intended that the majority of navigational templates will use the default style (in the ''wild'', "wide" has become quite common). The above example template formatted with <code>style=wide</code> is shown below:

{{Military navigation
| name = Grand Armee Corps
| state = uncollapsed
| style = wide
| title = [[Corps]] of the [[Grande Armée]]
| listclass = hlist

| group1 = Regular
| list1 =
* [[I Corps (Grande Armée)   |I]]
* [[II Corps (Grande Armée)  |II]]
* [[III Corps (Grande Armée) |III]]
* [[IV Corps (Grande Armée)  |IV]]
* [[V Corps (Grande Armée)   |V]]
* [[VI Corps (Grande Armée)  |VI]]
* [[VII Corps (Grande Armée) |VII]]
* [[VIII Corps (Grande Armée)|VIII]]
* [[IX Corps (Grande Armée)  |IX]]
* [[X Corps (Grande Armée)   |X]]
* [[XI Corps (Grande Armée)  |XI]]
* [[XII Corps (Grande Armée) |XII]]

| group2 = Cavalry
| list2 =
* [[I Cavalry Corps (Grande Armée)  |I]]
* [[II Cavalry Corps (Grande Armée) |II]]
* [[III Cavalry Corps (Grande Armée)|III]]
* [[IV Cavalry Corps (Grande Armée) |IV]]
* [[V Cavalry Corps (Grande Armée)  |V]]
}}

; state : ''Optional'' – may be set to "''collapsed''" to force the template to render in its closed state by default.
; odd_color'''/'''even_color : ''Optional'' – the stripe colors for alternating list''N'' items to use.  These parameters should be used sparingly; in the absence of a good reason to do otherwise, templates should use the default stripe colors.
; group''N'''''/'''list''N'' : The body of the navigation box, consisting of successive horizontal blocks of content (the '''list''N''''' fields) with optional labels (the corresponding '''group''N''''' fields).  Please see the documentation for {{tl|navbox}} for more details on the different layouts possible.
; above : ''Optional'' – the sub-header of the navigation box; please see the documentation for {{tl|navbox}} for more details on the resulting layout when this is used.
; below : ''Optional'' – the footer of the navigation box; please see the documentation for {{tl|navbox}} for more details on the resulting layout when this is used.
; image : ''Optional'' – an image to be displayed at the right of the box, given in the form <code><nowiki>[[File:Example.jpg|100px]]</nowiki></code>.  This parameter should be used sparingly, and typically only in conjunction with the full-width template style.
; imageleft : ''Optional'' – an image to be displayed at the left of the box, given in the form <code><nowiki>[[File:Example.jpg|100px]]</nowiki></code>.  This parameter should be used sparingly, and typically only in conjunction with the full-width template style.

==== Common problems with navigation templates ====
{{#if:{{{inner_shortcut|}}} |{{{inner_shortcut|}}} }}

There are several known issues with the current navigation template design that editors should be aware of:

; Shifted header wrapping : A long header used in a narrow navigation template may wrap incorrectly, with the second line being indented further than necessary. A workaround is possible by adding a <code><nowiki><br /></nowiki></code> tag between the words where the wrapping is to occur. This should be done to separate link-text to the right of the 'pipe' (<code>|</code>), as follows: <code><nowiki>[[Article title|Article <br /> title]]</nowiki></code>. An alternative method is to use {{tl|allow wrap}} for the link-text as follows: <code><nowiki>[[A very long article title|{{allow wrap|A very long article title}}]]</nowiki></code>, which allows the browser to break as-needed.
; Stretching or overflowed boxes : A very long header formatted as a single link may cause a template to stretch beyond its normal width, or the whole link to extend off too far to the right.  A workaround is possible by breaking the header onto multiple lines, as shown above.<noinclude>
=== Tracking category ===
* {{clc|Pages using military navigation subgroups without wide style}}
[[Category:WikiProject Military history template instructions|Navigation]]
</noinclude>