View source for Template:Infobox military conflict/doc

{{Documentation subpage}}

==Usage==
{{Infobox military conflict
| conflict    = Battle of Lützen
| partof      = the [[Thirty Years' War]]
| image       = [[File:Battle of Lutzen.jpg|300px|Battle of Lutzen]]
| caption     = The '' '''Battle of Lützen''' '' by [[Carl Wahlbom]] shows the death of King [[Gustavus Adolphus]] on 16 November 1632.
| date        = 6 November ([[Old Style and New Style dates|O.S.]]) or 16 November ([[Old Style and New Style dates|N.S.]]), 1632
| place       = Near [[Lützen]], southwest of [[Leipzig]]<br>(present-day [[Germany]])
| coordinates = {{coord|51|15|N|12|08|E|region:DE_type:city}}
| result      = Swedish [[Pyrrhic victory]]
| combatant1  = {{flagicon|Sweden|1562}} [[Swedish Empire|Sweden]]<br>[[Protestant Union]] 
| combatant2  = {{flag|Holy Roman Empire}}<br/>
*[[File:Catholic League (Germany).svg|22px]] [[Catholic League (German)|Catholic League]]
| commander1  = {{flagicon|Sweden|1562}} [[Gustavus Adolphus]]{{KIA}}<br/>
*[[Dodo zu Innhausen und Knyphausen|Dodo von Knyphausen]]
{{Flagicon|Electorate of Saxony}} [[Bernhard of Saxe-Weimar]]<br>
{{flagicon|Sweden|1562}} [[Robert Munro, 18th Baron of Foulis]]
| commander2  = {{flagicon|Holy Roman Empire}} [[Albrecht von Wallenstein]]<br/>
*[[Heinrich Holk]]
{{flagicon|Holy Roman Empire}} [[Gottfried zu Pappenheim|Count Gottfried zu Pappenheim]]{{DOW}}
| strength1   = 12,800 infantry<br>6,200 cavalry<br>60 guns
| strength2   = 10,000 infantry<br>7,000 cavalry, plus 3,000 infantry and 2,000 cavalry on arrival<br>24 guns
| casualties1 = 3,400 dead and 1,600 wounded or missing
| casualties2 = Probably about the same as Swedish casualties
}}

A military conflict infobox (sometimes referred to as a warbox) may be used to summarize information about a particular military conflict (a battle, campaign, war, or group of related wars) in a standard manner.  

The infobox should be added using the {{tl|infobox military conflict}} template, as shown below:

<div style="background:#dddddd;border: 1px solid black;padding:0.5em  1em 0.5em 1em"><pre>
{{Infobox military conflict
| conflict    = 
| partof      = 
| image       = 
| caption     = 
| date        = 
| place       = 
| coordinates = 
| map_type    = 
| map_relief  = 
| latitude    = 
| longitude   = 
| map_size    = 
| map_marksize = 
| map_caption = 
| map_label   = 
| result      = 
| status      = 
| combatants_header = 
| combatant1  = {{flagicon image|Flag.png}} [[Country]]<br />etc.
| combatant2  = 
| combatant3  = 
| commander1  = 
| commander2  = 
| commander3  = 
| units1      = 
| units2      = 
| units3      = 
| strength1   = 
| strength2   = 
| strength3   = 
| casualties1 = 
| casualties2 = 
| casualties3 = 
| notes       = 
| campaignbox = 
}}
</pre></div>

===Parameters===
* '''conflict''' – the name of the conflict being described (e.g. "Battle of Lützen" or "World War I").
* '''partof''' – ''optional'' – the larger conflict containing the event described in the article.  For battles or campaigns, this should be the war during which the event takes place; for particularly large wars, this may include a theatre (e.g. "the Eastern Front of World War II").  For wars, the parameter may be used to link to a larger group of wars (e.g. the [[Italian War of 1521–26]] to the [[Italian Wars]]).  It may be necessary to insert "the" before the name of the war for proper grammar.
* '''image''' – ''optional'' – an image for the warbox.  The image must be given in the form <nowiki>[[File:Example.jpg|300px|alt=Example alt text]]</nowiki>; in particular, the ''thumb'' attribute must '''not''' be selected.
* '''caption''' – ''optional'' – the text to be placed below the image.  
* '''date''' – ''optional'' – the date of the conflict described.  Convention is to give the actual date for battles and the years for wars, but this does not always apply.
* '''place''' – the location of the conflict.  For conflicts covering a wide area, a general description (e.g. "[[France]]", or "[[Europe]]", or "Worldwide") may be used.
* '''coordinates''' &ndash; ''optional'' &ndash; the location of the structure, given as a coordinate pair by using {{tl|coord}} with ''display=inline,title''.
* '''map_type''' &ndash; ''optional'' &ndash; the base map to be used for the location map, e.g. "Scotland"; see {{tl|location map}} for more details.
* '''map_relief''' &ndash; ''optional'' &ndash; "yes" if the location map is a relief map; see {{tl|location map}} for more details.
* '''latitude''' &ndash; ''optional'' &ndash; latitude for placing the marker on the location map, e.g. "56.81".
* '''longitude''' &ndash; ''optional'' &ndash; longitude for placing the marker on the location map, e.g. "-2.68".
* '''map_size''' &ndash; ''optional'' &ndash; width of the location map in pixels (px), e.g. "150"; defaults to: "220".  
* '''map_marksize''' &ndash; ''optional'' &ndash; width of the location map marker in pixels (px), e.g. "10"; defaults to: "8".  
* '''map_caption''' &ndash; ''optional'' &ndash; caption displayed below the location map; defaults to "Location within {{{map_type}}}", e.g. "Location within Scotland".
* '''map_label''' &ndash; ''optional'' &ndash; the label placed next to the marker on the location map.
* '''territory''' – '''Not to be used, as it breaks the template!'''
* '''result''' – ''optional'' – this parameter may use one of several standard terms: "X victory", "Decisive X victory" or "Inconclusive". The choice of term should reflect what the sources say. In cases where the standard terms do not accurately describe the outcome, a link to the section of the article where the result is discussed in detail (such as "See the 'Aftermath' section") should be used instead of introducing non-standard terms like "marginal" or "tactical" or contradictory statements like "decisive tactical victory but strategic defeat". It is better to omit this parameter altogether than to engage in [[WP:NOR|speculation]] about which side won or by how much.
* '''status''' – ''optional'' – for ongoing conflicts, the current status of the conflict.  This should not be used if a final result (above) is provided.
* '''combatants_header''' – ''optional'' – sets the header text for the combatants section. Default is "Belligerents".
* '''combatant1'''/'''combatant2'''/'''combatant3''' – ''optional'' – the parties participating in the conflict.  This is most commonly the countries whose forces took part in the conflict; however, larger groups (such as alliances or international organizations) or smaller ones (such as particular units, formations, or groups) may be indicated if doing so improves reader understanding.  When there is a large number of participants, it may be better to list only the three or four major groups on each side of the conflict, and to describe the rest in the body of the article.  The '''combatant3''' field may be used if a conflict has three distinct "sides", and should be left blank on other articles.  Combatants should be listed in order of importance to the conflict, be it in terms of military contribution, political clout, or a recognized chain of command.  If differing metrics can support alternative lists, then ordering is left to the editors of the particular article.
** '''combatant1a'''/'''combatant2a'''/'''combatant3a''' – ''optional'' – in cases where the parties significantly changed over the course of the conflict, these subsidiary fields may be used to provide additional rows for the '''combatant''N''''' fields (above).
** '''combatant1b'''/'''combatant2b'''/'''combatant3b''' – ''optional'' – additional row, as above.
** '''combatant1c'''/'''combatant2c'''/'''combatant3c''' – ''optional'' – additional row, as above. 
** '''combatant1d'''/'''combatant2d'''/'''combatant3d''' – ''optional'' – additional row, as above.
* '''commander1'''/'''commander2'''/'''commander3''' – ''optional'' – the commanders of the military forces involved.  For battles, this should include military commanders (and other officers as necessary).  For wars, only prominent or notable leaders  should be listed, with an upper limit of about seven per combatant column recommended.  Ranks and position titles should be omitted.  The {{tl|KIA}} and {{tl|POW}} templates may be included immediately after the names of commanders who were killed in action or surrendered and were taken prisoner, respectively.  The '''commander3''' field can only be used if the '''combatant3''' field is set.  
* '''units1'''/'''units2'''/'''units3''' – ''optional'' – the units or formations involved.  If a large number of distinct formations is present, it may be better to reference an order of battle in the body of the article than to include the entire list in this field.  The '''units3''' field can only be used if the '''combatant3''' field is set.
* '''strength1'''/'''strength2''' – ''optional'' – the numerical strength of the units involved.
* '''strength3''' – ''optional'' – if '''combatant3''' is set, this is a third strength field identical to the two above; if it is '''''not''''' set, this is an alternate combined field for use where only the total participation in a conflict is known.
* '''casualties1'''/'''casualties2''' – ''optional'' – casualties suffered, including dead, wounded, missing, captured, and civilian deaths. Terms such as "dead" (or "killed"), "wounded", or "captured" should be used in place of abbreviations such as "KIA" or "POW". 
* '''casualties3''' – ''optional'' – if '''combatant3''' is set, this is a third casualty field identical to the two above; if it is '''''not''''' set, this is an alternate combined field for use where only the total casualties of a conflict are known, or where civilian casualties cannot be directly attributed to either side.
* '''notes''' – ''optional'' – optional field for further notes; this should only be used in exceptional circumstances.
* '''campaignbox''' – ''optional'' – optional field for appending a [http://en.wikipedia.org/wiki/WP:CAMPAIGN campaignbox template] to the bottom of the infobox, which allows both boxes to float as a single element (useful if there are subsequent left floating images, which would otherwise not be able to float above the campaign box); the template must be specified in the format <nowiki>{{Campaignbox XYZ}}</nowiki>.