Template:Convert/doc: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Drew R. Smith
imported>Caesar Schinas
(move lists of conversions to subpage)
Line 1: Line 1:
{{TOC|right}}
This template is used in articles to easily convert one unit to another. This template will always be under construction, as we can’t possibly include conversions ‘’from’’ every possible unit ‘’to’’ every possible unit. However, whenever a conversion isn’t supported, [[User:Drew R. Smith|I]] or any of the other users who have worked on this template would be happy to add conversions when brought to our attention.
This template is used in articles to easily convert one unit to another. This template will always be under construction, as we can’t possibly include conversions ‘’from’’ every possible unit ‘’to’’ every possible unit. However, whenever a conversion isn’t supported, [[User:Drew R. Smith|I]] or any of the other users who have worked on this template would be happy to add conversions when brought to our attention.
The goal of this template is to make [[Citizendium]] accessable to all readers regardless of nationality. Instead of only showing [[SI units|SI/Metric units]] or [[Imperial units]], {{tl|convert}} automatically converts a number from the specified unit to another unit and displays it as "'''Metric (Imperial)'''" or "'''Imperial (Metric)'''", depending on which unit was converted from.
The goal of this template is to make the ''Citizendium'' accessible to all readers regardless of nationality. Instead of only showing [[SI units|SI/Metric units]] or [[Imperial units]], {{tl|convert}} automatically converts a number from the specified unit to another unit and displays it as "'''Metric (Imperial)'''" or "'''Imperial (Metric)'''", depending on which unit was converted from.


== Usage ==
== Usage ==
Line 10: Line 11:


==Supported Conversions==
==Supported Conversions==
<div style="height: 400px; overflow: auto; padding: 3px; border:1px solid #AAAAAA; reflist4" >
<small>Transcluded from [[Template:Convert/doc/conversions]] ({{plainlink|{{fullurl:Template:Convert/doc/conversions|action=edit}} edit}})</small>
===Millimeters to...===
<div style="height:400px; overflow:auto; padding:0.5em; border:1px solid #AAAAAA;" >
====Inches====
{{Convert/doc/conversions}}
:<nowiki>{{Convert|10|mm|in}}</nowiki> Produces {{Convert|10|mm|in}}.
::Supported parameters include mm, millimetre, millimetres, millimeter, millimeters, in, inch, and inches.
====Feet====
:<nowiki>{{Convert|10|mm|ft}}</nowiki> Produces {{Convert|10|mm|ft}}.
::Supported parameters include mm, millimetre, millimetres, millimeter, millimeters, ft, foot, and feet.
 
===Centimeters to...===
====Inches====
:<nowiki>{{Convert|10|cm|in}}</nowiki> Produces {{Convert|10|cm|in}}.
::Supported parameters include cm, centimetre, centimetres, centimeter, centimeters, in, inch, and inches.
====Feet====
:<nowiki>{{Convert|10|cm|ft}}</nowiki> Produces {{Convert|10|cm|ft}}.
::Supported parameters include cm, centimetre, centimetres, centimeter, centimeters, ft, foot, and feet.
===Decimeters to...===
====Inches====
:<nowiki>{{Convert|10|dm|in}}</nowiki> Produces {{Convert|10|dm|in}}.
::Supported parameters include dm, decimetre, decimetres, decimeter, decimeters, in, inch, and inches.
====Feet====
:<nowiki>{{Convert|10|dm|ft}}</nowiki> Produces {{Convert|10|dm|ft}}.
::Supported parameters include dm, decimetre, decimetres, decimeter, decimeters, ft, foot, and feet.
===Meters to...===
====Inches====
:<nowiki>{{Convert|10|m|in}}</nowiki> Produces {{Convert|10|m|in}}.
::Supported parameters include m, metre, metres, meter, meters, in, inch, and inches.
====Feet====
:<nowiki>{{Convert|10|m|ft}}</nowiki> Produces {{Convert|10|m|ft}}.
::Supported parameters include m, metre, metres, meter, meters, ft, foot, and feet.
====Yards====
:<nowiki>{{Convert|10|m|yd}}</nowiki> Produces {{Convert|10|m|yd}}.
::Supported parameters include m, metre, metres, meter, meters, yd, yard, and yards.
====Miles====
:<nowiki>{{Convert|10|m|mi}}</nowiki> Produces {{Convert|10|m|mi}}.
::Supported parameters include m, metre, metres, meter, meters, mi, mile, miles.
====Nautical Miles====
:<nowiki>{{Convert|10|m|nmi}}</nowiki> Produces {{Convert|10|m|nmi}}.
::Supported parameters include m, metre, metres, meter, meters, nmi, nautical mile, nautical miles.
===Kilometers to...===
====Yards====
:<nowiki>{{Convert|10|km|yd}}</nowiki> Produces {{Convert|10|km|yd}}.
::Supported paramaters include km, kilometre, kilometres, kilometer, kilometers, yd, yard, and yards.
====Miles====
:<nowiki>{{Convert|10|km|mi}}</nowiki> Produces {{Convert|10|km|mi}}.
::Supported parameters include km, kilometre, kilometres, kilometer, kilometers, mi, mile, and miles.
====Nautical Miles====
:<nowiki>{{Conver|10|km|nmi}}</nowiki> Produces {{Convert|10|km|nmi}}.
::Supported parameters include km, kilometre, kilometres, kilometer, kilometers, nmi, nautical mile, nautical miles.
 
