Editing Template:Convert/doc (section)

==Output manipulation==
===Brackets and separators: ''10 m [33 ft]'' <span class="anchor" id="Brackets and separators"></span>===
Punctuation that distinguishes the two measurements is set by {{para|disp|}}.<br/>
Options are: <code>b</code> <small>(the default)</small>, <code>sqbr</code>, <code>comma</code>, <code>semicolon</code>, <code>or</code>, <code>br</code>, <code>br()</code>, <code>x{{!}}…</code>:
* <code><nowiki>{{convert|10|m|ft|disp=sqbr}}</nowiki></code> → {{convert|10|m|ft|disp=sqbr}}
* <code><nowiki>{{convert|10|m|ft|disp=comma}}</nowiki></code> → {{convert|10|m|ft|disp=comma}}
* <code><nowiki>{{convert|10|m|ft|disp=semicolon}}</nowiki></code> → {{convert|10|m|ft|disp=semicolon}}
* <code><nowiki>{{convert|10|m|ft|disp=or}}</nowiki></code> → {{convert|10|m|ft|disp=or}}
Default behavior, for comparison:
* <code><nowiki>{{convert|10|m|ft}}</nowiki></code> → {{convert|10|m|ft}}

Setting {{para|disp|br}} will force a new line (<code>&lt;br/></code>)
* <code><nowiki>{{convert|10|m|ft|disp=br}}</nowiki></code> → {{convert|10|m|ft|disp=br}}

Also {{para|disp|br()}} will force a new line, and keep the brackets (useful in tables):
* <code><nowiki>{{convert|10|m|ft|disp=br()}}</nowiki></code> → {{convert|10|m|ft|disp=br()}}

Setting {{para|disp|x{{!}}…}} allows any text as separator:
* <code><nowiki>{{convert|10|m|ft|disp=x|_MyText_}}</nowiki></code> → {{convert|10|m|ft|disp=x|_MyText_}} <small>(To display spaces, use <code>&amp;nbsp;</code>)</small>
<!--todo: works for multiple freetexts too! |disp=x|TextA|TextB -->

===<span id="flip"></span>Flipping (reordering) the two measurements: ''{{convert|1|mi|m|order=flip|sigfig=5|abbr=off}}'' ===
Setting {{para|order|flip}} will flip (swap) the two measurements:
* <code><nowiki>{{convert|1|mi|m|order=flip}}</nowiki></code> → {{convert|1|mi|m|order=flip|sigfig=5|abbr=off}}<!-- Extra settings added to enhance the illustration. Don't know if this is ideal way of documenting. DePiep, August 2014. -->
Default behavior, for comparison:
* <code><nowiki>{{convert|1|mi|m}}</nowiki></code> → {{convert|1|mi|m|sigfig=5|abbr=off}}

When converting to multiple units, the effect is:
* <code><nowiki>{{convert|10|km|mi nmi|order=flip}}</nowiki></code> → {{convert|10|km|mi nmi|order=flip|sigfig=5|abbr=off}}
* <code><nowiki>{{convert|10|km|nmi mi|order=flip}}</nowiki></code> → {{convert|10|km|nmi mi|order=flip|sigfig=5|abbr=off}}

===Fixed ordering of output units: ''{{convert|100|C|F C K|abbr=on|order=out}}'' ===
Setting {{para|order|out}} shows the output-units as ordered; the input unit is skipped:
*<code><nowiki>{{convert|100|C|F C K|abbr=on|order=out}}</nowiki></code> &rarr; {{convert|100|C|F C K|abbr=on|order=out}}
*<code><nowiki>{{convert|200|PS|kW hp|0|abbr=on|order=out}}</nowiki></code> → {{convert|200|PS|kW hp|0|abbr=on|order=out}}

