Editing Template:Variant table/doc

This Template creates a collapsible table summarizing how an Action or Storylet varies based on the player's qualities. 

==Usage==
The '''Condition''' argument names the Quality that the Option or Storlet. The '''Effect''' argument describes what the type of change, such as "Title" or "Second paragraph of Description." The value of these two parameters are displayed as column headers in the table. Cells in the ''N''th row of the table are set with matching pairs of '''Value ''N''''' and '''Effect ''N''''' parameters. If '''Value ''N''''' is supplied, but '''Effect ''N''''' isn't, the template will set the tracking category [[:Category:Pages with missing variant text]]. (This also supports the '''Second effect''' parameters and the '''Compact''' style, see below.)

The table usually summarizes the effect of one of the player's Qualities, and each row lists the game outcome of one value (or range of values) that Quality can take. The '''Condition type''' argument should be either "Text" or "Math," depending on whether depending on whether the game effect is textual (such as a title or description), or numeric (such as a challenge rating). If not set, '''Condition type''' defaults to "Text."

===Advanced Parameters===
The value of the '''Condition''' parameter is used to generate links and Categories. The '''Condition alias''' parameter can be used to change how the Condition Quality appears when displayed in the header row. If not supplied, the Quality is displayed as its own name. If no Quality is supplied, the column header will be "Condition."

In cases where the values are always simple (like plain numbers), the '''Compact''' parameter can save redundant typing. When this parameter is set, then parameter '''Value ''N''''' on its own creates a matching pair of '''''N''''' and the value of the parameter, and the '''Effect ''N''''' parameter is not used. In other words, <code><nowiki>|Value N = Foo</nowiki></code> is shorthand for <code><nowiki>|Value N = N|Effect N = Foo</nowiki></code>. Compact values are only allowed for Text or Math condition types.

Sometimes a single Quality has multiple effects on the page, such as altering both the title and description. A third column can be added, with a header set by '''Second effect''' and values set by '''Second effect ''N'''''.

Occasionally, the table summarizes the effects of multiple Qualities, and each row lists the impact of an individual quality. In this case, the '''Condition type''' should be "Quality." The '''Value ''N''''' parameter is used to create links and Categories, and the '''Alias ''N''''' parameter can be used to change how it is displayed. The '''Alias ''N''''' parameter has no effect unless the '''Condition type''' is "Quality." An effect caused by the absence of any relevant quality can be represented by the '''Value ''N''''' parameter being present but empty.

Depending on the '''Condition type''', values supplied to the '''Condition''' or '''Value ''N''''' parameters are used to create links and add categories. To suppress this behavior (or manually create your own links and categories), set '''Condition type''' to "Raw."

==Best Practices==
When this table is used to describe variation in the text that is in the Description field of some Template, it should be placed in a way that comes after that Template, as closely as possible. Depending on the particular Template, this may mean the Wiki Note field, or immediately after the Template. Use in Summary fields is discouraged because that field represents player summaries of the truncated Description text, but sometimes it is the best available option. Note that the table does not appear when a page is transcluded via the {{t|Options}} Template.

Keep a single table focused. If you are having trouble fitting more data into a single table, consider splitting it into multiple tables. This template intentionally does not support more than three columns, multiple Condition Types, or intermediate header rows. 

The Value ''N'' and Effect ''N'' arguments for a single ''N'' should be grouped together (with other ''N'' arguments, if applicable), and ''N'' should increase down the page. Out-of-order arguments will still display correctly, but please don't make it harder on other editors. The value of ''N'' should either increment per row, or match the value being displayed.

==Examples==

For several straightforward (albeit large) examples of this template for text and number information, see [[Persuade Furnace]].

For an example with multiple effects, see [[Diving in the Magistracy]].

For an example where each row is a separate quality, see [[Plan the next route across a ravine]].
<templatedata>
{
	"description": "A table showing how this Action or Storylet varies based on the player's qualities.",
	"params": {
		"Condition": {
			"label": "Condition",
			"description": "Name of the Quality whose value has a game impact.",
			"required": false,
			"suggested": true,
			"default": "Condition",
			"type": "wiki-page-name"
		},
		"Condition alias": {
			"aliases": [
				"Condition appearance"
			],
			"label": "Condition alias",
			"description": "How the condition will be displayed on the header row.",
			"required": false,
			"suggested": false,
			"default": "The Condition name if provided, or 'Condition' otherwise",
			"type": "line"
		},
		"Condition type": {
			"label": "Condition type",
			"description": "The type of effect the condition causes. Should be one of Text, Math, Quality, or Raw.",
			"required": false,
			"suggested": true,
			"default": "Text",
			"type": "string"
		},
		"Condition nowrap": {
			"label": "Condition nowrap",
			"description": "If set to 'yes', nowrap will be applied to the Condition header. Disabling this can create some surprising behaviour when a table is expanded or collapsed so it's rarely useful to do so.",
			"required": false,
			"suggested": false,
			"default": "yes",
			"type": "string"
		},
		"Value N": {
			"label": "Nth Value",
			"description": "A value or range of values the quality may take. Represents one row in the table.",
			"required": true,
			"type": "line"
		},
		"Alias N": {
			"aliases": [
				"Appearance N"
			],
			"label": "Nth Value Alias",
			"description": "How the value for the Nth row should be displayed. Only use if the Condition type is Quality.",
			"required": true,
			"type": "line"
		},
		"Effect": {
			"label": "Effect",
			"description": "Description of the effect caused by the player's qualities.",
			"suggested": true,
			"default": "Effect",
			"type": "line"
		},
		"Second effect": {
			"label": "Second effect",
			"description": "Description of the second effect caused by the quality, if there is one.",
			"type": "line"
		},
		"Effect N": {
			"label": "Nth Effect",
			"description": "The observed effect when the Quality has Value N.",
			"suggested": true,
			"type": "string"
		},
		"Second effect N": {
			"label": "Other Nth Effect",
			"description": "The second effect when the Quality has Value N.",
			"suggested": false
		},
		"Compact": {
			"label": "Compact arguments",
			"description": "When present, Effect N can be elided. Instead the Value of Value N is N, and the Effect is the value of that parameter.",
			"type": "boolean",
			"default": "Not compact"
		},
		"Show Unaccounted": {
			"label": "Display Unaccounted numbers",
			"description": "If \"yes\", add a Wiki Note listing numbers missing from the table.",
			"type": "string",
			"default": "no"
		},
		"Unaccounted Max": {
			"label": "Unaccounted maximum value",
			"description": "[Display Unaccounted functionality] The maximum value the table should probe for (100 for most Airs)",
			"type": "number",
			"default": "100"
		},
		"Unaccounted Min": {
			"label": "Unaccounted minimum value",
			"description": "[Display Unaccounted functionality] The minimum value the table should probe for (1 for most qualities)",
			"type": "number",
			"default": "1"
		},
		"Truncate": {
			"label": "Truncate",
			"description": "If set to \"no\", the effects will not be subject to the 250-charcter limit. (Use for non-narrative variant texts like Game Instructions.)",
			"type": "string",
			"default": "yes"
		}
	},
	"format": "block",
	"paramOrder": [
		"Condition",
		"Condition alias",
		"Condition type",
		"Condition nowrap",
		"Value N",
		"Alias N",
		"Effect",
		"Second effect",
		"Effect N",
		"Truncate",
		"Second effect N",
		"Compact",
		"Show Unaccounted",
		"Unaccounted Min",
		"Unaccounted Max"
	]
}
</templatedata>
<noinclude>[[Category:Template documentation]]</noinclude>