===Inches to...===
====Millimetres====
:<nowiki>{{Convert|10|in|mm}}</nowiki> Produces {{Convert|10|in|mm}}.
::Supported parameters include in, inch, inches, mm, millimetre, and millimetres.
====Centimetres====
:<nowiki>{{Convert|10|in|cm}}</nowiki> Produces {{Convert|10|in|cm}}.
::Supported parameters include in, inch, inches, cm, centimetre, and centimetres.
====Decimetres====
:<nowiki>{{Convert|10|in|dm}}</nowiki> Produces {{Convert|10|in|dm}}.
::Supported parameters include in, inch, inches, dm, decimetre, and decimetres.
====Metres====
:<nowiki>{{Convert|10|in|m}}</nowiki> Produces {{Convert|10|in|m}}.
::Supported parameters include in, inch, inches, m, metre, and metres.
===Feet to...===
====Millimetres====
:<nowiki>{{Convert|10|ft|mm}}</nowiki> Produces {{Convert|10|ft|mm}}.
::Supported parameters include ft, foot, feet, mm, millimetre, and millimetres.
====Centimetres====
:<nowiki>{{Convert|10|ft|cm}}</nowiki> Produces {{Convert|10|ft|cm}}.
::Supported parameters include ft, foot, feet, cm, centimetre, and centimetres.
====Decimetres====
:<nowiki>{{Convert|10|ft|dm}}</nowiki> Produces {{Convert|10|ft|dm}}.
::Supported parameters include ft, foot, feet, dm, decimetre, and decimetres.
====Metres====
:<nowiki>{{Convert|10|ft|m}}</nowiki> Produces {{Convert|10|ft|m}}.
::Supported parameters include ft, foot, feet, m, metre, and metres.
====Kilometres====
:<nowiki>{{Convert|10|ft|km}}</nowiki> Produces {{Convert|10|ft|km}}.
::Supported parameters include ft, foot, feet, km, kilometre, and kilometres.
===Yards to...===
====Millimetres====
:<nowiki>{{Convert|10|yd|mm}}</nowiki> Produces {{Convert|10|yd|mm}}.
::Supported parameters include yd, yard, yards, mm, millimetre, and millimetres.
====Centimetres====
:<nowiki>{{Convert|10|yd|cm}}</nowiki> Produces {{Convert|10|yd|cm}}.
::Supported parameters include yd, yard, yards, cm, centimetre, and centimetres.
====Decimetres====
:<nowiki>{{Convert|10|yd|dm}}</nowiki> Produces {{Convert|10|yd|dm}}.
::Supported parameters include yd, yard, yards, dm, decimetre, and decimetres.
====Metres====
:<nowiki>{{Convert|10|yd|m}}</nowiki> Produces {{Convert|10|yd|m}}.
::Supported parameters include yd, yard, yards, m, metre, and metres.
====Kilometres====
:<nowiki>{{Convert|10|yd|km}}</nowiki> Produces {{Convert|10|yd|km}}.
::Supported parameters include yd, yard, yards, km, kilometre, and kilometres.
===Miles to...===
====Metres====
:<nowiki>{{Convert|10|mi|m}}</nowiki> Produces {{Convert|10|mi|m}}.
::Supported parameters include mi, mile, miles, m, metre, and metres.
====Kilometres====
:<nowiki>{{Convert|10|mi|km}}</nowiki> Produces {{Convert|10|mi|km}}.
::Supported parameters include mi, mile, miles, km, kilometre, and kilometres.
====Nautical Miles====
:<nowiki>{{Convert|10|mi|nmi}}</nowiki> Produces {{Convert|10|mi|nmi}}.
::Supported parameters include mi, mile, miles, nmi, nautical mile, and nautical miles.
===Nautical Miles to...===
====Metres====
:<nowiki>{{Convert|10|nmi|m}}</nowiki> Produces {{Convert|10|nmi|m}}.
::Supported parameters include nmi, nautical mile, nautical miles, m, metre, and metres.
====Kilometres====
:<nowiki>{{Convert|10|nmi|km}}</nowiki> Produces {{Convert|10|nmi|km}}.
::Supported parameters include nmi, nautical mile, nautical miles, km, kilometre, and kilometres.
====Miles====
:<nowiki>{{Convert|10|nmi|mi}}</nowiki> Produces {{Convert|10|nmi|mi}}.
::Supported parameters include nmi, nautical mile, nautical miles, mi, mile, and miles.
</div>
</div>



