Template:Start box/doc

S-Start is the initial component in a template series for succession boxes. It replaces the previous formats for succession tables but still allows for most of their use indirectly. In the new format, every succession box begins with s-start, and thus it is an essential component of the new system. If anyone finds a succession template not in this standard, contact KuatofKDY.

Templates discussed on this page
This template is to be used in coordination with the following:


 * Template:start or Template:s-start — Opens a new Wikitable
 * Template:s-bef — For listing predecessors
 * Template:s-aft — For listing successors
 * Template:s-ttl — For listing titles and years
 * Template:end or Template:s-end — For closing Wikitables
 * Template:s-new — For new titles
 * Template:s-non — For no successors
 * Template:s-inc — For incumbents
 * Template:s-urp — For usurpers
 * Template:s-vac — For vacant titles (predecessor or successor)
 * Template:s-tul — For titular monarchs (legitimate but not ruling)
 * Template:s-hou — For royal house/individual information
 * Template:s-fam — For three-generation family trees
 * Template:s-cite — For citations of succession boxes
 * Template:s-line — Used for UK Underground succession boxes
 * Template:s-ref — Embedded in s-cite; no external usage.

The functions and use of each one will be analysed in the following sections.

Instructions for use
There are many types of succession boxes (from now on referred to in this text as Wikitables or just tables), as the combinations of the various templates previously mentioned are virtually endless. We will begin by demonstrating the use of simple tables, and proceed with the analysis of more complex tables of many lines and multiple titles.

Simple tables
For the purposes of this tutorial, we will call simple the tables that follow the format "predecessor, title, successor", and essentially consist of one line. As they are the easiest and most fundamental, we will begin with them.

Basic format: s-start, s-bef, s-ttl, s-aft, end
The very purpose of a succession box is to show the place of the person in question (the one whose article the box is in) in a succession of people. Because of this, most tables include three people, namely the person in question, their predecessor, and their successor.

The quintessential Wikitable consists of three boxes, which go from left to right in the same order that the three persons' terms succeeded each other: the left one names the predecessor, the middle one names the title of the person in question and the years that mark their term in an office (the person's name is already mentioned in the article's name and so is not repeated here), and the right one names the successor.

Simply enough, the creation of a table follows the same order. First comes the predecessor (template s-bef), the title and years follow (template s-ttl), and then comes the successor (template s-aft). It should not be forgotten, of course, that any succession box opens with the s-start template, and ends with the end template. Each command should be given its own line.

Have a look at this diagram.


 * Enter the start field so the program recognizes the table:
 * Enter the name of the predecessor:
 * Enter the title of the person on whose page you are working:
 * Enter the name of the successor:
 * Once everything is done, type:
 * Enter the name of the successor:
 * Once everything is done, type:
 * Once everything is done, type:
 * Once everything is done, type:

This is an example of the technique. Writing…



…will produce this:

Note the absence of double square brackets in the names of the predecessor and the successor and in the name of the title in this example; their presence allows for the names in the table to link to their respective articles, and were omitted here because these specific names do not correspond to articles in Wikipedia. Although it is strongly suggested that you do link the names in the tables even if they do not have their own article for the time being (resulting in a red link), there can be exceptions.

It is encouraged that you include the title-holder's date whenever possible; if a date is dubious or disputed, use the s-cite to include references that will back up that date (see below).

Predecessors and successors
Titles and offices do not last forever; they have to begin somewhere, and sooner or later they end. As a result, there is not always a predecessor or a successor, as a person might be the first or the last holder of an office. In addition, various events might occur, disturbing the smooth succession in an office and causing vacancies. Because of this, the previously described templates can be substituted to allow for special cases.

S-new
Titles can be created along with the birth of new states or during periods of governmental reform. The mention of a title creation is necessary when the article containing the Wikitable is about the first holder of an office, in which case there is no predecessor and the template s-new is used instead of the usual s-bef.

There is the option of entering the reason behind the title's creation, using a short sentence. If you don't want to include the reason, write only instead of the full version of the following example.

