Editing Template:Block left/doc

{{documentation subpage}}
{{div-based-template|class=.wst-block-left|classcount=1}}
{{uses TemplateStyles|Template:Block left/styles.css}}

==Usage==
This template places a block of text in the left of the page, without affecting the text alignment within that block.

;Comparison of {{tl|Block left}} and {{tl|left}}
This template retains the current text alignment (usually left), but moves the entire block of text into the left. To change to left text alignment, use {{tl|left}} instead.

:;Block left
{{block left|{{center|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor.}}

Aenean massa.}}

:;left:
{{left|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor. 

Aenean massa.}}

===Parameter===
All parameters are optional. 
* {{parameter|class}} set block additional classes
* {{parameter|width}} set the width of the block
* {{parameter|offset}} set the distance ("indent") from the left margin
* {{parameter|gutter}}  set the gap between the normal content and the block
* {{parameter|align}} set the internal alignment of the block
* {{parameter|style}} add other kinds of style
* {{parameter|body}} or {{parameter|1}} content of the block

==== Width ====
Where there is a requirement to fix the width of the block, an optional {{parameter|width}} parameter can be used. When the content is text, prefer text-relative units like ''em'' to absolute units like ''px''.<ref>See [[H:PXWIDTH]] for further details.</ref>

{{doc example|content=
<pre>{{block left|width=25em|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor.

Aenean massa.}}</pre>


{{block left|width=25em|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor.

Aenean massa.}}
}}

==== Align ====
To align the ''content'' of the left-aligned block within the block, an optional {{parameter|align}} parameter may be used:

{{doc example|content=
<pre>{{block left|align=center|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor.

Aenean massa.}}</pre>


{{block left|align=center|Lorem ipsum dolor sit amet, consectetuer adipiscing elit.<br/>
Aenean commodo ligula eget dolor.

Aenean massa.}}
}}

{{rule}}
{{reflist}}

==See also==
* {{tl|block right}}
* {{tl|left}} and {{tl|right}}
* {{tl|float left}} and {{tl|float right}}

<!-- template categories -->
<includeonly>
[[Category:Formatting templates]]
[[Category:Special effects templates]]
</includeonly>