Template:Multicol/doc - Revision history

Fritigern: /* Parameters */

2011-06-06T01:55:22Z

‎Parameters

Fritigern: /* Parameters */

2011-06-06T01:54:40Z

‎Parameters

Fritigern: /* Usage */

2011-06-06T01:54:11Z

‎Usage

Fritigern at 01:53, 6 June 2011

2011-06-06T01:53:38Z

Fritigern at 01:51, 6 June 2011

2011-06-06T01:51:55Z

Fritigern: New page: {{Documentation subpage}} == Usage == {{tl|Multi...

2011-06-06T01:41:10Z

New page: {{Documentation subpage}}  == Usage == {{tl|Multi...

New page

{{Documentation subpage}}

== 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> 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>

Provides this format:
{{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}}

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 [[User:Franl|franl]]'s user page for examples of how this template can be used.

== Parameters ==
This template has two optional parameters: the overall width of the set of columns and the width of the gutter. The overall width of the set of columns 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-end}}
</pre>

Provides this format:
{{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-end}}

The multi-column region is always positioned on the left side of the containing block. To change this, place the above Wikitext in a <tt>[[DIV (HTML tag)|DIV]]</tt> block that has the [[Cascading Style Sheet|CSS]] attribute <tt>text-align</tt> set to either <tt>center</tt> or <tt>right</tt>, like this:

<pre>
<div style="text-align:center;">{{center|
{{Multicol|50%}}
...
{{Multicol-end}}
}}</div>
</pre>

== Related templates ==
The templates {{tl|Col-begin}} and friends do something similar to this template and its friends, but this template may be easier to use. Each of the following examples produce the same result (a 3-column table in which all columns have equal width):

<center>
{{Multicol|50%}}
<pre>
{{Multicol}}
Column 1
{{Multicol-break}}
Column 2
{{Multicol-break}}
Column 3
{{Multicol-end}}
</pre>
{{Multicol-break}}
<pre>
{{Col-begin}}
{{Col-3}}
Column 1
{{Col-3}}
Column 2
{{Col-3}}
Column 3
{{Col-end}}
</pre>
{{Multicol-end}}
</center>

It's simpler to add more columns to the {{tl|Multicol}} example than to the {{tl|Col-begin}} example, because in the latter case, all occurrences of {{tl|Col-3}} would need to be changed to {{tl|Col-4}}.

<includeonly>


[[Category:Table and column templates]]


[[ca:Plantilla:Columnes]]
[[cy:Nodyn:Multicol]]
[[eo:Ŝablono:Multkolumna]]
[[es:Plantilla:Columnas]]
[[fa:الگو:چندستون]]
[[fr:Modèle:Colonnes2]]
[[hsb:Předłoha:Multicol]]
[[id:Templat:Multicol]]
[[it:Template:MultiCol]]
[[ja:Template:Multicol]]
[[pt:Predefinição:Multicol]]
[[ru:Шаблон:Multicol]]
[[zh:template:multicol]]
[[uk:Шаблон:Multicol]]
</includeonly>

@@ Line 50: / Line 50: @@
 {{Multicol-end}}
-The multi-column region is always positioned on the left side of the containing block. To change this, place the above Wikitext in a <tt>[[DIV (HTML tag)|DIV]]</tt> block that has the CSS attribute <tt>text-align</tt> set to either <tt>center</tt> or <tt>right</tt>, like this:
+The multi-column region is always positioned on the left side of the containing block. To change this, place the above Wikitext in a <tt>DIV</tt> block that has the CSS attribute <tt>text-align</tt> set to either <tt>center</tt> or <tt>right</tt>, like this:
 <pre>

← Older revision		Revision as of 01:53, 6 June 2011
Line 59:		Line 59:
	}}</div>		}}</div>
	</pre>		</pre>
−
−	~~== Related templates ==~~
−	The templates {{tl\|Col-begin}} and friends do something similar to this template and its friends, but this template may be easier to use. Each of the following examples produce the same result (a 3-column table in which all columns have equal width):
−
−	~~<center>~~
−	~~{{Multicol\|50%}}~~
−	~~<pre>~~
−	~~{{Multicol}}~~
−	~~Column 1~~
−	~~{{Multicol-break}}~~
−	~~Column 2~~
−	~~{{Multicol-break}}~~
−	~~Column 3~~
−	~~{{Multicol-end}}~~
−	~~</pre>~~
−	~~{{Multicol-break}}~~
−	~~<pre>~~
−	~~{{Col-begin}}~~
−	~~{{Col-3}}~~
−	~~Column 1~~
−	~~{{Col-3}}~~
−	~~Column 2~~
−	~~{{Col-3}}~~
−	~~Column 3~~
−	~~{{Col-end}}~~
−	~~</pre>~~
−	~~{{Multicol-end}}~~
−	~~</center>~~
−
−	It's simpler to add more columns to the {{tl\|Multicol}} example than to the {{tl\|Col-begin}} example, because in the latter case, all occurrences of {{tl\|Col-3}} would need to be changed to {{tl\|Col-4}}.

← Older revision		Revision as of 01:51, 6 June 2011
Line 89:		Line 89:

	It's simpler to add more columns to the {{tl\|Multicol}} example than to the {{tl\|Col-begin}} example, because in the latter case, all occurrences of {{tl\|Col-3}} would need to be changed to {{tl\|Col-4}}.		It's simpler to add more columns to the {{tl\|Multicol}} example than to the {{tl\|Col-begin}} example, because in the latter case, all occurrences of {{tl\|Col-3}} would need to be changed to {{tl\|Col-4}}.
−
−	~~<includeonly>~~
−
−	~~<!-- PLEASE ADD CATEGORIES BELOW THIS LINE, THANKS. -->~~
−	~~[[Category:Table and column templates]]~~
−
−	~~<!-- PLEASE ADD INTERWIKIS BELOW THIS LINE, THANKS. -->~~
−	~~[[ca:Plantilla:Columnes]]~~
−	~~[[cy:Nodyn:Multicol]]~~
−	~~[[eo:Ŝablono:Multkolumna]]~~
−	~~[[es:Plantilla:Columnas]]~~
−	~~[[fa:الگو:چندستون]]~~
−	~~[[fr:Modèle:Colonnes2]]~~
−	~~[[hsb:Předłoha:Multicol]]~~
−	~~[[id:Templat:Multicol]]~~
−	~~[[it:Template:MultiCol]]~~
−	~~[[ja:Template:Multicol]]~~
−	~~[[pt:Predefinição:Multicol]]~~
−	~~[[ru:Шаблон:Multicol]]~~
−	~~[[zh:template:multicol]]~~
−	~~[[uk:Шаблон:Multicol]]~~
−	~~</includeonly>~~

@@ Line 26: / Line 26: @@
 {{Multicol-end}}
-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 [[User:Franl|franl]]'s user page for examples of how this template can be used.
+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.
 == Parameters ==