Template:Block indent/doc

eesti ∙ Deutsch ∙ dansk ∙ čeština ∙ asturianu ∙ català ∙ Boarisch ∙ English ∙ español ∙ sicilianu ∙ 中文（简体） ∙ 中文（繁體） ∙ Esperanto ∙ Tiếng Việt ∙ Scots ∙ українська ∙ Zazaki ∙ Türkçe ∙ ไทย ∙ slovenščina ∙ polski ∙ മലയാളം ∙ galego ∙ Ελληνικά ∙ 日本語 ∙ ქართული ∙ македонски ∙ فارسی ∙ Nederlands ∙ မြန်မာဘာသာ ∙ русский ∙ 中文 ∙ suomi ∙ العربية ∙ norsk bokmål ∙ norsk ∙ Lëtzebuergesch ∙ српски / srpski ∙ Plattdüütsch ∙ български ∙ 한국어 ∙ svenska ∙ português do Brasil ∙ hrvatski ∙ ဘာသာ မန် ∙ français ∙ magyar ∙ euskara ∙ עברית ∙ Mirandés ∙ italiano ∙ اردو ∙ português ∙ Bahasa Indonesia ∙ বাংলা ∙ Bahasa Melayu ∙ беларуская (тарашкевіца) ∙ edit

This template is used on many pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Shortcut

{{bi}}

This template uses TemplateStyles:

Template:Block indent/styles.css (sandbox)

Usage

{{block indent}} adds a block of indented text to a page.

{{block indent|1=The material to be indented here. May include markup, paragraph breaks, etc.}}

Alternatives that are not recommended

A colon at the start of the line produces a similar indent, but it produces incorrect HTML. See MOS:INDENT. (An initial : was intended only for use after ;, in constructing description lists, but most editors have used it almost everywhere for indenting.)

{{Blockquote}} is for actual quotations only. Using it for block indent is not correct semantic HTML, and the appearance differs. ({{Blockquote}} produces the HTML <blockquote>...</blockquote> element, which indicates a block quotation; {{block indent}} produces the HTML <div>...</div> element.)

The default display of {{block indent}} differs from that of {{Blockquote}} in that it does not:

introduce whitespace margins above or below the indented material (just add a blank line above and/or below manually); nor
indent from the right as well as the left (there is an optional parameter for this); nor
affect the font size of its contents; nor
(on mobile) bookend the block with large quotation marks; nor
support plain blank-line paragraph breaks inside it; nor
support attribution parameters (because {{block indent}} isn't for quotations).

{{Blockquote}} and {{block indent}} both support paragraph breaks using <p>...</p> around second and subsequent paragraphs, as well as other HTML markup, and it is always safest to explicitly format with HTML rather than rely on MediaWiki's parser to do the right thing, because the developers could alter its behavior at any time.

Example

{{block indent|1={{Lorem ipsum}}}}

produces:

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Parameters

|1= a.k.a. |text= The material to be indented. It is always safest to explicitly define this with 1=, not as an unnamed parameter, because any occurrence (e.g. in a URL, template, etc.) of the = character will break the template without it.

|left= a.k.a. |em= the value (e.g. 0.1 or 7) in em units by which to indent the material from the left; defaults to 3

|right= the value, also in em, by which to indent the material from the right; defaults to 0 (use 7 to match the default left indentation)

|style= arbitrary CSS declarations, e.g. font-size: 95%;. This parameter should not normally be needed. Note: It already includes overflow: hidden; by default, to avoid collision of the div's background with floating elements.

|class= any CSS class names (e.g. as defined at MediaWiki:Common.css), comma-separated if more than one. This parameter should not normally be needed.

Comparison with {{Blockquote}} (block quotation)

{{Block indent}}	{{Blockquote}}
`{{Lorem ipsum}}{{block indent\|1={{Lorem ipsum}}{{Lorem ipsum}}}}{{Lorem ipsum}}`	`{{Lorem ipsum}}{{Blockquote\|1={{Lorem ipsum}}{{Lorem ipsum}}}}{{Lorem ipsum}}`
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.	Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Technical issues with block templates

Template:Block bug documentation