View source for Template:Hands/doc

{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
A '''[[Hand (unit)|hand]]''' is a unit of length used to measure the height of horses and ponies. One hand is four inches, and a value of '12.3&nbsp;hands' represents {{nowrap|12 hands + 3 inches}} (51 inches). '''This template converts hands''' into the equivalent heights in inches and centimetres.

'''Note''': with hands, any fractional part (numbers and vulgar fractions after the period) are inches, not a decimal fraction of a hand. Hence {{nowrap|'14.2 hands'}} means {{nowrap|{{xt|14&nbsp;hands, 2&nbsp;inches}}}}, not {{nowrap|{{!xt|1={{frac|14|2|10}} hands}}}}.

==Usage==
Basic usage:
: <nowiki>{{hands|14.2}}</nowiki> &rarr; {{hands|14.2}}

The optional parameters include:{{para|abbr|on}} to show "h" (or {{para|abbr|hh}} to show "hh"), {{para|r|2}} to round inches and cm to 2 [[decimal places]], {{para|rinch|2}} to round the inches only, or {{para|rcm|2}} to round the centimeters only, {{para|lk|off}} to unlink the hands unit.

{| class="wikitable"
! Input !! Output
|-
| <nowiki>{{hands|14.2}}</nowiki> || {{hands|14.2}}
|-
| <nowiki>{{hands|14.1+3/4}}</nowiki> || {{hands|14.1+3/4}}
|-
| <nowiki>{{hands|15.3|lk=off}}</nowiki> || {{hands|15.3|lk=off}}
|-
| <nowiki>{{hands|15.3|abbr=h}}</nowiki> || {{hands|15.3|abbr=h}}
|-
| <nowiki>{{hands|15.3|abbr=hh}}</nowiki> || {{hands|15.3|abbr=hh}}
|-
| <nowiki>{{hands|14.1+1/2}}</nowiki> || {{hands|14.1+1/2}}
|-
| <nowiki>{{hands|14.1+1/2|r=0}}</nowiki> || {{hands|14.1+1/2|r=0}}
|-
| <nowiki>{{hands|14.1+1/2|r=1}}</nowiki> || {{hands|14.1+1/2|r=1}}
|-
| <nowiki>{{hands|14.1+1/2|r=2}}</nowiki> || {{hands|14.1+1/2|r=2}}
|-
| <nowiki>{{hands|14.1+1/2|rinch=0}}</nowiki> || {{hands|14.1+1/2|rinch=0}}
|-
| <nowiki>{{hands|14.1+1/2|rcm=2}}</nowiki> || {{hands|14.1+1/2|rcm=2}}
|-
| <nowiki>{{hands|15.1|-|16.3}}</nowiki> || {{hands|15.1|-|16.3}}
|-
| <nowiki>{{hands|14.2|to|16.1}}</nowiki> || {{hands|14.2|to|16.1}}
|-
| <nowiki>{{hands|14.2|any text here|16.1}}</nowiki> || {{hands|14.2|any text here|16.1}}
|}
If the 'range' format is used, the text in the second parameter (such as "to") can take any text you wish to use, such as 'and', 'to' or <nowiki>&ndash;</nowiki>. When the range has a hyphen/dash or comma, then some spaces are omitted.

Hands can also be converted using {{tl|convert}}, for example
* <nowiki>{{convert|15.3|hands}}</nowiki> &rarr; {{convert|15.3|hands}}; or
* <nowiki>{{convert|15.3|hands|order=flip}}</nowiki> &rarr; {{convert|15.3|hands|order=flip}}
This could be useful when <nowiki>{{convert}}</nowiki> units or options are needed that are not in <nowiki>{{hands}}</nowiki>, such as the illustrated {{para|order|flip}}.

===Inverse===
To convert other measurements ''into'' hands, use {{tl|convert}}:
*Convert from cm: <nowiki>{{convert|148|to|152|cm|hand in|2}}</nowiki> &rarr; {{convert|148|to|152|cm|hand in|2}}
*Convert from inches: <nowiki>{{convert|60|to|62|in|hand cm|2}}</nowiki> &rarr; {{convert|60|to|62|in|hand cm|2}}

Using a full three-way conversion (hands, inches and centimeters) in all cases is strongly recommended, regardless of which measurement is given first. 

Singular use (not recommended):
*Convert from cm: <nowiki>{{convert|147|cm|hand in|2}}</nowiki> &rarr; {{convert|147|cm|hand in|2}}
*Convert from inches: <nowiki>{{convert|60|in|hand cm|1}}</nowiki> &rarr; {{convert|60|in|hand cm|1}}
<includeonly>{{Sandbox other||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:Horse templates]]
[[Category:Convert-like templates|Hands]]
[[Category:Conversion templates|Hands]]

}}</includeonly>