WikiQueer:Manual of Style/Tables
| This guideline is a part of the English WikiQueer's Manual of Style. Use common sense in applying it; it will have occasional exceptions. Please ensure that any edits to this page reflect consensus. |
|
|
|---|
|
|
|
|
|
|
Tables are a way of presenting links, data or information in rows and columns. They can be useful for a variety of content presentations on WikiQueer, though should be used only when appropriate; sometimes the information in a table may be better presented as prose paragraphs or as an embedded list.
Contents |
[edit] Formatting
It is recommended that wikitables be used in place of HTML tables, as they are easier to customize and maintain. A standard "wikitable style" is also available, by adding class="wikitable" to the top row of the table.
Tables can be made sortable by adding class="wikitable sortable" to the top row. Sortable tables cannot contain any merged cells using rowspan; extreme caution should be applied if colspan is used.
[edit] Captions and headings
Table captions and column/row headings should be succinct and self-explanatory. In most cases, individual words or sentence fragments should be used, and articles (a, an, the) are unnecessary. Only the first word in the caption or heading should be capitalized (except for proper nouns), in keeping with WikiQueer's conventions for capital letters.
[edit] Appearance
In general, styles for tables and other block-level elements should be set using CSS classes, not with inline style attributes. This is because the site-wide CSS is more carefully tested to ensure compatibility with a wide range of browsers; it also creates a greater degree of professionalism by ensuring a consistent appearance between articles. Deviations from standard conventions are acceptable where they create a semantic distinction but should not be used gratuitously.
See WQ:Deviations and WikiQueer talk:Consensus/RfC for guidance on use of colouring or non-standard formatting, and for when MoS and WikiProjects guidance is at variance.
Consideration may be given to collapsing tables which consolidate information covered in the prose.
[edit] Accessibility
Screen readers and other web browsing tools make use of specific table tags to help users navigate the data contained within them. Use the correct wikitable pipe syntax to take advantage of all the features available.
Do not separate items by leaving blank lines between them, even when using unordered or definition lists.
[edit] Size
Splitting lists and tables per summary style is advised against.
Too much statistical data is against policy.
[edit] When tables are appropriate
Tables are a way of presenting links, data or information in rows and columns. They are a complex form of list. Tables might be used for presenting mathematical data such as multiplication tables, comparative figures, or sporting results. They might also be used for presenting equivalent words in two or more languages; for awards by type and year; complex discographies; etc.
Often a list is best left as a list. Before you format a list in table form, consider whether the information will be more clearly conveyed by virtue of having rows and columns. If so, then a table is probably a good choice. If there is no obvious benefit to having rows and columns, then a table is probably not the best choice.
Tables should not be used simply for layout, either. If the information you are editing is not tabular in nature, it probably does not belong in a table: Try not to use tables for putting a caption under a photograph, arranging a group of links, or other strictly visual features. It makes the article harder to edit for other WikiQueerians. Also, when compared with tables, wikimarkup is more flexible, easier to use, and less esoteric when used for desktop publishing, page elements, and page orientation and positioning.
Examples:
| Sporting results | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Discographies | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Multiplication tables | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Cladograms | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Flow data |
|---|
|
<timeline> ImageSize = width:700 height:270 PlotArea = left:100 bottom:60 top:0 right:50 Alignbars = justify DateFormat = mm/dd/yyyy Period = from:01/01/1965 till:12/05/1996 TimeAxis = orientation:horizontal format:yyyy Colors = id:Drums value:purple legend:Drums id:Guitars value:green legend:Guitars id:Bass value:gray(0.40) legend:Bass id:Keyboards value:orange legend:Keyboards Legend = orientation:horizontal position:bottom ScaleMajor = increment:2 start:01/01/1965 LineData = at:08/04/1967 color:black layer:back at:06/28/1968 color:black layer:back at:06/13/1969 color:black layer:back at:11/07/1969 color:black layer:back at:10/02/1970 color:black layer:back at:11/05/1971 color:black layer:back at:06/02/1972 color:black layer:back at:03/23/1973 color:black layer:back at:11/12/1975 color:black layer:back at:01/21/1977 color:black layer:back at:11/30/1979 color:black layer:back at:03/21/1983 color:black layer:back at:11/07/1987 color:black layer:back at:03/28/1994 color:black layer:back BarData = bar:Mason text:"Nick Mason" bar:Barrett text:"Syd Barrett" bar:Gilmour text:"David Gilmour" bar:Klose text:"Bob Klose" bar:Waters text:"Roger Waters" bar:Wright text:"Richard Wright" PlotData= width:10 textcolor:black align:left anchor:from shift:(10,-4) bar:Mason from:01/01/1965 till:end color:Drums bar:Barrett from:01/01/1965 till:06/04/1968 color:Guitars bar:Gilmour from:12/01/1967 till:end color:Guitars bar:Klose from:01/01/1965 till: 12/05/1965 color:Guitars bar:Waters from:01/01/1965 till:01/20/1985 color:Bass bar:Wright from:01/01/1965 till:01/01/1980 color:Keyboards bar:Wright from:01/01/1987 till:end color:Keyboards </timeline> |
[edit] When tables may not be appropriate
[edit] Simple lists
If a list is simple, it is generally better to use one of the standard WikiQueer list formats instead of a table. Lists are easier to maintain than tables, and are often easier to read.
Here is an example of a simple list using list formatting:
* 1980: Ultra Wave * 1988: What's Bootsy Doin'? * 1994: Blasters of the Universe * 1994: Fresh Outta 'P' Uni
Which produces:
- 1980: Ultra Wave
- 1988: What's Bootsy Doin'?
- 1994: Blasters of the Universe
- 1994: Fresh Outta 'P' Uni
versus table formatting:
{|class="wikitable1" |1980 |Ultra Wave |- |1988 |What's Bootsy Doin'? |- |1994 |Blasters of the Universe |- |1994 |Fresh Outta 'P' Uni |}
Which produces:
| 1980 | Ultra Wave |
| 1988 | What's Bootsy Doin'? |
| 1994 | Blasters of the Universe |
| 1994 | Fresh Outta 'P' Uni |
[edit] Prose
Prose is preferred in articles as prose allows the presentation of detail and clarification of context, in a way that a table may not. Prose flows, like one person speaking to another, and is best suited to articles, because their purpose is to explain. Tables which are mainly links, which are most useful for browsing subject areas, should usually have their own entries: see WikiQueer:Stand-alone lists for detail. In an article, significant items should normally be mentioned naturally within the text rather than merely tabulated.
[edit] Page layout
Page layouts (using multiple columns, positioning elements, adding borders, etc.) should be done via CSS, not tables, whenever possible.
- Images and other embedded media should be positioned using standard image syntax.
- There are several templates available that will create preformatted multi-column layouts: see Help:Columns.
- Other elements can be positioned or given special formatting through the use of the HTML
<div>element and CSS styling.
[edit] See also
- Help:Table, extensive help
- Help:Wikitable, quick help
- WikiQueer:Table namespace, an inactive proposal
- Help:Collapsing (show/hide button)
- WikiQueer:Conditional tables
