Template:Col-break/doc

Column Templates
Div col
{{Div col}}	Start
{{Div col end}}	End
Col-Break
{{Col-begin}}	Start
{{Col-break}}	Break
{{Col-end}}	End
Col-float
{{Col-float}}	Start
{{Col-float-break}}	Break
{{Col-float-end}}	End
Columns-start
{{Columns-start}}	Start
{{Column}}	Break
{{Columns-end}}	End

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 width.

{{col-break|width=66%}}: start column-1 as 66% wide.

This is text in col-1.

{{col-break|width=33%}}: start column-2 as 33% wide.

Text 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—for example, as in PBC: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:

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

{{Col-begin}} {{Col-2}} Column 1 here {{Col-2}} Column 2 here {{Col-end}}

{{Col-begin}} {{Col-3}} Column 1 here {{Col-3}} Column 2 here {{Col-3}} Column 3 here {{Col-end}}

and so on, up to {{Col-5}}

{{Col-begin}} {{Col-break}} Column 1 here {{Col-break}} Column 2 here {{Col-break}} Column 3 here {{Col-break}} Column 4 here {{Col-break}} Column 5 here {{Col-break}} Column 6 here {{Col-end}}

{{Columns-start|num=3}} Column 1 here {{Column}} Column 2 here {{Column}} Column 3 here {{Columns-end}}

Examples

Here are some example codes that you can use to make columns of text in your PBC 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:

Production by year 1980 50,000 1990 75,000 2000 90,000

Profit by year 1980 $6,000 1990 $7,500 2000 $8,200

  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:

Production by year 1980 50,000 1990 75,000 2000 90,000

Profit by year 1980 $6,000 1990 $7,500 2000 $8,200

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

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

Production by year 1980 50,000 1990 75,000 2000 90,000

Profit by year 1980 $6,000 1990 $7,500 2000 $8,200

  Example 5, Lots of columns, using col-break

Production by year 1980 50,000 1990 75,000 2000 90,000

Profit by year 1980 $6,000 1990 $7,500 2000 $8,200

Revenue by product Widgets $25,000 Foos $65,500 Bars $28,000

See also

Column-generating template families

Family	Type	Handles wiki  table code?	Start template	Column divider	End template
"Col"	Table	style="text-align:center;"	{{Col-begin}} or {{Col-begin-small}}	{{Col-break}} {{Col-2}} .. {{Col-5}}	{{Col-end}}
"Columns"	Table	style="text-align:center;"	{{Columns}}	–	–
"Col-float"	CSS float	style="text-align:center;"	{{Col-float}}	{{Col-float-break}}	{{Col-float-end}}
"Columns-start"	CSS float	style="text-align:center;"	{{Columns-start}}	{{Column}}	{{Columns-end}}
"Div col"	CSS columns	style="text-align:center;"	{{Div col}} – {{Columns-list}} (wrapper)	–	{{Div col end}}

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

External links

This template is a self-reference and so is part of the PBC project rather than the encyclopedic content.

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools.

Col-break

This template triggers the start of each column in a multi-column table.

Template parameters

Parameter		Description	Type	Status
Column width	width	Width of the column, defined as a percent (ie 50%)	String	optional