Template:Table/documentation: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
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 default to a size of 25% of the screen width. 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 auto-adjust to fit the contents &mdash; this may be just right or too crowded, depending on the content. For example, below is the code for the example table shown above.


<pre>{| {{table|20%}}
<pre>{| {{table|20%}}
Line 33: Line 33:
|}</pre>
|}</pre>


'''Custom Designs'''
'''Custom Formatting'''


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 formatting a table. For more examples, see the tutorial at http://www.mediawiki.org/wiki/Help:Tables.


{|{{table|50%}}
{|{{table|50%}}
Line 41: Line 41:
!You Get
!You Get
|-
|-
|style="text-align:left;"|Merge rows and columns
|style="text-align:left;width: 50%;"|'''Merge rows and columns'''
<pre>
<pre>
{| {{table|30%}}
{| {{table|45%}}
!colspan="2"| Column 1
!colspan="2"| Column 1
|-
|-
Line 53: Line 53:
|}</pre>
|}</pre>
||
||
{| {{table|30%}}
{|{{table|45%}}
!colspan="2"| Column 1
!colspan="2"| Column 1
|-
|-
Line 63: Line 63:
|}
|}
|-
|-
|style="text-align:left;"|Change text justification
|style="text-align:left;"|'''Change text justification'''
<pre>
<pre>
{| {{table|20}}
{| {{table|45%}}
!Column 1
!Column 1
!Column 2
!Column 2
Line 76: Line 76:
|}</pre>
|}</pre>
||
||
{| {{table|20}}
{| {{table|45%}}
!Column 1
!Column 1
!Column 2
!Column 2
Line 87: Line 87:
|}
|}
|-
|-
|style="text-align:left;"|Change column widths
|style="text-align:left;"|'''Change column widths''' (In this example, the 70% is counted from the 60% of the table width)
<pre>
<pre>
{| {{table|20}}
{| {{table|60%}}
!Column 1
!Column 1
!Column 2
!Column 2
|-  
|-  
|Row 1||style="width: 80%;"|123
|Row 1||style="width: 70%;"|123
|-
|-
|Row 2||456
|Row 2||456
Line 100: Line 100:
|}</pre>
|}</pre>
||
||
{| {{table|20}}
{| {{table|60%}}
!Column 1
!Column 1
!Column 2
!Column 2
|-  
|-  
|Row 1||style="width: 80%;"|123
|Row 1||style="width: 70%;"|123
|-
|-
|Row 2||456
|Row 2||456

Revision as of 19:58, 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 auto-adjust to fit the contents — this may be just right or too crowded, depending on the content. 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 Formatting

Below are some examples of formatting a table. For more examples, see the tutorial at http://www.mediawiki.org/wiki/Help:Tables.

You Type You Get
Merge rows and columns
{| {{table|45%}}
!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|45%}}
!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 (In this example, the 70% is counted from the 60% of the table width)
{| {{table|60%}}
!Column 1
!Column 2
|- 
|Row 1||style="width: 70%;"|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.