View source for Help:Columns

Long lists can be broken up into columns with very little extra work, to make content more legible.

__TOC__
== How to create multiple columns ==

Three special terms are used in the template that creates multiple-column layouts in a wiki article:

'''<nowiki>{{Col-begin}}</nowiki>''' begins the multi-column structure.<br>
'''<nowiki>{{Col-break}}</nowiki>''' indicates when to begin another column. It is followed by data items and, possibly, line breaks.<br>
'''<nowiki>{{Col-end}}</nowiki>''' ends the multi-column structure.<br>

A width parameter added to the '''Col-Begin''' designates how much space the multi-column structure takes on the page. A width paramater on the '''Col-break''' determines what proportion of the multi-column structure that an individual column requires. Listed items may be text, individual words, wiki categories, links, images, bullet points. or numbered points. Insert line breaks using '''<nowiki><br></nowiki>''' to force content onto new lines. Breaks are automatic for bullet points and numbered points on lines that begin with an asterisk or number sign.

== Example of three columns for bullet points ==

This is an example of using three columns to display bullet-point items '''in the left half''' of the space available:

{{Col-begin|width=50%}}

{{Col-break|width=33%}}
* First item
* Second item
* Third item

{{Col-break|width=33%}}
* Fourth item
* Fifth item
* Sixth item

{{Col-break|width=33%}}
* Seventh item

{{Col-end}}
<br>
<br>
'''This is accomplished by using this wiki code:'''

 <nowiki>
{{Col-begin|width=50%}}

{{Col-break|width=33%}}
* First item
* Second item
* Third item

{{Col-break|width=33%}}
* Fourth item
* Fifth item
* Sixth item

{{Col-break|width=33%}}
* Seventh item

{{Col-end}}
</nowiki>

== Example of four columns of categories ==

{{Col-begin|width=100%}}
{{Col-break|width=25%}}
[[:Category:Actors|Actors]]<br> 
[[:Category:Architects|Architects]]  

{{Col-break|width=25%}}
[[:Category:Engineers|Engineers]]<br>
[[:Category:Farmers|Farmers]]

{{Col-break|width=25%}}
[[:Category:Pāli scholars|Pāli scholars]]<br>
[[:Category:Philosophers|Philosophers]]

{{Col-break|width=25%}}
[[:Category:Politicians|Politicians]]<br>
[[:Category:Scientists|Scientists]]

{{Col-end}}
<br>
<br>
'''Here is the code creating this 4-column layout:'''

 <nowiki>
{{Col-begin|width=100%}}
{{Col-break|width=25%}}
[[:Category:Actors|Actors]]<br> 
[[:Category:Architects|Architects]]  

{{Col-break|width=25%}}
[[:Category:Engineers|Engineers]]<br>
[[:Category:Farmers|Farmers]]

{{Col-break|width=25%}}
[[:Category:Pāli scholars|Pāli scholars]]<br>
[[:Category:Philosophers|Philosophers]]

{{Col-break|width=25%}}
[[:Category:Politicians|Politicians]]<br>
[[:Category:Scientists|Scientists]]

{{Col-end}}
</nowiki>

Note that line breaks '''<nowiki><br></nowiki>''' are necessary to force new lines. The colon before each category prevents the article from being placed in that category. This article should not be placed in the category "Actors", for example, just because it mentions the category "Actors", which would happen without the colon.
<br>
<br>
== Example of English text next to French translation ==

This example is taken from the French and English versions of the website of the Canadian Theosophical Association.[http://www.theosophical.ca/]

{{Col-begin|width=100%}}

{{Col-break|width=50%}}
The Theosophical Society<br><br>
The Theosophical Society is composed of students, belonging to any religion in the world or to none, who are united by their approval of the Society's Objects, by their wish to remove religious antagonisms and to draw together men and women of goodwill whatsoever their religious opinions, and by their desire to study religious truths and to share the results of their studies with others. 

{{Col-break|width=50%}}
La Société Théosophique<br><br>
La Société Théosophique est composée d'étudiants, appartenant ou non, à l'une des religions dans le monde. Tous ses membres ont approuvé, en y entrant, les trois buts qui font son objet; tous sont unis par le même désir de mettre fin aux querelles religieuses, d'étudier les vérités enfouies dans l'obscurité des dogmes et de faire part du résultat de leurs recherches à tous ceux que ces questions peuvent intéresser. 

{{Col-end}}
<br>
<br>
'''Here is the code used to create this 2-column spread:'''

 <nowiki> 
{{Col-begin|width=100%}}

{{Col-break|width=50%}}
The Theosophical Society<br><br>
The Theosophical Society is composed of students, belonging to any religion in the world or to none, who are united by their approval of the Society's Objects, by their wish to remove religious antagonisms and to draw together men and women of goodwill whatsoever their religious opinions, and by their desire to study religious truths and to share the results of their studies with others. 

{{Col-break|width=50%}}
La Société Théosophique<br><br>
La Société Théosophique est composée d'étudiants, appartenant ou non, à l'une des religions dans le monde. Tous ses membres ont approuvé, en y entrant, les trois buts qui font son objet; tous sont unis par le même désir de mettre fin aux querelles religieuses, d'étudier les vérités enfouies dans l'obscurité des dogmes et de faire part du résultat de leurs recherches à tous ceux que ces questions peuvent intéresser. 

{{Col-end}}
</nowiki>
<br>
If you wanted to leave more space between the two columns, you could add another narrow column between, with blank text.
<br>
<br>
== Additional information ==

* Wikipedia has an article '''Template:Col-begin'''.[http://en.wikipedia.org/wiki/Template:Col-begin]
* This user forum gives some pros and cons about '''using tables and <nowiki><div></nowiki> for columnar layouts'''.[http://www.mwusers.com/forums/showthread.php?8184-Splitting-text-into-columns]
[[Category:TSWiki infrastructure]]