Difference between revisions of "Template:Col-begin template"

From blackwiki
Jump to navigation Jump to search
imported>Bsherr
m (replacing Template:Tld with Template:Tlc, plus general and typo fixes as found, typo(s) fixed: wikipedia → Wikipedia)
 
(32 intermediate revisions by 21 users not shown)
Line 1: Line 1:
{{#switch:{{lc:{{PAGENAME}}}}
+
{{#switch:{{lc:{{BASEPAGENAME}}}}
| col-2 = The [[Template:Col-2]] sets column width for each of two columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-2 |width=40%|align=right|valign=center}}</nowiki>.<br><br>
+
| col-2 = The [[Template:Col-2]] sets column width for each of two columns, with align=left, valign=top. The align or valign can be changed: <nowiki>{{col-2 |align=right|valign=center}}</nowiki>.
| col-3 = The [[Template:Col-3]] sets column width for each of three columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-3 |width=25%|align=right|valign=center}}</nowiki>.<br><br>
+
| col-3 = The [[Template:Col-3]] sets column width for each of three columns, with align=left, valign=top. The align or valign can be changed: <nowiki>{{col-3|align=right|valign=center}}</nowiki>.
| col-4 = The [[Template:Col-4]] sets column width for each of four columns.<br><br>
+
| col-4 = The [[Template:Col-4]] sets column width for each of four columns.
| col-5 = The [[Template:Col-5]] sets column width for each of five columns.<br><br>
+
| col-5 = The [[Template:Col-5]] sets column width for each of five columns.
| col-6 = The [[Template:Col-6]] sets column width for each of six columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-6 |width=20%|align=right|valign=center}}</nowiki>.<br><br>
+
| col-6 = The [[Template:Col-6]] sets column width for each of six columns, with align=left, valign=top. The width, align or valign can be changed: <nowiki>{{col-6 |width=20%|align=right|valign=center}}</nowiki>.
| col-start=The [[Template:Col-start]] begins a wikitable (same as <nowiki>{{col-begin}}</nowiki>).<br><br>
+
| col-start=The [[Template:Col-start]] begins a wikitable (same as <nowiki>{{col-begin}}</nowiki>).
}}
+
}}{{Column Templates Navbox}}
 
The {{tl|col-begin}}, {{tl|col-break}} and {{tl|col-end}} templates control columns of text on a page:
 
The {{tl|col-begin}}, {{tl|col-break}} and {{tl|col-end}} templates control columns of text on a page:
:*<nowiki>{{col-begin}}</nowiki>: starts a table (followed by <nowiki>{{col-break}}</nowiki> for 1st column)
+
* <nowiki>{{col-begin}}</nowiki>: starts a table (followed by <nowiki>{{col-break}}</nowiki> for 1st column)
:*<nowiki>{{col-break}}</nowiki>: triggers the start of each column
+
* <nowiki>{{col-break}}</nowiki>: triggers the start of each column
:*<nowiki>{{col-end}}</nowiki>: ends the multi-column table.
+
* <nowiki>{{col-end}}</nowiki>: ends the multi-column table.
 
The widths of columns can be specified by using various additional codes. See below for examples.
 
The widths of columns can be specified by using various additional codes. See below for examples.
  
 
== Usage ==
 
== Usage ==
:: <nowiki>{{col-begin|width=70%}}</nowiki>: start table with width.
+
{{tlc|col-begin|width{{=}}70%}}: start table with specific width.<br />
:: <nowiki>{{col-break|width=66%}}</nowiki>: start column-1 as 66% wide.
+
{{tlc|col-break|width{{=}}66%}}: start column-1 as 66% wide.<br />
:: This is text in col-1.
+
''This is text in column-1.''<br />
:: <nowiki>{{col-break|width=33%}}</nowiki>: start column-2 as 33% wide.
+
{{tlc|col-break|width{{=}}33%}}: start column-2 as 33% wide.<br />
:: Text column-2.
+
''This is text in column-2.''<br />
:: <nowiki>{{col-end}}</nowiki>
+
{{tlc|col-end}}
 +
 
 
The table will have two columns, with column 1 twice (2×) the width of column 2.
 
The table will have two columns, with column 1 twice (2×) the width of column 2.
  
A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px border—for example, as in [[Wikipedia:Tutorial/Wrap-up and more info]]—the width needs to be 95% for the table to fit within the screen. Since it's possible that some tables might not have a border, correction on the individual page could be made after substitution. Another way to create a two column table is like this:
+
A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px border, the width needs to be 95% for the table to fit within the screen. Since it's possible that some tables might not have a border, correction on the individual page could be made after substitution. Another way to create a two column table is like this:
  
 
{|
 
{|
Line 37: Line 38:
 
|}
 
|}
  
