Template:In to Cm

From Citizendium, the Citizens' Compendium
Jump to: navigation, search
This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and parser functions before editing the template.
If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages.
Remember that you can and should conduct experiments and test improvements in your user space before changing anything here.
This documentation is transcluded from Template:In to Cm/doc (edit | history)


This template is intended to perform inch-to-centimeter conversions. It converts single values, ranges, as well as two- and three-dimensional measurements.

Accepted parameters

Italicized parameters are optional:

  • num, or l (length), or from, or first unnamed parameter is a required parameter, which specifies the number of inches to be converted to centimeters (for single value conversions), or length (for two- and three-dimensional conversions), or start of range (for range conversions). Please do not format this parameter; i.e., use 1234 instead of 1,234.
  • w (width), or to, or second unnamed parameter is a parameter specifying width (for dimensional conversions) or end of range (for range conversions) in inches to be converted to centimeters. Please do not format this parameter; i.e., use 1234 instead of 1,234.
  • h (height) or third unnamed parameter is a parameter specifying height (for three-dimensional conversions) in inches to be converted to centimeters. Please do not format this parameter; i.e., use 1234 instead of 1,234.
  • convtype (conversion type) can take values of either range or dim. Range is only meaningful when two values are supplied for conversion. The default value is dim.
  • abbr can take values of either mos, yes, or no. Mos will show the names of the units (inches, cm); yes will show the abbreviated names of the units (in, cm); and no will show the full names of the units (inches, centimeters). With dimensional conversions, all values will be separated with the "by" preposition when the parameter is set to no, and with the "×" sign when the parameter is set to yes. When the parameter is set to mos, inch values will be separated with the "by" preposition, and the converted values in centimeters—with the "×" sign. The default value is mos.
  • spell can take values of American or Commonwealth and is only meaningful when abbr is set to no. American will use "centimeters", and Commonwealth—"centimetres". The default value is American.
  • precision is the number of decimal digits in the converted value. The default value is 0 for converted values equal or more than 10 and 1 for converted values of less than 10.
  • wiki specifies whether the names of the units should be wikified or not and can take values of either yes or no. The default value is no.

Capitalization of the parameters is unimportant.

Usage and examples

Single value conversion

Usage
{{in to cm | num | abbr | spell | precision | wiki}}
Examples
{{in to cm|1}} → 1 inch (2.5 cm)
Short notation: {{in to cm|1|abbr=yes}} → 1 in (2.5 cm)
Full notation: {{in to cm|num=1|abbr=no|spell=Commonwealth|precision=2|wiki=yes}} → 1 inch (2.54 centimetres)

Range conversions

Usage
{{in to cm | from | to | convtype | abbr | spell | precision | wiki}}
Examples
{{in to cm|10|20|convtype=range}} → 10–20 inches (25–51 cm)
Short notation: {{in to cm|10|20|convtype=range|abbr=yes}} → 10–20 in (25–51 cm)
Full notation: {{in to cm|from=10|to=20|convtype=range|abbr=no|spell=Commonwealth|precision=1|wiki=yes}} → 10–20 inches (25.4–50.8 centimetres)

Two-dimensional conversions

Usage
{{in to cm | l | w | convtype | abbr | spell | precision | wiki}}
Examples
{{in to cm|10|20}} → 10 inches by 20 inches (25 cm × 51 cm)
Short notation: {{in to cm|10|20|abbr=yes}} → 10 in × 20 in (25 cm × 51 cm)
Full notation: {{in to cm|l=10|w=20|convtype=dim|abbr=no|spell=Commonwealth|precision=1|wiki=yes}} → 10 inches by 20 inches (25.4 centimetres by 50.8 centimetres)

Three-dimensional conversions

Usage
{{in to cm | l | w | h | convtype | abbr | spell | precision | wiki}}
Examples
{{in to cm|1|2|3}} → 1 inch by 2 inches by 3 inches (2.5 cm × 5.1 cm × 7.6 cm)
Short notation: {{in to cm|1|2|3|abbr=yes}} → 1 in × 2 in × 3 in (2.5 cm × 5.1 cm × 7.6 cm)
Full notation: {{in to cm|l=1|w=2|h=3|convtype=dim|abbr=no|spell=Commonwealth|precision=2|wiki=yes}} → 1 inch by 2 inches by 3 inches (2.54 centimetres by 5.08 centimetres by 7.62 centimetres)

</noinclude>

See also