Revision as of 00:58, 16 June 2009

This template is used in articles to easily convert one unit to another. This template will always be under construction, as we can’t possibly include conversions ‘’from’’ every possible unit ‘’to’’ every possible unit. However, whenever a conversion isn’t supported, I or any of the other users who have worked on this template would be happy to add conversions when brought to our attention. The goal of this template is to make the Citizendium accessible to all readers regardless of nationality. Instead of only showing SI/Metric units or Imperial units, {{convert}} automatically converts a number from the specified unit to another unit and displays it as "Metric (Imperial)" or "Imperial (Metric)", depending on which unit was converted from.

Usage

The template has four parameters - {{convert|number|from|to|precision}}.

  1. required — The number to convert.
  2. required — The unit to convert from.
  3. required — The unit to convert to.
  4. optional — The precision of the result - either a number of decimal places, or a negative number to specify a number of significant figures. The default is 2.

Supported Conversions

Transcluded from Template:Convert/doc/conversions (edit)

Length Conversions

Metric to Imperial

Inches (in) Feet (ft) Yards (yd) Miles (mi) Nautical Miles (nmi)
Millimetres (mm) Yes Yes No No No
Centimetres (cm) Yes Yes No No No
Decimetres (dm) Yes Yes No No No
Metres (m) Yes Yes Yes Yes Yes
Kilometres (km) No No Yes Yes Yes

Imperial to Metric

Millimetres (mm) Centimetres (cm) Decimetres (dm) Metres (m) Kilometres (km)
Inches (in) Yes Yes Yes Yes No
Feet (ft) Yes Yes Yes Yes Yes
Yards (yd) Yes Yes Yes Yes Yes
Miles (mi) No No No Yes Yes
Nautical Miles (nmi) No No No Yes Yes

Imperial to Imperial

Miles (mi) Nautical Miles (nmi)
Miles (mi) - Yes
Nautical Miles (nmi) Yes -

Weight Conversions

Kilogrammes (kg) Grammes (g) Pounds (lbs) Ounces (oz)
Kilogrammes (kg) - No Yes Yes
Grammes (g) No - Yes Yes
Pounds (lbs) Yes Yes - No
Ounces (oz) Yes Yes No -

Temperature Conversions

Celsius (°C) Kelvin (°K) Fahrenheit (°F) Rankine (°R)
Celsius (°C) - Yes Yes Yes
Kelvin (°K) Yes - Yes No
Fahrenheit (°F) Yes Yes - Yes
Rankine (°R) Yes No Yes -

Rounding

{{Convert}} has an additional parameter that controls roundin. More specifically, it controls how many places after the decimal are displayed. To use this feature, add a value in the fourth parameter. For example {{Convert|10|km|mi|5}} shows up to the fifth decimal place, displaying as 10 km (6.21371 mi).

Examples

{{Convert|547.3|km|mi|0}} hides the decimals, displaying as 547.3 km (340 mi).

{{Convert|547.3|km|mi|1}} shows one decimal, displaying as 547.3 km (340.1 mi)

{{Convert|547.3|km|mi|2}} shows two decimals, displaying as 547.3 km (340.08 mi)

{{Convert|547.3|km|mi|3}} shows three decimals, displaying as 547.3 km (340.076 mi)

{{Convert|547.3|km|mi|10}} shows ten decimals, displaying as 547.3 km (340.0764533816 mi)

Parameters That Need to be Created

Add units of measurement, and their conversion formulas, that still need to be created here