User:Wikid77/Template:Convert show3/doc

{| width=750px style="background:transparent;"
 * The converter Template:Convert_show3 will convert an amount to any 3 output units and display the results with special formatting. To set the rounding precision, the output unit must be specified, or put "0" to default.
 * Usage:    {&#123;convert show3 |100.51432|m|ft|yd|in|r1=1}}
 * {&#123;convert show3 |1,234|km|mi|yd|ft|comma=off}}
 * {&#123;convert show3 |10.5|L|usgal|impgal|impqt|3|x3=exactly}}
 * {&#123;convert show3 |7|km|mi|yd|ft|disp=x|long (|)}} - custom output

There are special options with {convert_show3}, such as r1=2 to round the input amount to 2 decimals, comma=out to show commas only in the output amount, near=25 (or 50) to round to nearest 25, and x1=xx to x8=xx to insert text before/after the unit names.  22 feet (260 inches; 7.3 yards; 6.7 metres) | |   | |   |     | |  |     | |  |      | x0 x1 x2 x3  x4   x5 x6 x7   x8 x9 x10  x11 While parameter x1 inserts text after the first amount, x2 follows the input unit, x3 puts text before the 1st output amount (such as "~"), x4 follows the 1st output amount, and x5 follows the 1st output unit, then x6 puts text before the 2nd output amount ("~"), x7 follows the 2nd output amount, and x8 follows the 2nd output unit. then x9 puts text before the 3rd output amount, x10 follows the 3rd output amount, and x11 follows the 3rd output unit.

The template allows the same parameters as Template:Convert, and so it allows abbreviation abbr=in or abbr=out or abbr=off, wikilinks lk=in or lk=out, and adjective mode adj=on or adj=mid. The separator can also be a semicolon: disp=semi, disp=or, disp=comma, disp=x (customized), disp=sqbr (square brackets), disp=b (default as parentheses), disp=2 (or disp=out) and disp=# (or disp=number).

Examples
The examples show various options of conversions:
 * {&#123;convert show3 |89|km|mi|yd|league|comma=off}} &rarr;
 * {&#123;convert show3 |950|km|mi|yd|ft|abbr=~}}    &rarr;
 * {&#123;convert show3 |3.1415926|km|mi|yd|ft|r1=2}}&rarr;
 * {&#123;convert show3 |9,564|km|mi|yd|ft|comma=out}}     &rarr;
 * {&#123;convert show3 |9,564|km|mi|yd|ft|lk=in|near=5}}    &rarr;
 * {&#123;convert show3 |9,564|km|mi|yd|ft|lk=out|near=50}} &rarr;
 * {&#123;convert show3 |10.5|L|usgal|impgal|impqt|4|x3=exactly}} &rarr;

Display types: disp=comma, disp=semi, disp=or, disp=out, disp=number, disp=x and disp=b. The numeric results are identical to using Template:Convert to show numerals instead of words.

Common problems
Note the name of this template is "convert_show3" and omitting the suffix "show3" will not show special formatting. Also, putting "show3" as parameter 1 will cause the number to be treated as a template name "Convert/ " such as {&#123;convert|show3|34|km}} will show "Error in convert: Value "show3" must be a number".

The amount is followed by a unit-code (such as "|m") as the 2nd parameter. The output unit-code can be "0" as the 3rd parameter, to allow the default output unit to be triggered, while setting parameter 6 to a rounding precision (such as "|3") or use r=3 to set the rounding level.