close
Sayahna Sayahna
Search

Difference between revisions of "Template:Top/doc"


m (Typo fixing, replaced: perameters → parameters using AWB)
 
m (1 revision)
 
(No difference)

Latest revision as of 07:26, 22 August 2014

The wikitable Template:top is a first-of-three column templates when desiring to display two formatted columns side by side. It was adapted from a Wiktionary template set with the same names.

It must be used with {{Mid}} and {{Bottom}} to form a complete table of two columns.

The additional parameter (either) bgcolor or bgColor can be defined to change the default color of the template display, from the default "Transparent" color. Such an override must be applied to both {{Top}} and {{mid}} as well... or one gets columns of two different colors.

Note: For archival templates, such as {{Discussion top}}, see Category:Archival templates
Note
Hidden content above works only when included as is wikitable head end.
Default parameters
Note on the relationship between the two width parameters "width" and "width2": a width of 1% always occupies a center (empty) column, so
width (outer) must be set to satisfy the relation: width >= (2 * width2 + 1%)
border=0 (none) width=100% (overall width) width2=48% (see below, each column's width)
|-
|bgcolor= was once "#FFFFE0" (a [[web color|light yellow]]), now "transparent", 
          so takes on the page background color, whatever that may be.
Default parameters may be overridden by expressing the matching named parameter.
{| border={{{border|0}}}  width={{{width|100%}}}
|-
|bgcolor={{bgColor|{{{bgcolor|"#FFFFE0"}}}}}} valign=top width={{{width2|48%}}}|
... data within table
...
Parameters are:
bgColor or bgcolor affecting bgcolor
border             affecting border style, including color, width, etc.
width              affecting overall width, within which the inner column width is applied.
width2             setting the inner column width, should also apply same value to {{Mid}}.

Use Example shown below:

{{Top|bgcolor=lightblue}}
*The first list of items, usually bulleted links
*2...
*3...
{{Mid}} <!-- Mid must be placed in the wrap point of the table... 
        half or so above, half or so below. Contrast with {{Top2}} below.
*The second list of items, usually bulleted links
*2...
*3...
{{Bottom}}
Appearance of above example

Note that the 2nd column lacks the coloring as in column 1; color must be specified for each column, so for column 2, use: {{Mid|bgcolor=lightblue}}.


The following usage is transcluded from Template:Column templates (edit talk links history)

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

Examples

See also

Column-generating template families

Family Wiki
table
codeFile:Dagger-14-plain.png
Starting template Break between columns Ending template
"Col" {{Col-begin}}
or {{Col-begin-small}}
{{Col-break}}
{{Col-6}} or use {{Col-break|width=16.6%}}, i.e. with width ≈ 100%/6.
{{Col-7}} or use {{Col-break|width=14.2%}}, i.e. with width ≈ 100%/7.
{{Col-8}} or use {{Col-break|width=12.5%}}, i.e. with width = 100%/8.
For nine or even more columns, use {{Col-break|width=[W]%}}, where
[W] ≈ 100 divided by the number of columns desired.
{{Col-end}}
or {{End}}
"Col-float" 13pxY {{Col-float}} {{Col-float-break}} {{Col-float-end}}
"Columns" 13pxY {{Columns}}
"Columns-start" 13pxY {{Columns-start}} {{Column}} {{Columns-end}}
"Div col" 13pxY {{Div col}}
or {{Columns-list}}
{{Div col end}}
"Multicol" {{Multicol}} {{Multicol-break}} {{Multicol-end}}
"TMB" {{Top}} {{Mid}} {{Bottom}}

File:Dagger-14-plain.png 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.

External links

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