Template:s-new (with others)



Which looks like:

S-non
Many titles have expired, become extinct, or otherwise fallen into disuse. The last holders of these titles had no successors, and in such cases the template s-non is used. A short description of the reason for the discontinuation of the title's use is necessary (e.g. Extinct, Merged into crown, etc.).

The same template can be used for a title that needs description but does not fall under the other predecessor or successor forms.

This form requires |- if it is used in a complex table (see relevant section):

Template:s-non (with others)



Which looks like:

S-inc
Another occasion where there might be no successor to a title, is when the person in question is the current occupant of said office or position. To create a table for someone who is the incumbent (current title holder), use the template s-inc.

Note that you must enter the word "present" instead of an end date, as the person in question is still the holder of the title. The inclusion of an heir is optional.

Template:s-inc (with others)



Which looks like:

S-urp
Thrones and other titles can be usurped by those other than the rightful holder. In such cases, the holder of the title is not the rightful successor and may be recognised as such or not. They still undeniably exercise the powers of the title (de facto) and are part of the succession chain.

There are four versions of the s-urp template: one to show that the subject of the succession box has usurped a title from another person (from), one to show that another person has usurped the subject's title (by), one to show that the subject has reclaimed a title from an usurper (refrom) and one to show that a title was reclaimed from the subject by someone else (reby).

Template:s-urp (with others)

Example 1:



Which looks like:

Example 2:



Which looks like:

S-vac
Vacant titles are not currently held by anyone. For monarchs, such periods are often known as interregna, though vacancies can occur to any office. In case of a vacancy, the s-vac template is used. It is a rather flexible template, as this table cell can go before or after the title of the individual and is meant to designate if they have no predecessor and/or successor, although the title is not extinct.

If the last or next title holder are known, that information can be filled into the form.

Template:s-vac (with others)

To create a table that begins with a vacant title, use this:



Which looks like:

To create a table that ends with a vacant title, use this:



Which looks like:

In multiple row tables (see relevant section) it is necessary to add |- after a line that ends with this template, so that the computer can recognise the new row (unless the line that ends with s-vac is the last one in the Wikitable).

Titles and offices
The s-bef and s-aft templates are not the only ones to be substituted in occasions. There are three alternatives to the simple s-ttl template, for the event when a person does not hold a title in the usual way.

Regents
Often in history, some offices were held by more than one person at a time. The most common example of this is a regency, when a monarch rules with the aid of another person, like the joint occupation of the throne of England by Mary II and her husband, William III, from their accession in 1989 until her death in 1694. The standard s-ttl template is used in this case, and the regents are entered in the way demonstrated below.

The inclusion of the regents is always optional, as are the dates of their reign and those of the title holder's reign. This template currently supports up to three regents, as there can be more than one regent at a time, or a regent may be succeeded by another. In order to allow the reader make sense from complex regencies, inclusion of dates is at least preferred in such cases.

Template:s-ttl with regents parameters (with other templates)


 * |regent2= Title of regent |years2= Insert years here }}
 * |regent3= Title of regent |years3= Insert years here }}
 * |regent2= Title of regent |years2= Insert years here }}
 * |regent3= Title of regent |years3= Insert years here }}
 * |regent3= Title of regent |years3= Insert years here }}

Which looks like:

Lords
Members of the House of Lords, the upper house of the Parliament of the United Kingdom, have never been elected; instead, they were hereditary for the greater part of the House's existence, and most of them are nowadays appointed. Although seats in the Lords cannot be tracked by succession boxes, the titles that used to grant them were, and so a label may be added to succession boxes of peers that were members of the House of Lords. This template is optional and works more or less like the above described one for regents.

Template:s-ttl with the lords parameter (with other templates)



Which looks like:

It is suggested that you should not link the years in the label, to avoid cluttering the succession box.

S-tul
There are two categories of people who have regnal titles but not the power connected to them: titular rulers and pretenders.

