View source for Template:Infobox person/length/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Notice|This is for use in templates. For articles, please use {{tl|Convert}}.}}
{{Lua|Module:Person length}}

This template is used to automatically add conversions of length measurements displayed by [[:Category:Infobox templates|infoboxes]], such as:
* {{para|reach}} in {{tlx|Infobox boxer}} and {{tlx|Infobox martial artist}}
* {{para|spike}} and {{para|block}} in {{tlx|Infobox volleyball biography}}

{{Template see also|Infobox person/height|Infobox person/weight}}

== Usage ==

<pre>
{{Infobox
...
| label# = Reach
| data#  = {{#if: {{{reach|}}} | {{Infobox person/length|{{{reach}}}}} }}
...
}}
</pre>

<pre>
{{Infobox
...
| label# = Spike
| data#  = {{#if: {{{spike|}}} | {{Infobox person/length|{{{spike}}}}} }}
| label# = Block
| data#  = {{#if: {{{block|}}} | {{Infobox person/length|{{{block}}}}} }}
...
}}
</pre>

== Examples ==

[[Inch]]es:

* {{Para|reach|1 inch}} &rarr; {{Infobox person/length|1 inch}}
* {{Para|reach|78 inches}} &rarr; {{Infobox person/length|78 inches}}
* {{Para|reach|78 ins}} &rarr; {{Infobox person/length|78 ins}}
* {{Para|reach|78 in.}} &rarr; {{Infobox person/length|78 in.}}
* {{Para|reach|78 in}} &rarr; {{Infobox person/length|78 in}}

[[Centimetre]]s:

* {{Para|reach|1 centimetre}} &rarr; {{Infobox person/length|1 centimetre}}
* {{Para|reach|1 centimeter}} &rarr; {{Infobox person/length|1 centimeter}}
* {{Para|reach|198 centimetres}} &rarr; {{Infobox person/length|198 centimetres}}
* {{Para|reach|198 centimeters}} &rarr; {{Infobox person/length|198 centimeters}}
* {{Para|reach|198 cms}} &rarr; {{Infobox person/length|198 cms}}
* {{Para|reach|198 cm.}} &rarr; {{Infobox person/length|198 cm.}}
* {{Para|reach|198 cm}} &rarr; {{Infobox person/length|198 cm}}

[[Metre]]s:

* {{Para|reach|1 metre}} &rarr; {{Infobox person/length|1 metre}}
* {{Para|reach|1 meter}} &rarr; {{Infobox person/length|1 meter}}
* {{Para|reach|1.98 metres}} &rarr; {{Infobox person/length|1.98 metres}}
* {{Para|reach|1.98 meters}} &rarr; {{Infobox person/length|1.98 meters}}
* {{Para|reach|1.98 ms}} &rarr; {{Infobox person/length|1.98 ms}}
* {{Para|reach|1.98 m.}} &rarr; {{Infobox person/length|1.98 m.}}
* {{Para|reach|1.98 m}} &rarr; {{Infobox person/length|1.98 m}}

[[Non-breaking space]] or missing space after number:

* {{Para|reach|78&amp;nbsp;inches}} &rarr; {{Infobox person/length|78&nbsp;inches}}
* {{Para|reach|198centimetres}} &rarr; {{Infobox person/length|198centimetres}}
* {{Para|reach|1.98metres}} &rarr; {{Infobox person/length|1.98metres}}

Text and/or [[Help:Footnotes|footnotes (references)]] after length:

* {{Para|reach|78 ins (2012)}} &rarr; {{Infobox person/length|78 ins (2012)}}
* {{Para|reach|198 cms<nowiki><ref>citation goes here</ref></nowiki>}} &rarr; {{Infobox person/length|198 cms<ref>citation goes here</ref>}}
* {{Para|reach|1.98 ms (2012)<nowiki><ref>{{cite news|title=title|work=work}}</ref></nowiki>}} &rarr; {{Infobox person/length|1.98 ms (2012)<ref>{{cite news|title=title|work=work}}</ref>}}
: '''Example references'''
<references />

{{tl|Convert}} templates, without and with [[wikilink]]ed unit names:

* {{Para|reach|<nowiki>{{Convert|78|in|cm|0|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|78|in|cm|0|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|78|in|cm|0|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|78|in|cm|0|abbr=off|lk=on}}}}
** {{nowiki template demo|format=inline|prefix=output of convert template:&nbsp;|showcode=no|output=nowiki|code=<nowiki>{{Convert|78|in|cm|0|abbr=off|lk=on}}</nowiki>}}
* {{Para|reach|<nowiki>{{Convert|78|in|m|2|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|78|in|m|2|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|78|in|m|2|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|78|in|m|2|abbr=off|lk=on}}}}
** {{nowiki template demo|format=inline|prefix=output of convert template:&nbsp;|showcode=no|output=nowiki|code=<nowiki>{{Convert|78|in|m|2|abbr=off|lk=on}}</nowiki>}}
* {{Para|reach|<nowiki>{{Convert|198|cm|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|198|cm|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|198|cm|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|198|cm|abbr=off|lk=on}}}}
** {{nowiki template demo|format=inline|prefix=output of convert template:&nbsp;|showcode=no|output=nowiki|code=<nowiki>{{Convert|198|cm|abbr=off|lk=on}}</nowiki>}}
* {{Para|reach|<nowiki>{{Convert|1.98|m|in|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|1.98|m|in|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|1.98|m|in|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|1.98|m|in|abbr=off|lk=on}}}}
** {{nowiki template demo|format=inline|prefix=output of convert template:&nbsp;|showcode=no|output=nowiki|code=<nowiki>{{Convert|1.98|m|in|abbr=off|lk=on}}</nowiki>}}

