Modul:AutosortTable/doc

Usage

This module helps create data tables in an automatically sorted order. As of this writing it is used primarily for the generation of the huge, dynamic tables at list of Wikipedias and Wikipedia:List of Wikipedias. For the Wikipedia editions table, the module is invoked directly to create the framework for the table, followed by content for the rows within the module's invocation. For the Edition details table, the module is invoked directly to create the framework for the table while the template {{Statistik Wikipedia}} generates content for the individual rows, also within the module's invocation. The template {{Statistik Wikipedia}} is intended to be called as an argument within the module's invocation, as it does not produce the regular wikitable (or any standard table) code itself.

The module's arguments are:

{{#invoke:AutosortTable|create|class=|style=|separator=|order=|numeric=|descending=|hidden=|caption=|rowheader=
|header = 
|footer = 
|colstyle = 
}}

Module arguments

Argument	Example	Notes
function	create	The argument create is the only function of this module, and is required.
class	class=wikitable	Class for the entire table. Table can be made user-sortable by including the class "sortable", but does not need to be.
style	style=width: 50%;	CSS for the entire table
separator	separator=--	Separator string used to separate cells in the data definition. The pipe (|) is an invalid separator for this module.
order	order=3, 2	Order for auto-sorting preference, takes a comma-separated list of column numbers. In the example here, the table will be sorted by column 3 first, then by column 2.
numeric	numeric=2	Columns which use numeric sorting when auto-sorted. Takes comma-separated list of column numbers.
descending	descending=3	Columns for which the auto-sort order should be descending (otherwise, ascending is used). Takes comma-separated list of column numbers. Here, only the third column will be auto-sorted in descending order (e.g., Zebra, Walrus, Muskrat, Emu, etc., or 12, 9, 6, 4).
hidden	hidden=2	Columns which are not to be displayed (even though they may be used for row-sorting purposes). Takes comma-separated list of column numbers. Here, the second column will not be shown.
caption	caption=Notable people by age	Caption to be used for the table, per MOS:ACCESS
rowheader	rowheader=1	Cell(s) in each non-header row to be emitted as row header, per MOS:ACCESS. Usually 1, and only 1, but accepts comma-separated list of column numbers. Causes !scope="row" to be used in the HTML for the cells specified.
header	header = -- Name -- Age	These are the column headings. In this example there are two columns with headings, the first is "Name", the second, "Age". Note the separators (--) which match the separator value above.
footer	footer =-- Country -- Population -- Density	Table footer, typically a duplication of header (see header argument above). Here, the first three columns have the footer labels shown.
colstyle	colstyle = -- text-align:left; -- text-align:right; -- -- --	Adds the specified CSS styling to entire columns. Here, the first column will be left-aligned, the second column will be right-aligned, and the next three columns (with no CSS specified) will use the default styling. Note the separators (--) which match the separator value above.

Styling tricks

While there appear to be no ways to style an individual cell when using this module, styling particular rows, columns, or the entire table can be done using CSS.

Styling the table

The style argument allows the entire table to use a default styling. For example, |style=width:70%; text-align:center; would constrain the table width to 70% of the available window, and center the text (not including column and row headers) by default. When using multiple properties, the semicolon is necessary to separate them. Do not use the quotation marks ordinarily required in CSS or wikitable markup (as in "|style=width:70%; text-align:center;"), as it causes the CSS to be disregarded. A reminder: use CSS to constrain tables sparingly, as reduced font-size or unexpected table widths may cause accessibility problems or irritate readers.

Styling a row

An individual row can be styled separately by including CSS prior to the first data cell. Consider this example table:

{{#invoke:AutosortTable|create|class=wikitable plainrowheaders sortable|separator=--|order=2|numeric=2|descending=2|caption=Old friends|rowheader=1
|header = -- Name -- Age -- Diet                    <!-- Table header -->
| -- Maria -- 36 -- Vegan                           <!-- Row 1 -->
| -- Peter -- 35 -- Vegetarian                      <!-- Row 2 -->
| -- Julia -- 35 -- Meat                            <!-- Row 3 -->
| -- James -- 50 -- Vegan                           <!-- Row 4 -->
| background-color: #FFDDDD -- Henry -- 45 -- Meat  <!-- Row 5, with CSS -->
| -- Ireni -- 47 -- Fish, no meat                   <!-- Row 6 -->
|colstyle = -- text-align:left; -- text-align:right; --  --  --
}}

Old friends

Name	Age	Diet
James	50	Vegan
Ireni	47	Fish, no meat
Henry	45	Meat
Maria	36	Vegan
Peter	35	Vegetarian
Julia	35	Meat

