साँचा:Multicol/विव का स्रोत देखें

{{Documentation subpage}}
यह साँचा प्रदर्शन हेतु [[साँचा:Multicol/styles.css]] का प्रयोग करता है।
<!--
    PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE
    YOU CAN EDIT THE TEMPLATE DOCUMENTATION BELOW THIS COMMENT
-->
== Usage ==
{{tl|Multicol}} is used to start a multi-column section of a page. Between each block of column text insert <tt>{{tl|Multicol-break}}</tt>, between each section (which will keep the same column spacing) add <tt>{{tl|Multicol-section}}</tt> and close the last column with <tt>{{tl|Multicol-end}}</tt>. For example:

<pre>
 {{Multicol}}
 This text appears in the first column.
 {{Multicol-break}}
 This text appears in the second column.
 {{Multicol-break}}
 This text appears in the third column.
 {{Multicol-end}}
</pre>

You can have any number of columns. Each column will be the same width, equally dividing the available horizontal space. Each column has a small right margin (20 pixels), creating a "gutter" that prevents text in one column from touching text in the column to its right. See [[w:User:Franl|franl]]'s user page for examples of how this template can be used.

== Parameters ==
This template has four optional parameters
* <code>width</code>, <code>1</code>: The overall width of the set of columns (use <tt>auto</tt> to shrink to content)
* <code>align</code>: Alignment of the overall set of columns
* <code>text-align</code>: Alignment of the text within the columns
* <code>v-align</code>: Vertical alignment of the text within the columns
* <code>line</code>: Interstitial line format. 
* <code>gap</code>, <code>2</code>: The width of the gutter


===Overall width===
The overall width of the set of columns is set in {{tl|multicol}} as the first parmeter. It can be an absolute value (e.g., <tt>40em</tt>) or a percentage of the available page width (e.g., <tt>50%</tt>). This parameter defaults to <tt>100%</tt>. For example, to create a multi-column section that is only 50% the width of the page:

<pre>
{{Multicol|50%}}
This text appears in the first column.
{{Multicol-break}}
This text appears in the second column.
{{Multicol-break}}
This text appears in the third column.
{{Multicol-section}}
This text appears in the next row, first column.
{{Multicol-break}}
This text appears in the next row, second column.
{{Multicol-end}}
</pre>

{{Multicol|50%}}
{{lorem ipsum}}
{{Multicol-break}}
{{lorem ipsum}}
{{Multicol-break}}
{{lorem ipsum}}
{{Multicol-section}}
{{lorem ipsum}}
{{Multicol-break}}
{{lorem ipsum}}
{{Multicol-end}}

===Alignment===

The multi-column region is positioned on the left side of the containing block by default. To change this, adjust the "align" parameter in {{tl|multicol}} to "center" or "right"

<pre>
 {{Multicol|50%|align=center}}
 ...
 {{Multicol-end}}
</pre>

{{Multicol|50%|align=center}}
{{lorem ipsum}}
{{Multicol-break}}
{{lorem ipsum}}
{{Multicol-end}}

=== Text alignment===

Text within the column is positioned on the left side by default. To change this, adjust the "text-align" parameter in {{tl|multicol}} to "center" or "right"

<pre>
 {{Multicol|70%|align=center|text-align=right}}
 ...
 {{Multicol-break|text-align=center}}
 ...
 {{Multicol-break}}
 ...
 {{Multicol-end}}
</pre>

{{Multicol|70%|align=center|text-align=right}}
{{lorem ipsum}}
{{Multicol-break|text-align=center}}
{{lorem ipsum}}
{{Multicol-break}}
{{lorem ipsum}}
{{Multicol-end}}

=== Vertical alignment===

Text within the column is positioned on the top default. To change this, adjust the "v-align" parameter in {{tl|multicol}} to "middle" or "bottom"

<pre>
 {{Multicol|70%}}
 ...
 {{Multicol-break|v-align=middle}}
 ...
 {{Multicol-break}}
 ...
 {{Multicol-end}}
</pre>

{{Multicol|70%}}
{{lorem ipsum}}
{{Multicol-break|v-align=middle}}
Some text
{{Multicol-break|v-align=bottom}}
Some text
{{Multicol-end}}

=== Margins === 

The margins can easily be changed by adjusting the second parameter in {{tl|multicol}} or the first in {{tl|multicol-break}}. You do not specify it in {{tl|multicol-end}}. The margins occur on the left and right of the block, so you should specify half the actual separation you want.

<pre>
{{Multicol||40px}}
This text appears in the first column.
{{Multicol-break|40px}}
This text appears in the second column.
{{Multicol-end}}
</pre>
{{Multicol||40px}}
{{lorem ipsum}}
{{Multicol-break|40px}}
{{lorem ipsum}}
{{Multicol-end}}

===Line format===
The third parameter controls a line between the blocks. This parameter is named "line" and cannot be accessed using positional arguments. It must be specified in {{tl|multicol}} and {{tl|multicol-break}}. The line format is given in the CSS way, eg "1px solid black", "2px dashed red", etc.

<pre>
{{Multicol|line=1px solid black}}
This text appears in the first column.
{{Multicol-break|line=1px solid black}}
This text appears in the second column.
{{Multicol-end}}
</pre>
{{Multicol|line=1px solid black}}
{{lorem ipsum}}
{{Multicol-break|line=1px solid black}}
{{lorem ipsum}}
{{Multicol-end}}

=== Other style ===
the |style= parameter may be used to define other styles not covered above.

== Technical notes==

This template uses a table to achieve the columns. Consider using a table if it is clearer in context than using this template.

== यह भी देखें ==
* [[विकिपुस्तक:साँचे]]

<includeonly>

<!-- PLEASE ADD CATEGORIES BELOW THIS LINE, THANKS. -->
[[श्रेणी:फॉर्मेटिंग साँचे]]

<!-- PLEASE ADD INTERWIKIS BELOW THIS LINE, THANKS. -->

</includeonly>