{{col-begin|width=95%}}
+
{{col-begin}}
{{col-1-of-4}}
+
{{col-break}}
 
  {{tl|Col-begin}}
 
  {{tl|Col-begin}}
 
  {{tl|Col-2}}
 
  {{tl|Col-2}}
Line 45: Line 46:
 
  Column 2 here
 
  Column 2 here
 
  {{tl|Col-end}}
 
  {{tl|Col-end}}
{{col-2-of-4}}
+
{{col-break|gap=2em}}
 
  {{tl|Col-begin}}
 
  {{tl|Col-begin}}
 
  {{tl|Col-3}}
 
  {{tl|Col-3}}
Line 54: Line 55:
 
  Column 3 here
 
  Column 3 here
 
  {{tl|Col-end}}
 
  {{tl|Col-end}}
{{col-3-of-4}}
+
{{col-break|gap=2em}}
{{tl|Col-begin}}
+
and so on, up to {{tl|Col-5}}
{{tl|Col-4}}
 
Column 1 here
 
{{tl|Col-4}}
 
Column 2 here
 
{{tl|Col-4}}
 
Column 3 here
 
{{tl|Col-4}}
 
Column 4 here
 
{{tl|Col-end}}
 
{{col-4-of-4}}
 
and so on, up to {{tl|Col-7}}
 
 
{{col-end}}
 
{{col-end}}
  
{{col-begin|width=95%}}
+
{{col-begin}}
{{col-1-of-2}}
+
{{col-break}}
  &#123;{[[Template:Col-begin|Col-begin]]|class=references-small}}
+
  &#123;{[[Template:Col-begin|Col-begin]]}}
 
  {{tl|Col-break}}
 
  {{tl|Col-break}}
 
  Column 1 here
 
  Column 1 here
Line 85: Line 75:
 
  Column 6 here
 
  Column 6 here
 
  {{tl|Col-end}}
 
  {{tl|Col-end}}
{{col-2-of-2}}
+
{{col-break|gap=2em}}
 
  &#123;{[[Template:Columns-start|Columns-start]]|num=3}}
 
  &#123;{[[Template:Columns-start|Columns-start]]|num=3}}
 
  Column 1 here
 
  Column 1 here
Line 95: Line 85:
 
{{col-end}}
 
{{col-end}}
  
{{col-begin|width=95%}}
+
==Examples==
{{col-1-of-2}}
+
Here are some example codes that you can use to make columns of text in your Wikipedia article. You can change the width of your columns by changing the code words that go between the text of your columns. Good luck!
{{tl|Multicol}}
+
 
Column 1 here
+
{{hidden begin|toggle=left|title=Example 1, using col-break}}
{{tl|Multicol-break}}
+
<pre>
Column 2 here
+
{{col-begin}}
{{tl|Multicol-break}}
+
{{col-break}}
Column 3 here
+
{| class="wikitable" style="width:18em"
{{tl|Multicol-break}}
+
|+ Production by year
Column 4 here
+
|-
{{tl|Multicol-end}}
+
! 1980
{{col-2-of-2}}
+
| 50,000
{{tl|Top}}
+
|-
Column 1 here
+
! 1990
{{tl|Mid}}
+
| 75,000
Column 2 here
+
|-
{{tl|Bottom}}
+
! 2000
 +
| 90,000
 +
|}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 
{{col-end}}
 
{{col-end}}
 +
</pre>
  
===Examples===
+
gives:
: See: [[Template:Col-break/examples|Col-break/examples]].
+
{{col-begin}}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
{{hidden end}}
  
== See also ==
+
{{hidden begin|toggle=left|title=Example 2, using col-2}}
{{column templates/others}}
+
<pre>
 +
{{col-begin}}
 +
{{col-2}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-2}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
</pre>
  
== External links ==
+
gives:
* [http://www.htmlcodetutorial.com/_MULTICOL.html MULTICOL HTML tag]
+
{{col-begin}}
* [https://developer.mozilla.org/en/docs/CSS3_Columns CSS3 Columns], -moz-column-count
+
{{col-2}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-2}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
{{hidden end}}
 +
{{hidden begin|toggle=left|title=Example 3, use col-break with specified widths}}
 +
<pre>
 +
{{col-begin}}
 +
{{col-break|width=80%}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break|width=20%}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
</pre>
  
 +
gives:
 +
{{col-begin}}
 +
{{col-break|width=80%}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break|width=20%}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
{{hidden end}}
 +
{{hidden begin|toggle=left|title=Example 4, use col-break with auto outer width}}
 +
<pre>
 +
{{col-begin|width=auto}}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break|gap=2em}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
</pre>
 +
{{col-begin|width=auto}}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break|gap=2em}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-end}}
 +
{{hidden end}}
 +
{{hidden begin|toggle=left|title=Example 5, Lots of columns, using col-break}}
 +
{{col-begin}}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Production by year
 +