The row for "Henry" gets a pink color (#FFDDDD), while the row header appropriately retains the gray formatting wikitables use for headers.

Styling a column

An individual column can be styled separately by using CSS in the colstyle argument. In the Old friends example just above, the alignment has been set to text-align:left; and text-align:right;, respectively. Consider this similar table:

{{#invoke:AutosortTable|create|class=wikitable plainrowheaders sortable|separator=--|order=2|numeric=2|descending=2|caption=Old friends again|rowheader=1
|header = -- Name -- Age -- Diet    <!-- Table header -->
| -- Maria -- 36 -- Vegan           <!-- Row 1 -->
| -- Peter -- 35 -- Vegetarian      <!-- Row 2 -->
| -- Julia -- 35 -- Meat            <!-- Row 3 -->
| -- James -- 50 -- Vegan           <!-- Row 4 -->
| -- Henry -- 45 -- Meat            <!-- Row 5 -->
| -- Ireni -- 47 -- Fish, no meat   <!-- Row 6 -->
|colstyle = --  -- font-weight:bold; color:brown -- background-color:yellow
}}

Old friends again

Name	Age	Diet
James	50	Vegan
Ireni	47	Fish, no meat
Henry	45	Meat
Maria	36	Vegan
Peter	35	Vegetarian
Julia	35	Meat

The "Age" column entries are now in bolded brown and no longer left-aligned as in the previous example. The "Diet" column here has the specified yellow background.

Sample tables

"Wikipedia editions" example

Here is an abbreviated version of the Wikipedia editions table at list of Wikipedias. It is a manually sortable wikitable which uses the class "plainrowheaders" (no bold, not centered) for row headers (specified here as only column 1). It is auto-sorted by the sixth column ("Active users"), which is a numeric field and should be auto-sorted in descending order (highest at the top). The content of each row in the table is entered as a separate argument (starting with a pipe [|] symbol) and includes text, wikilinks, and image file links. Please view the wikicode to see the details.

Wikipedia editions

Wikipedia name in English	Wikipedia name in native language	Language	Script (ISO 15924 code)	WP code	Active users	Launch date	Logo
English Wikipedia	English Wikipedia	English	Latn	en	122.331	02001-01-1515 Januari 2001
French Wikipedia	Wikipédia en français	French	Latn	fr	17.714	02001-03-2323 Maret 2001
German Wikipedia	Deutschsprachige Wikipedia	German	Latn	de	17.404	02001-03-1616 Maret 2001

"Edition details" example

Here is an abbreviated version of the Edition details table at Wikipedia:List of Wikipedias. This table uses templates (using this module) to produce the individual rows for the table which this module will generate.

Like the above example, this is a manually sortable wikitable which uses the class "plainrowheaders" (no bold, not centered) for row headers (specified here as only column 1). However, this table is auto-sorted by the thirteenth column (based on the number of articles) which is hidden (although the same values are used again — and shown — in column 4 as "Articles"), and which is a numeric field and should be used for auto-sorting in descending order (highest at the top). The content of each row in the table is generated by the template {{Statistik Wikipedia}} and the call to that template is entered as a separate argument (starting with a pipe [|] symbol).

This table has some special alignment requirements, as it contains several columns containing large numbers, so the colstyle argument is used extensively. Please view the wikicode to see the details.

Details of Wikipedia editions

Language	Language (local)	Wiki	Articles	All pages	Edits	Admins	Users	Active users	Files	Depth	Percentage
English	English	en	6.917.844	61.937.424	1.255.661.104	851	48.342.055	122.331	930.594	1282.37	10.8%
French	français	fr	2.650.202	13.299.508	220.282.325	146	5.059.902	17.714	72.599	267.44	4.14%
Dutch	Nederlands	nl	2.172.936	4.667.436	68.290.585	30	1.375.953	3.534	20	19.28	3.39%
Russian	русский	ru	2.012.613	8.100.535	141.505.719	66	3.668.047	9.321	256.465	159.84	3.14%
Spanish	español	es	1.992.652	8.304.707	163.397.186	57	7.288.558	14.171	0	197.42	3.11%
Chinese	中文	zh	1.452.664	7.876.920	84.839.005	65	3.625.469	7.035	68.328	210.65	2.27%
Japanese	日本語	ja	1.438.798	4.225.913	102.556.561	40	2.260.791	12.448	4.744	91.07	2.25%
Arabic	العربية	ar	1.246.653	8.575.239	68.573.492	25	2.656.994	4.150	53.520	276.35	1.95%
Portuguese	português	pt	1.138.904	5.803.115	68.906.728	49	3.156.266	8.609	64.122	199.15	1.78%
Korean	한국어	ko	691.114	3.320.315	38.168.099	28	869.120	2.066	14.664	166.37	1.08%