View source for Template:Ribbon devices/doc

{{Documentation subpage}}
{{High-use}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->

This template will superimpose [[United States military award devices]] onto [[Awards and decorations of the United States military|military award ribbons]].  It currently does [[oak leaf cluster]]s, [[award star]]s, [[service star]]s (up to a numeric value of 24 total awards) as well as the [[Arrowhead device]], [[Valor device]], [[Valor device|Combat V]], [[Fleet Marine Force Combat Operations Insignia]], and [[Operational Distinguishing Device]].  Variables are as follows:

{| class="wikitable"
|-
!Variable
!Accepted values
!Default value
|-
|number
|0–23
|0
|-
|type
|oak, award-star, service-star
|oak
|-
|other_device
|arrowhead, v, nv, fmf, odd
|
|-
| name
|''Name of ribbon image, without the "Image:" prefix or ".svg" suffix''
|
|-
|ribbon
|''Any image, without the "Image:" prefix. Do not specify if {{para|name}} is also specified.''
|
|-
|alt
|''Alt text for ribbon image. The default alt text is derived from {{para|name}} using the lookup table in {{tl|ribbon devices/alt}}.''
|
|-
|width
|106, 80, 60
|106
|}

;Examples

{|
|-
|{{ribbon devices|number=8|type=oak|other_device=v|name=Bronze Star ribbon|width=106}}
|<code><nowiki>{{ribbon devices|number=8|type=oak|other_device=v|name=Bronze Star ribbon|width=106}}</nowiki></code>
|-
|{{ribbon devices|number=6|type=award-star|name=Meritorious Service ribbon|width=106}}
|<code><nowiki>{{ribbon devices|number=6|type=award-star|name=Meritorious Service ribbon|width=106}}</nowiki></code>
|-
|{{ribbon devices|number=7|type=service-star|other_device=arrowhead|name=Asiatic-Pacific Campaign ribbon|width=106}}
|<code><nowiki>{{ribbon devices|number=7|type=service-star|other_device=arrowhead|name=Asiatic-Pacific Campaign ribbon|width=106}}</nowiki></code>
|-
|{{ribbon devices|number=0|other_device=fmf|name=Global War on Terrorism Expeditionary ribbon|width=106}}
|<code><nowiki>{{ribbon devices|number=0|other_device=fmf|name=Global War on Terrorism Expeditionary ribbon|width=106}}</nowiki></code>
|}

=== Subtemplates ===

This template makes use of three subtemplates, which are not intended to be used as standalone templates. They are: {{tl2|ribbon devices/device layout}}, {{tl2|ribbon devices/device}}, and {{tl2|ribbon devices/alt}}. To add a new <code>other_device</code>, modify {{tl2|ribbon devices/device}}. To add alt text for a new ribbon, modify {{tl2|ribbon devices/alt}}.

==See also==
* {{tl|Medal Display}}
* {{tl|Ribbon}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Graphics templates]]
[[Category:Military decorations and medals templates]]
[[Category:United States military templates]]
}}</includeonly>