Template:Table/documentation

From ReliaWiki
Jump to navigation Jump to search


Template Documentation

This template contains table formats that can be applied to any existing table in ReliaWiki. It does not automatically create a table for you; rather it ensures that any table where the template is transcluded into will have consistent looking borders, cell padding, header shading and text alignment. (If you don't know how to create a table, see the Notes section below.)

Here is an example of what a generic table looks like when you use this template.

Column 1 Column 2
Row 1 123
Row 2 456
Row 3 789

Usage

To use this template, type the code {{table|XX}} next to the table's opening brackets, where XX is the desired table width. If you do not specify a table width, the table will default to a size of 25% of the screen width. For example, below is the code for the example table shown above.

{| {{table|20%}}
! Column 1
! Column 2
|-
| Row 1||123
|-
| Row 2||456
|-
| Row 3||789
|}

Custom Designs

Below are some examples of styles you could add to a table. To learn more about manually formatting tables using wiki code, see the tutorial at http://www.mediawiki.org/wiki/Help:Tables.

You Type You Get
Merge rows and columns
{| {{table|30%}}
!colspan="2"| Column 1
|-
| Row 1||123
|-
|rowspan="2"|Row 2||456
|-
|789
|}
Column 1
Row 1 123
Row 2 456
789
Change text justification
{| {{table|20}}
!Column 1
!Column 2
|-style="text-align:left;"
|Row 1||123
|-style="text-align:right;"
|Row 2||456
|-
|Row 3 ||789
|}
Column 1 Column 2
Row 1 123
Row 2 456
Row 3 789
Change column widths
{| {{table|20}}
!Column 1
!Column 2
|- 
|Row 1||style="width: 80%;"|123
|-
|Row 2||456
|-
|Row 3 ||789
|}
Column 1 Column 2
Row 1 123
Row 2 456
Row 3 789


Notes

You can automatically convert an Excel table into the appropriate wiki code by using the free tool at http://excel2wiki.net/index.php. To ensure that the output you get from the tool works with this template, you must remove the formatting that the tool automatically assigns to the table headers. For instance, if you copy and paste our example table into the tool, the output will be:

{| {{table}}
| align="center" style="background:#f0f0f0;"|'''Column 1'''
| align="center" style="background:#f0f0f0;"|'''Column 2'''
|-
| Row 1||123
|-
| Row 2||456
|-
| Row 3||789 
|}

In this case, you must delete the formatting around "Column 1" and "Column 2" and replace them with exclamation marks (!). See the code shown in the Usage section to see what this looks like. In a table, an exclamation mark indicates a table header. Table headers appear in bold and are centered by default.