''See also: [[Template:Convert#Displaying_parts_of_the_result:_2_(1.5)|§ Displaying parts of the output]]''.

=== Displaying parts of the result: ''{{convert|2|cuyd|m3|abbr=values}}''===
It is possible to display only parts of the conversion result:
<!-- todo: describe effect of order=flip ("out" means 1st or 2nd measurement?) -->
The following examples show how to display only a part of the result.

<!-- table c/p from Help:Convert#Displaying_parts_of_a_conversion -->
:<small>Note: in Convert, ''abbr'' is synonym for ''unit symbol''</small>
{| class="wikitable" style="font-size:85%;"
! Convert !! Returns !! Components
|-
| <code><nowiki>{{convert|2|cuyd|m3}}</nowiki></code>
| {{convert|2|cuyd|m3}}
| all (default conversion)
|-
| <code><nowiki>{{convert|2|cuyd|m3|abbr=on}}</nowiki></code>
| {{convert|2|cuyd|m3|abbr=on}}
| all (default conversion, abbr)
|-
| <!--- return NUMBERS ONLY ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- --->
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>abbr=values}}}}</code>
| {{convert|2|cuyd|m3|abbr=values}}
| numbers only
|-
| <!--- return INPUT ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- --->
|-
| <code><nowiki>{{convert|2|cuyd</nowiki>{{bg|1=yellow|2=<nowiki>|cuyd|disp=out</nowiki>}}}}</code>
| {{convert|2|cuyd|cuyd|disp=out}}
| input value (workaround)
|-
| <code><nowiki>{{convert|2|cuyd</nowiki>{{bg|1=yellow|2=<nowiki>|cuyd|disp=out|abbr=on</nowiki>}}}}</code>
| {{convert|2|cuyd|cuyd|disp=out|abbr=on}}
| input value abbr (workaround)
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit}}}}</code>
| {{convert|2|cuyd|m3|disp=unit}}
| input unit
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit<nowiki>|</nowiki>adj=on}}}}</code>
| {{convert|2|cuyd|m3|disp=unit|adj=on}}
| input unit, adjectival (hyphenated)
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit<nowiki>|</nowiki>adj=on<nowiki>|</nowiki>abbr=on}}}}</code>
| {{convert|2|cuyd|m3|disp=unit|adj=on|abbr=on}}
| input unit, adjectival (abbr so not hyphenated)
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit<nowiki>|</nowiki>abbr=on}}}}</code>
| {{convert|2|cuyd|m3|disp=unit|abbr=on}}
| input unit abbr
|-
| <!--- return OUTPUT ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- ----- --->
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=out}}}}</code>
| {{convert|2|cuyd|m3|disp=out}}
| output value, symbols
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=out<nowiki>|</nowiki>abbr=off}}}}</code> || {{convert|2|cuyd|m3|disp=out|abbr=off}} || output value, names
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=out<nowiki>|</nowiki>adj=on|abbr=off}}}}</code> || {{convert|2|cuyd|m3|disp=out|adj=on|abbr=off}} || output, adjective
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=number}}}}</code> || {{convert|2|cuyd|m3|disp=number}} || output number
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit2}}}}</code> || {{convert|2|cuyd|m3|disp=unit2}} || output unit (abbr by default)
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit2<nowiki>|</nowiki>abbr=off}}}}</code> || {{convert|2|cuyd|m3|disp=unit2|abbr=off}} || output unit (name)
|-
| <code><nowiki>{{convert|2|cuyd|m3</nowiki>{{bg|1=yellow|2=<nowiki>|</nowiki>disp=unit2<nowiki>|</nowiki>abbr=on}}}}</code> || {{convert|2|cuyd|m3|disp=unit2|abbr=on}} || output unit (abbr)
|}

===Display both input name and symbol: ''2 kilopascals [kPa]''===
Setting {{para|abbr|~}} returns both name and  symbol of the first (input) unit:
* <code><nowiki>{{convert|2|kPa|psi|abbr=~}}</nowiki></code> → {{convert|2|kPa|psi|abbr=~}}
* <code><nowiki>A {{convert|2|kPa|psi|abbr=~|adj=on}} pressure</nowiki></code> → {{nowrap|A {{convert|2|kPa|psi|abbr=~|adj=on}} pressure}}