Template:S-vac/doc

This template creates a single succession box column to be used with succession boxes.

Usage
The format is, where parameter= is replaced by one or more of the parameter names shown in the following table.

This template allows for exactly ONE "before" field, ONE "after" field, ONE "subline", and ONE "header".

IMPORTANT: All uses must be either preceded (if initial) or followed (if other rows follow) with the |- characters, lest the table not display properly.


 * "Before" fields:
 * last &mdash; Designates the last title-holder; enter the name of the last title-holder after entering this parameter.
 * unknlast &mdash; Designates the last known title-holder; enter the name of the last known title-holder after entering this parameter.
 * Note: This parameter should be used under the header: unknown.


 * "After" fields:
 * next &mdash; Designates the next title-holder; enter the name of the next title-holder after entering this parameter.
 * unknnext &mdash; Designates the next known title-holder; enter the name of the next known title-holder after entering this parameter.
 * Note: This parameter should be used under the header: unknown.


 * Sublines:
 * as &mdash; Designates a change in title; enter the title of the title-holder after entering this parameter if different than title found in s-ttl.


 * Header replacements:
 * reason &mdash; Designates the reason(s) for the vacancy; enter a short explanation after entering this parameter, if necessary.
 * abeyance &mdash; Replaces "Vacant" with "In abeyance"
 * commission &mdash; Replaces "Vacant" with "In commission"
 * disclaimed &mdash; Replaces "Vacant" with "Disclaimed"
 * dormant &mdash; Replaces "Vacant" with "Dormant"
 * extinct &mdash; Replaces "Vacant" with "Extinct"
 * forfeit &mdash; Replaces "Vacant" with "Forfeit"
 * recreated &mdash; Replaces "Vacant" with "Recreated"
 * suspended &mdash; Replaces "Vacant" with "Suspended"
 * unknown &mdash; Replaces "Vacant" with "Unknown"

This template allows for multiple row-spans using the parameter |rows=| between the template name and the first parameter.

Example
From the Charles I of England article: 

TemplateData
{   "description": "A succession-box cell for vacant titles (predecessor or successor).", "params": { "1": {           "label": "Code", "description": "Code for reason, if not specified its taken as Vacant. Can be one of - 'abeyance' or 'ab': In abeyance, 'recreated' or 're': Recreated, 'suspended' or 'su': Suspended, 'disclaimed' or 'di': Disclaimed, 'commission' or 'co': In commission, 'dormant' or 'do': Dormant, 'forfeit': Forfeit, 'unkn' or 'unknown': Unknown.", "type": "string", "required": false },       "reason": { "label": "reason", "description": "the reason(s) for the vacancy", "type": "string", "required": false },       "last": { "label": "last", "description": "Name of the last title-holder. 'last' and 'unknlast' cannot both be specified", "type": "string", "required": false },       "unknlast": { "label": "unknlast", "description": "Name of the last known title-holder, use with code as unknown. 'last' and 'unknlast' cannot both be specified", "type": "string", "required": false },       "next": { "label": "next", "description": "Name of the next title-holder, 'next' and 'unknnext' cannot both be specified.", "type": "string", "required": false },       "unknnext": { "label": "unknnext", "description": "Name of the next known title-holder, use with code as unknown, 'next' and 'unknnext' cannot both be specified.", "type": "string", "required": false },       "as": { "label": "as", "description": "Designates a change in title; enter the title of the title-holder after entering this parameter if different than title found in .", "type": "string", "required": false },       "rows": { "label": "rows", "description": "Number of table rows to span.", "type": "string", "required": false }   } }