Difference between revisions of "Template:Multicol/doc"
m (iw +ca) |
Storyteller (Talk | contribs) m (19 revisions: Multicol pages) |
||
| (12 intermediate revisions by 11 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{ | + | {{Documentation subpage}} |
<!-- | <!-- | ||
PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE | PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE | ||
| Line 8: | Line 8: | ||
<pre> | <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> | </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. | 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. | ||
| Line 23: | Line 32: | ||
<pre> | <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> | </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: | 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> | <pre> | ||
| − | + | <div style="text-align:center;">{{center| | |
| − | + | {{Multicol|50%}} | |
| − | + | ... | |
| − | + | {{Multicol-end}} | |
| − | + | }}</div> | |
</pre> | </pre> | ||
| Line 48: | Line 66: | ||
{{Multicol|50%}} | {{Multicol|50%}} | ||
<pre> | <pre> | ||
| − | + | {{Multicol}} | |
| − | + | Column 1 | |
| − | + | {{Multicol-break}} | |
| − | + | Column 2 | |
| − | + | {{Multicol-break}} | |
| − | + | Column 3 | |
| − | + | {{Multicol-end}} | |
</pre> | </pre> | ||
{{Multicol-break}} | {{Multicol-break}} | ||
<pre> | <pre> | ||
| − | + | {{Col-begin}} | |
| − | + | {{Col-3}} | |
| − | + | Column 1 | |
| − | + | {{Col-3}} | |
| − | + | Column 2 | |
| − | + | {{Col-3}} | |
| − | + | Column 3 | |
| − | + | {{Col-end}} | |
</pre> | </pre> | ||
{{Multicol-end}} | {{Multicol-end}} | ||
| Line 78: | Line 96: | ||
<!-- PLEASE ADD INTERWIKIS BELOW THIS LINE, THANKS. --> | <!-- PLEASE ADD INTERWIKIS BELOW THIS LINE, THANKS. --> | ||
| + | [[as:Template:MultiCol]] | ||
[[ca:Plantilla:Columnes]] | [[ca:Plantilla:Columnes]] | ||
| + | [[cy:Nodyn:Multicol]] | ||
[[eo:Ŝablono:Multkolumna]] | [[eo:Ŝablono:Multkolumna]] | ||
| + | [[es:Plantilla:Columnas]] | ||
| + | [[fa:الگو:چندستون]] | ||
[[hsb:Předłoha:Multicol]] | [[hsb:Předłoha:Multicol]] | ||
| + | [[id:Templat:Multicol]] | ||
[[it:Template:MultiCol]] | [[it:Template:MultiCol]] | ||
| + | [[ja:Template:Multicol]] | ||
[[pt:Predefinição:Multicol]] | [[pt:Predefinição:Multicol]] | ||
[[ru:Шаблон:Multicol]] | [[ru:Шаблон:Multicol]] | ||
Latest revision as of 13:24, 21 November 2012
{{#ifeq: multicol/doc | doc
|
{{
#ifeq: show | show | Template:Mbox }}{{ #if: | | {{#ifexist:Template:Multicol/doc|[[Category:{{ #switch: Template | Template = Template | User = User | #default = Wikipedia }} documentation pages]]|}} }}
| }}
Usage
{{Multicol}} is used to start a multi-column section of a page. Between each block of column text insert {{Multicol-break}} and close the last column with {{Multicol-end}}. For example:
{{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}}
Provides this format:
This text appears in the first column. |
This text appears in the second column. |
This text appears in the third column. |
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 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., 40em) or a percentage of the available page width (e.g., 50%). This parameter defaults to 100%. For example, to create a multi-column section that is only 50% the width of the page:
{{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}}
Provides this format:
This text appears in the first column. |
This text appears in the second column. |
This text appears in the third column. |
The multi-column region is always positioned on the left side of the containing block. To change this, place the above Wikitext in a DIV block that has the CSS attribute text-align set to either center or right, like this:
<div style="text-align:center;">{{center|
{{Multicol|50%}}
...
{{Multicol-end}}
}}</div>
Related templates
The templates {{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):
{{Multicol}}
Column 1
{{Multicol-break}}
Column 2
{{Multicol-break}}
Column 3
{{Multicol-end}}
|
{{Col-begin}}
{{Col-3}}
Column 1
{{Col-3}}
Column 2
{{Col-3}}
Column 3
{{Col-end}}
|
It's simpler to add more columns to the {{Multicol}} example than to the {{Col-begin}} example, because in the latter case, all occurrences of {{Col-3}} would need to be changed to {{Col-4}}.