Titular rulers are people who legitimately deserve a title yet are somehow incapable of securing it, as in the case of Louis XVII of France, heir to the throne during the early years of the French Revolution. Titular rulers generally mean that their title will again be inherited by someone with power and remains only temporarily suspended. There is generally only one titular claimant to a title.

Pretenders are people who may or may not have a rightful claim to a title, but regardless do not possess any legitimate authority. Perhaps the most famous pretenders were Prince James Francis Edward Stuart and his son, Bonnie Prince Charles, who were respectively known to the Jacobites as James III and VIII and Charles III but nicknamed by others the Old Pretender and the Young Pretender. While James Stuart was the legitimate heir to his father, the Glorious Revolution irrevocably overruled that power in favour of his half-sister. Therefore, he lost his legitimacy to govern but still claimed his hereditary titles, as did his son. Pretenders are not always successive, as titular leaders generally are, and there can be multiple pretenders at the same time (as in France's Legitimists and Orleanists).

In cases of titular rulers or pretenders, use the s-tul template. It is possible to include a reason for the inability of the title-holder to exercise their power, but this is something optional. Note that a title of a titular ruler should go under the same header as of all the other holders of that title (usually, but not always, s-reg|), while any titles held in pretence should go under the appropriate header (s-pre).

Template:s-tul (with others)



Which looks like:

Optional s-related templates
In addition to the three basic templates (s-bef, s-ttl, and s-aft) and their substitutes, there are four kinds of templates that may be completely omitted from a Wikitable depending on the circumstances. These include templates s-hou, s-fam, and s-cite, and an assortment of header templates.

S-hou
This template is generally for use with monarchs or other rulers. It is placed at the top of a succession list, directly beneath the s-start, and establishes which royal house a person belongs to, giving their birth and death dates. If you do not know the day and month, leave a | and fill out the rest (leaving the space for the unknown date blank). For unknown birth or death dates, type Unknown; for living people, type Living. If there is such information available, you may also include the cadet branch information for the royal house. For more questions concerning this topic, see Cadet branch.

Template:s-hou (with others)



Which will look something like this:

In case you do not want to include any birth and death date information, you can use an alternate table produced by the template s-hno which will only ask for the house and the optional cadet branch information.

S-hno
Sometimes there are no dates available for an individual. To allow for this issue, a secondary template, Template:s-hno, exists which is identical to the above minus the dates. If you do not know any dates for an individual, use this template. The cadet branch option is still available.

The above example with s-hno instead of s-hou is as follows:

S-fam
The question of succession often comes up in succession lists, especially in those of royal families. To trace that, template s-fam allows for a three-generation family tree to be added to any succession box, placing it after all the titles listed. In the third generation (the individual's grandparents), there is a second option to include the family or royal house (if any) for each individual. Wikilinks are appreciated on all family members and houses if available. All family trees must be sourced via s-cite (see below).

To add a family tree, type:

It will look like this when completed:

S-cite
Template s-cite is for the purpose of sourcing a succession table. Considering the effort put by Wikipedia to qualify all articles on the site, this template should be used in all succession boxes whenever possible. It is designed to host individual references based on whatever medium preferred, except, of course, other Wikipedia article links; Wikipedia should not be used to verify itself. To use:

After completing a succession box, instead of end, type the following: After adding, you do not need to add template end to close the succession box, as that is included in this template.

It will result in this added to the bottom of any succession box:

Headers
There are various headers that can be placed in Wikitables to sort the various titles into categories. Although they are usually used in multiple row tables in order to distinguish the various titles and lessen the feeling of confusion created to the reader by a large table, they might be used for plain, one-row tables as well (especially in succession boxes for regnal titles, titles of nobility, and parliamentary seats).

Some of these headers can be further specialised with the use of parameters (e.g. s-par|us-lwr produces "United States House of Representatives", while s-par|eu produces "European Parliament"). Further information about the use of headers and the categorisation of titles in general can be found in the /Guidelines subpage of WikiProject Succession Box Standardization.

The headers are:


 * — Awards (Prestigious regular awards like Academy Awards etc.)
 * — Business positions (CEOs of large corporations etc.)
 * — Police appointments, like Commissioners etc. (this is an example; the template is used for civic offices in general and is specialised with parameters)
 * — Diplomatic posts (Ambassadors etc.)
 * — Cultural, educational, and academic offices (Senior positions in major institutions and organisations)
 * — Government offices (Appointed governors, civil servants etc.)
 * — Heraldic offices (Kings of Arms, Heralds etc.)
 * — Honorary offices (This is a vague description and should be used with caution)
 * — Legal offices (Solicitors general, district attorneys etc.)
 * — Media offices (Important positions in large newspapers, TV channels etc.)
 * — Military offices (Chiefs of Staff, Commanders-in-Chief etc.) Used for army, navy and air force appointments.
 * — Political offices
 * — Parliament of the United Kingdom (Members of the House of Commons only. The s-par applies generally to parliaments and is specialised with parameters)
 * — Party political offices (Party leaders etc.)
 * — Titles in pretence (Includes all titles held in pretence)
 * — Order of precedence (Can be further specialised)
 * — Records holders
 * — Regnal titles (Can be further specialised for titles of nobility)
 * — Religious posts in various religions (This is an example; the template is used with parameters)
 * — Various titles within royal families (Can be further specialised for different royal families)
 * — Sporting positions (Champions, sport award winners etc.)
 * — Other offices (Not belonging to any other category)

Here are examples for each of the above (in order):

Complex tables
Many people, like monarchs and Prime Ministers, active businesspeople, prominent scientists and talented athletes have held more than one offices and/or titles in their life. As it would be unwieldy to create separate tables for all those titles, we include all of them in one table. Thus, each article has one table at the bottom, which is easier to manage and more aesthetically pleasing.

Complex tables can be sorted into two groups. The first group contains tables that consist of the plain tables examined in the previous section. The second group contains more advanced tables with a more complicated structure. For the purposes of this tutorial, the tables of the first group will be called multiple row tables and the ones of the second group will be termed advanced tables.

Multiple row tables
As has been mentioned, Wikitables that consist of many separate lines are made up of the previous section's simple tables, and thus their creation follows more or less the same rules; the only difference is that special care should be given to the placement and relative order of said simple tables.

Generally, in tables with many rows, it is necessary to place |- between every row on the list. However, this text is already imbedded into most of the templates, so it is no longer necessary to add it to multiple row tables. The sole exception is the template s-vac: if a line ends with this template, you need to place this character or the computer will not recognize a new row.

An example of the way multiple row tables work is this:



Which will look something like this:



Advanced tables
Sometimes, a person might inherit more than one titles from a single individual, and/or pass multiple titles on to one person. The several separate crowns of the Commonwealth Realms, held by the same Queen, are one good example (see Elizabeth II of the United Kingdom). It is also possible that someone might take over an office from two different people who had held it jointly until then.

For these, and other scenarios, it is possible to create Wikitables that can show clearly those connections by making use of the advanced features of the new succession box model. The system for the advanced tables is a little different from the simple forms demonstrated in the previous sections, and it relies heavily on the |- character, as well as on the correct counting of the rows.

Basically, the format is the following: if a box is taking up more than one rows of the table, it can be specified how many rows exactly that will be by creating a row marker in the field immediately following the s-… field. That can be done by typing:



The number corresponds to the number of rows this name or title overlaps in regard to the other rows. Lists of title-holders are usually in order of the granting of the title, beginning with the oldest titles held. All successive titles should be noted, though titles tied together permanently can be listed in the same field.

An example of the way advanced tables work is this:



Which will look something like this:





Complete example
Using the rows feature of the templates, very advanced tables can be created to help in situations with people who hold many posts, especially British Prime Ministers. The following is a hypothetical chart with at least one use of all the forms above:









ar:قالب:بداية صندوق fr:Modèle:Start box sl:Predloga:S-začetek