== Exceptions ==

Does not replace numbers in manually entered conversions, but does replace unit names with abbreviations (examples intentionally show incorrect conversions):

* {{Para|reach|78 inches (191 centimeters)}} &rarr; {{Infobox person/length|78 inches (191 centimeters)}}
* {{Para|reach|78 inches (1.91 meters)}} &rarr; {{Infobox person/length|78 inches (1.91 meters)}}
* {{Para|reach|198 centimetres (71 inches)}} &rarr; {{Infobox person/length|198 centimetres (71 inches)}}
* {{Para|reach|1.98 metres (71 inches)}} &rarr; {{Infobox person/length|1.98 metres (71 inches)}}

Does not replace numeric output of conversion templates such as {{tl|convert}}, but does replace unit names with abbreviations (examples intentionally show different precision than usual):

* {{Para|reach|<nowiki>{{convert|78|in|cm|1|abbr=off|sp=us}}</nowiki>}} &rarr; {{Infobox person/length|{{convert|78|in|cm|1|abbr=off|sp=us}}}}
** output of convert template: {{convert|78|in|cm|1|abbr=off|sp=us}}
* {{Para|reach|<nowiki>{{convert|78|in|m|3|abbr=off|sp=us|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{convert|78|in|m|3|abbr=off|sp=us|lk=on}}}}
** output of convert template: {{convert|78|in|m|3|abbr=off|sp=us|lk=on}}
* {{Para|reach|<nowiki>{{convert|198|cm|in|2|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{convert|198|cm|in|2|abbr=off|lk=on}}}}
** output of convert template: {{convert|198|cm|in|2|abbr=off|lk=on}}
* {{Para|reach|<nowiki>{{convert|1.98|m|in|2|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{convert|1.98|m|in|2|abbr=off}}}}
** output of convert template: {{convert|1.98|m|in|2|abbr=off}}

== Areas for improvement ==

Conversion not displayed if unit name contains uppercase characters:

* {{Para|reach|198 Centimetres}} &rarr; {{Infobox person/length|198 Centimetres}}
* {{Para|reach|198 CM}} &rarr; {{Infobox person/length|198 CM}}
* {{Para|reach|1.98 Metres}} &rarr; {{Infobox person/length|1.98 Metres}}
* {{Para|reach|1.98 M}} &rarr; {{Infobox person/length|1.98 M}}
* {{Para|reach|78 Inches}} &rarr; {{Infobox person/length|78 Inches}}
* {{Para|reach|78 IN}} &rarr; {{Infobox person/length|78 IN}}

Conversion not displayed if symbols are used for inches:

* {{Para|reach|78"}} &rarr; {{Infobox person/length|78"}}
* {{Para|reach|78″}} &rarr; {{Infobox person/length|78″}}

Does not recognize symbols for inches in manually entered conversion (adds a second conversion):

* {{Para|reach|198cm (78")}} &rarr; {{Infobox person/length|198cm (78")}}
* {{Para|reach|1.98m (78″)}} &rarr; {{Infobox person/length|1.98m (78″)}}

Does not convert [[Foot (unit)|feet]] (ft) or [[yard]]s (yd):

* {{Para|reach|6 feet}} &rarr; {{Infobox person/length|6 feet}}
* {{Para|reach|6 ft}} &rarr; {{Infobox person/length|6 ft}}
* {{Para|reach|2 yards}} &rarr; {{Infobox person/length|2 yards}}
* {{Para|reach|2 yd}} &rarr; {{Infobox person/length|2 yd}}

If {{tl|convert}} template displays feet or yards, it is not abbreviated:

* {{Para|reach|<nowiki>{{Convert|6|ft|6|in|cm|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|6|ft|6|in|cm|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|6|ft|6|in|m|2|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|6|ft|6|in|m|2|abbr=off|lk=on}}}}
* {{Para|reach|<nowiki>{{Convert|2|yd|1.5|ft|cm|0|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|2|yd|1.5|ft|cm|0|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|2|yd|1.5|ft|m|2|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|2|yd|1.5|ft|m|2|abbr=off|lk=on}}}}

If {{tl|convert}} displays feet or yards in conversion, a second conversion is displayed (only for unlinked unit names):

* {{Para|reach|<nowiki>{{Convert|198|cm|ftin|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|198|cm|ftin|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|1.98|m|ftin|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|1.98|m|ftin|abbr=off|lk=on}}}}
* {{Para|reach|<nowiki>{{Convert|229|cm|ydft|1|abbr=off}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|229|cm|ydft|1|abbr=off}}}}
* {{Para|reach|<nowiki>{{Convert|2.29|m|ydft|1|abbr=off|lk=on}}</nowiki>}} &rarr; {{Infobox person/length|{{Convert|2.29|m|ydft|1|abbr=off|lk=on}}}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Template implementation details]]

}}</includeonly>