Template:Table/documentation: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 8: Line 8:
Here is an example of what a generic table looks like when you use this template.   
Here is an example of what a generic table looks like when you use this template.   


{| {{Table|35}}
{| {{table|20%}}
! Column 1
! Column 1
! Column 2
! Column 2
Line 20: Line 20:


==Usage==
==Usage==
To use this template, type the code '''<nowiki>{{table|XX}}</nowiki>''' 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 auto-adjust to fit the contents of the table (this may look just right or too crowded, depending on the contents of the table). For example, below is the code for the example table shown above.
To use this template, type the code '''<nowiki>{{table|XX}}</nowiki>''' 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.


<pre>{| {{table|35}}
<pre>{| {{table|20%}}
! Column 1
! Column 1
! Column 2
! Column 2
Line 37: Line 37:
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.
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.


{|{{table}}
{|{{table|50%}}
!You Type
!You Type
!You Get
!You Get
Line 43: Line 43:
|style="text-align:left;"|Merge rows and columns
|style="text-align:left;"|Merge rows and columns
<pre>
<pre>
{| {{table}}
{| {{table|30%}}
!colspan="2"| Column 1
!colspan="2"| Column 1
|-
|-
Line 53: Line 53:
|}</pre>
|}</pre>
||
||
{| {{table}}
{| {{table|30%}}
!colspan="2"| Column 1
!colspan="2"| Column 1
|-
|-
Line 65: Line 65:
|style="text-align:left;"|Change text justification
|style="text-align:left;"|Change text justification
<pre>
<pre>
{| {{table}}
{| {{table|20}}
!Column 1
!Column 1
!Column 2
!Column 2
Line 76: Line 76:
|}</pre>
|}</pre>
||
||
{| {{table}}
{| {{table|20}}
!Column 1
!Column 1
!Column 2
!Column 2
Line 89: Line 89:
|style="text-align:left;"|Change column widths
|style="text-align:left;"|Change column widths
<pre>
<pre>
{| {{table}}
{| {{table|20}}
!Column 1
!Column 1
!Column 2
!Column 2
Line 100: Line 100:
|}</pre>
|}</pre>
||
||
{| {{table}}
{| {{table|20}}
!Column 1
!Column 1
!Column 2
!Column 2

Revision as of 19:07, 10 June 2014


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.