|-
 +
! 1980
 +
| 50,000
 +
|-
 +
! 1990
 +
| 75,000
 +
|-
 +
! 2000
 +
| 90,000
 +
|}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Profit by year
 +
|-
 +
! 1980
 +
| $6,000
 +
|-
 +
! 1990
 +
| $7,500
 +
|-
 +
! 2000
 +
| $8,200
 +
|}
 +
{{col-break}}
 +
{| class="wikitable" style="width:18em"
 +
|+ Revenue by product
 +
|-
 +
! Widgets
 +
| $25,000
 +
|-
 +
! Foos
 +
| $65,500
 +
|-
 +
! Bars
 +
| $28,000
 +
|}
 +
{{col-end}}
 +
{{hidden end}}
  
{{Selfref|This [[Wikipedia:Template|template]] is a [[Wikipedia:Avoid self-references|self-reference]] and so is part of the Wikipedia project rather than the encyclopedic content.}}
+
== See also ==
 +
{{Column-generating template families}}
  
 
<noinclude>
 
<noinclude>
[[Category:Table and column templates| ]]
+
[[Category:Multi-column templates| ]]
[[Category:Template documentation]]
+
[[Category:Documentation shared content templates]]
 
</noinclude>
 
</noinclude>

Latest revision as of 22:36, 9 August 2020

The {{col-begin}}, {{col-break}} and {{col-end}} templates control columns of text on a page:

  • {{col-begin}}: starts a table (followed by {{col-break}} for 1st column)
  • {{col-break}}: triggers the start of each column
  • {{col-end}}: ends the multi-column table.

The widths of columns can be specified by using various additional codes. See below for examples.

Usage

{{col-begin|width=70%}}: start table with specific width.
{{col-break|width=66%}}: start column-1 as 66% wide.
This is text in column-1.
{{col-break|width=33%}}: start column-2 as 33% wide.
This is text in column-2.
{{col-end}}

The table will have two columns, with column 1 twice (2×) the width of column 2.

A border of 2px (1px width on each side) corresponds to a 5%. Therefore, with a 2px border, the width needs to be 95% for the table to fit within the screen. Since it's possible that some tables might not have a border, correction on the individual page could be made after substitution. Another way to create a two column table is like this:

{{col-begin|width=95%}}
|-
| 
Left column
|
Right column
|}

Examples

Here are some example codes that you can use to make columns of text in your Wikipedia article. You can change the width of your columns by changing the code words that go between the text of your columns. Good luck!

Example 1, using col-break
{{col-begin}}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

gives:

Example 2, using col-2
{{col-begin}}
{{col-2}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-2}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

gives:

Example 3, use col-break with specified widths
{{col-begin}}
{{col-break|width=80%}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break|width=20%}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}

gives:

Example 4, use col-break with auto outer width
{{col-begin|width=auto}}
{{col-break}}
{| class="wikitable" style="width:18em"
|+ Production by year
|-
! 1980
| 50,000
|-
! 1990
| 75,000
|-
! 2000
| 90,000
|}
{{col-break|gap=2em}}
{| class="wikitable" style="width:18em"
|+ Profit by year
|-
! 1980
| $6,000
|-
! 1990
| $7,500
|-
! 2000
| $8,200
|}
{{col-end}}
Example 5, Lots of columns, using col-break

See also

Column-generating template families

<section begin="table" />

Family Type
Handles wiki
 table code?Script error: No such module "If empty".
Responsive/
Mobile suited
Start template Column divider End template
"Col" Table Yes Yes {{Col-begin}},
{{Col-begin-fixed}} or
{{Col-begin-small}}
{{Col-break}} or
{{Col-2}} .. {{Col-5}}
{{Col-end}}
"Col-float" CSS float Yes Yes {{Col-float}} {{Col-float-break}} {{Col-float-end}}
"Columns" Table No Yes {{Columns}}
"Columns-list" CSS columns Yes Yes {{Columns-list}} (wrapper)
"Columns-start" CSS float Yes Yes {{Columns-start}} {{Column}} {{Columns-end}}
"Flex columns" CSS flexbox Yes Yes {{Flex columns}}
"Div col" CSS columns Yes Yes {{Div col}} {{Div col end}}

Script error: No such module "If empty". I.e., can the columns handle the wiki markup {| | || |- |} used to create tables? If not, templates that produce these elements (such as {{(!}}, {{!}}, {{!!}}, {{!-}}, {{!)}}) or HTML tags (<table>...</table>, <tr>...</tr>, etc.) will need to be used instead.<section end="table" />