Editing Template:In5/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

The indenter '''Template:in5''' indents text by 5 spaces or
the count specified by<br>parameter 1 (range: 1 to 50 spaces).
<br><br>
:: Usage: &nbsp; {<font/>{in5}} {{in5}} <--indents by 5 spaces<br>
:: Usage: &nbsp; {<font/>{in5|8}} &nbsp; &nbsp; <--indents by 8 spaces<br>
:: Usage: &nbsp; {<font/>{in5|47}} &nbsp;&nbsp;<--indents by 47

Spaces outside the double braces will add an extra space on either
side,<br>such as the 12 spaces inserted by: " {<font/>{in5|10}} ".

NOTE: The name "in5" was chosen because other names were debated, such as<br> the name "in" being redefined as 6 different uses.

==Examples==
The following are examples showing larger amounts of spacing:
:: Example 1: <nowiki>xx{{in5|10}}yy{{in5|10}}</nowiki>zz, produces: xx{{in5|10}}yy{{in5|10}}zz
:: Example 2: <nowiki>xx{{in5|10}}yy{{in5|15}}</nowiki>zz, produces: xx{{in5|10}}yy{{in5|15}}zz
:: Example 3: <nowiki>aa{{in5|20}}bb{{in5|20}}</nowiki>cc, produces: aa{{in5|20}}bb{{in5|20}}cc
:: Example 4: <nowiki>"32.0{{in5|7}}"</nowiki>&nbsp; produces: "32.0{{in5|7}}"
The example 4 shows the ability to put trailing spaces, such as spaces after a number in a wikitable column (coded as: |&nbsp;32.0{<font/>{in5}}&nbsp;). Typical numbers (with "align=right"), in a table column, often appear crowded at the right-hand side, so appending "{<font/>{in5}}" can improve readability, in tables with lines between columns.

==Universal template==
This Template:in5 is intended as a universal template, with the same name on all Wikipedia sites. The name "in5" with the digit "5" is unlikely to conflict with other-language Wikipedias. Care must be taken not to name a universal template with a name that would be an awkward or peculiar word in the other languages. However, in some cases, a universal template might need a different name in a few conflicting languages.

==Comparison with Template:spaces==
There are other templates that insert spaces, although none had allowed 50 spaces. For example, the&nbsp;[[Template:spaces]] has had a limit of about 15 spaces (during 2009-2010):
{| class=wikitable style="margin-left:40px"
| valign=top | Example of <nowiki>{{spaces|10}}</nowiki><br>and...<br>with <nowiki>{{spaces|14}}</nowiki><br>with <nowiki>{{spaces|15}}</nowiki><br>with <nowiki>{{spaces|25}}</nowiki> || <nowiki>xx{{spaces|10}}</nowiki>yy, produces:<br>xx{{spaces|10}}yy<br>xx{{spaces|14}}yy<br>xx{{spaces|15}}yy<br>xx{{spaces|25}}yy
|-
| valign=top | Example of <nowiki>{{in5|10}}</nowiki><br>and...<br>with <nowiki>{{in5|14}}</nowiki><br>with <nowiki>{{in5|15}}</nowiki><br>with <nowiki>{{in5|25}}</nowiki><br>with <nowiki>{{in5|45}}</nowiki> || <nowiki>xx{{in5|10}}</nowiki>yy, produces:<br>xx{{in5|10}}yy<br>xx{{in5|14}}yy<br>xx{{in5|15}}yy<br>xx{{in5|25}}yy<br>xx{{in5|45}}yy
|}
Again, using {<font/>{in5}} reliably allows up to 50 spaces at a time.

==Comparison with letter-spacing==
To insert spacing between <u>each consecutive letter pair</u> of any text, then span style="letter-spacing:''value unit"'' can be used. For example, with <nowiki><span style="letter-spacing:1.2em"></nowiki>, spanning the text "example", it would look like:&nbsp; "<span style="letter-spacing:1.2em">example</span>". The spacing ''value'' may express any number from 0 on; also fractions like .45 are possible, and the ''unit'' may be "em" or any standard measurement unit (pt, px, cm, mm, in).

==Performance==
Template {in5} generates a mix of &amp;nbsp; and spaces to avoid the space compression done by the [[MediaWiki]] parser. Each &nbsp is stored inside the formatted page (such as seen by the browser option: &lt;View>&lt;Source>). The output is optimized to be the shortest possible markup language for spaces, in a variety of different browsers.

Typically, {in5} runs much faster than [[Template:spaces]], generating 1/3 the markup per use (as 72% less text, over 50 fewer characters each time). Also, {in5} allows 50 spaces, whereas {spaces} has been limited to 15 spaces during 2009-2010.

==See also==
* [[Template:indent]] - forces newline break before indenting


<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Wikipedia formatting and function templates|In5]]

</includeonly>