Difference between revisions of "Template:Indent/doc"

From blackwiki
Jump to navigation Jump to search
imported>Plastikspork
imported>Wikid77
(restored text to describe Template:in5 in same universal family, for up to 50 spaces)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
The indenter [[Template:indent]] performs a newline and indents by a specified number of spaces. However, the spaces are not all the same size, but rather a mixture of [[en]]-size & [[em]]-size spaces that have been tested to work on a wide range of browsers.
+
The indenter [[Template:indent]] performs a newline and indents by a specified number of spaces. However, the spaces are not all the same size, but rather a mixture of [[en]]-size & [[em]]-size spaces that have been tested to work on a wide range of browsers. (To skip by ''n'' equal-size spaces, instead use {{tl2|in5|''n''}} which puts all as the standard-size " " space.)
 
__TOC__
 
__TOC__
  
Line 8: Line 8:
  
 
'''Usage:''' <nowiki>{{</nowiki>indent|''# of spaces''}}
 
'''Usage:''' <nowiki>{{</nowiki>indent|''# of spaces''}}
* Indents up to 30 spaces.
+
* Indents up to 30 spaces. (use {{tl2|in5|n}} to skip up to 50 spaces)
 
* Indent differs from {{tl|space}} only in that it automatically begins a wrapped-newline, then spaces over ''n'' spaces, whereas {{tl|space}} spaces over ''n'' in the same (current) line.
 
* Indent differs from {{tl|space}} only in that it automatically begins a wrapped-newline, then spaces over ''n'' spaces, whereas {{tl|space}} spaces over ''n'' in the same (current) line.
  
Line 40: Line 40:
  
 
Note that if the prior line is already colon-shifted text, then using "{{tl2|indent|5}}" generates a blank line first, so instead, use "{{tl2|space|5}}" (or such) after a colon-shifted line.
 
Note that if the prior line is already colon-shifted text, then using "{{tl2|indent|5}}" generates a blank line first, so instead, use "{{tl2|space|5}}" (or such) after a colon-shifted line.
 +
 +
==Analysis of uneven spacing==
 +
The non-breaking "&amp;nbsp;" is exactly the same size as a space (by definition, it must be the same), so it can be alternated with spaces to skip a wider area. Notice that neither {{tl|indent}} nor {{tl|space}} use true space-size, but rather mix en+em spaces, whereas "{{tl2|in5|n}}" will actually skip ''n'' count of spaces, as if inserting ''n'' repetitions of an "&amp;nbsp;" space.
  
 
==History==
 
==History==
Line 48: Line 51:
 
* {{tl|space}} - skips similar spacing mix of en-size & em-size spaces.
 
* {{tl|space}} - skips similar spacing mix of en-size & em-size spaces.
 
* {{tl|spaces}} - uses non-breaking spaces.
 
* {{tl|spaces}} - uses non-breaking spaces.
 +
* {{tl|in5}} - skips up to 50 equal-size spaces as all en-size spaces.
  
 
<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
 
<includeonly><!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->

Revision as of 06:39, 25 September 2009

The indenter Template:indent performs a newline and indents by a specified number of spaces. However, the spaces are not all the same size, but rather a mixture of en-size & em-size spaces that have been tested to work on a wide range of browsers. (To skip by n equal-size spaces, instead use {{in5|n}} which puts all as the standard-size " " space.)

Usage

The indentation spacing generated by Template:indent will match the alignment of a colon-shift (":") by using {{indent|5}}, or to match "::" then align by {{indent|10}}.

Usage: {{indent|# of spaces}}

  • Indents up to 30 spaces. (use {{in5|n}} to skip up to 50 spaces)
  • Indent differs from {{space}} only in that it automatically begins a wrapped-newline, then spaces over n spaces, whereas {{space}} spaces over n in the same (current) line.

Examples

The following are detailed examples, also comparing to the equivalent indentation generated if a colon-shift ":" were used instead.

Example 1 - Indenting by 5:
Some text.{{indent|5}}Some more text.


Results:
Some text.
     Some more text.

Example 2 - Alignment with ":" or "::" indentations:
: Line of colon-shifted text.
{{indent|5}}Line of indent-5-shifted text.
<br>&nbsp; &nbsp; &nbsp;&nbsp;Line of br-6-nbsp-shifted text.
<br>&nbsp; &nbsp; &nbsp;Line of br-5-nbsp-shifted text.
<br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Line of br-5-nbsp-true-shifted text.
:: Line of 2-colon-shifted text.
{{space|10}}Line of space-10-shifted text.

Results:

Line of colon-shifted text.


     Line of indent-5-shifted text.
      Line of br-6-nbsp-shifted text.
     Line of br-5-nbsp-shifted text.
     Line of br-5-nbsp-true-shifted text.

Line of 2-colon-shifted text.

Template:SpaceLine of space-10-shifted text.

Note that if the prior line is already colon-shifted text, then using "{{indent|5}}" generates a blank line first, so instead, use "{{space|5}}" (or such) after a colon-shifted line.

Analysis of uneven spacing

The non-breaking "&nbsp;" is exactly the same size as a space (by definition, it must be the same), so it can be alternated with spaces to skip a wider area. Notice that neither {{indent}} nor {{space}} use true space-size, but rather mix en+em spaces, whereas "{{in5|n}}" will actually skip n count of spaces, as if inserting n repetitions of an "&nbsp;" space.

History

This template originated on the sister project Wikisource(home page)

—and was subsequently ported to English Wikipedia at 21:27, 26 May 2006 (UTC).

See also

  • {{space}} - skips similar spacing mix of en-size & em-size spaces.
  • {{spaces}} - uses non-breaking spaces.
  • {{in5}} - skips up to 50 equal-size spaces as all en-size spaces.