வார்ப்புரு:Text-indent/doc என்பதற்கான மூலத்தைப் பார்

{{documentation subpage}}
{{template shortcut|ti}}
{{div-based-template}}

This template adds indentation to text using the CSS <code>text-indent</code> property. This property controls the indentation of the ''first line'' of a paragraph of text. It can be specified with any valid CSS unit, but [[w:Em (typography)|em]] is the preferred unit. The indentation can be <code>0</code> to disable an inherited indent, or negative to achieve various special effects such as hanging indents (but use {{tlx|hanging indent}} for that). The default value is <code>2em</code>.

Note that this template should ''not'' be used to attempt to replicate the printing style where the first line of every new paragraph is indented. See the [[Wikisource:Style guide#Indentation|policy on indentation of paragraphs]].


== Usage ==
The primary calling convention for this template is the block-based one:

{{ti/s}}<code><nowiki>{{</nowiki>'''ti/s'''|''CSS unit''<nowiki>}}</nowiki> … ''text'' … <nowiki>{{</nowiki>'''ti/e'''<nowiki>}}</nowiki></code>{{ti/e}}


For a single shorter run of text containing no characters that are significant in wikicode (equals signs in particular), you can also use the inline calling convention:

{{ti/s}}<code><nowiki>{{</nowiki>ti|''CSS unit''|''text''<nowiki>}}</nowiki></code>{{ti/e}}


For most use cases though, the block calling convention is strongly recommended as it is the most flexible and creates the fewest surprising edge cases and weird behaviour..

== Arguments ==
This template uses positional (unnamed) parameters. If only one parameter is provided it is assumed to be a CSS length value and is passed directly into the <code>style</code> attribute for the container (so make sure you provide a valid value here!). If you are using the inline calling convention you can also provide the text the template should apply to in the second unnamed parameter. In either case you can leave the indent amount empty and the template will default to <code>2em</code>.

{| class="wikitable"
|-
! &nbsp; !! {{tlx|ti}} !! {{tlx|ti/s}}
|-
! 1=
| ''length''
| ''length''
|-
! 2=
| ''text''
| —
|}

== Examples ==
{{doc example|pre_title=Example|title=basic block based calling convention|1=
<pre>{{ti/s}}{{lorem ipsum}}{{ti/e}}</pre>
{{ti/s}}{{lorem ipsum}}{{ti/e}}
}}


{{doc example|pre_title=Example|title=with a custom length|1=
<pre>{{ti/s|5em}}{{lorem ipsum}}{{ti/e}}</pre>
{{ti/s|5em}}{{lorem ipsum}}{{ti/e}}
}}


{{doc example|pre_title=Example|title=overriding an inherited text-indent|1=
<pre>{{ti/s|5em}}
{{lorem ipsum}}
{{ti/s|0}}{{lorem ipsum}}{{ti/e}}
{{lorem ipsum}}
{{ti/e}}</pre>
{{ti/s|5em}}
{{lorem ipsum}}
{{ti/s|0}}{{lorem ipsum}}{{ti/e}}
{{lorem ipsum}}
{{ti/e}}
}}


{{doc example|pre_title=Example|title=hanging indent|1=
<pre>{{left margin|2em}}
{{ti/s|-2em}}{{lorem ipsum}}{{ti/e}}
{{div end}}</pre>
{{left margin|2em}}
{{ti/s|-2em}}{{lorem ipsum}}{{ti/e}}
{{div end}}
}}



=== Basic use ===
{{ti/s}}<code><nowiki>{{</nowiki>text-indent|''CSS unit''|''text''<nowiki>}}</nowiki></code>{{ti/e}}

For a single shorter run of text containing no characters that are significant in wikicode (equals signs in particular), you can use the inline calling convention: the amount of indentation is given in the first parameter, and the text to which it is to be applied in the second. For most use cases though, the block calling convention is strongly recommended.

{{doc example|1=
{{text-indent|2em|
''Lorem ipsum dolor sit amet, consectetuer adipiscing elit.'' 

''Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem.'' 

''Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo.''


''Cui dōnō lepidum novum libellum āridā modo pūmice expolītum''
}}}}

Please note that the last paragraph is ''not indented'', since there are '''two''' new lines before it. This makes MediaWiki insert a <syntaxhighlight lang="html" inline><br /></syntaxhighlight> before it which "steals" the indentation.

== See also ==
* [[Wikisource:Style guide#Indentation|Policy regarding the indentation of paragraphs]]
* {{tl|dent}}

<includeonly>{{sandbox other||
<!-- template categories; convert interwiki links to Wikidata sitelinks -->
[[Category:Special effects templates]]
[[Category:Formatting templates]]
}}</includeonly>