Template:Succession box/doc

Template page

This template creates a standard line for succession boxes.

Deprecated in favour of the s-start template series, the succession box template might be used only for the simplest succession lines. These are single succession lines showing nothing more than a succession of three people holding exactly the same title. For succession lines sharing cells with other lines, for new or expired titles, for incumbencies or vacancies, for titular rulers or pretenders, for titles which change their name before or after the subject, and for lines requiring other additional information, the specialised templates of the {{s-start}} series should be used instead of this one. For purposes of consistency and simplicity, it is preferable to use {{s-start}} series templates in all cases.

Syntax

Basic usage:

{{S-start}}
{{Succession box
 | title  = 
 | years  = 
 | with   =
 | before = 
 | after  = 
}}
{{S-end}}

Full usage:

{{S-start}}
{{Succession box
 | title   = 
 | years   = 
 | with    =
 | with2   =
 | with3   =
 | with4   =
 | with5   =
 | with6   =
 | with7   =
 | with8   =
 | with9   =
 | with10  =
 | before  = 
 | before2 = 
 | before3 = 
 | before4 = 
 | before5 = 
 | after   = 
 | after2  = 
 | after3  = 
 | after4  = 
 | after5  = 
}}
{{S-end}}

Usage

A succession box may start with a single {{S-start}} and end with one {{S-end}}. Alternatively, the old versions may be used, namely {{Start box}} as the initial template and {{End box}} as the finishing one; the two formats are compatible with each other.

Within each succession box, one or more lines may be created. One {{Succession box}} is used for each line, and parameters are used to insert data into the template: "before" for the predecessor of the subject, "title" for the subject's title, "years" for the time period during which they held the title, and "after" for the name of their successor.

Parameters

Years

Mandatory; a value is required. The value may be years or full dates. A range is not required, such as if a term of office was one year.

Usage with multiple office-holders

Where a post was held by more than one person at a time, extra parameters should be used to include them.

Predecessors
  • For multiple predecessors use "before", "before2", "before3", etc. (max 5)
Successors
  • For multiple successors use "after", "after2", "after3", etc. (max 5)
Concurrent office-holders
  • For concurrent office-holders use "with", "with2", "with3", etc. (max 25)

Examples

Example with single office-holder

From the article Winston Churchill:

{{S-start}}
{{Succession box
| before = [[Clement Attlee]]
| title  = [[Prime Minister of the United Kingdom]]
| years  = 26 October 1951 – 7 April 1955
| after  = [[Anthony Eden|Sir Anthony Eden]]
}}
{{Succession box
| before = [[Emanuel Shinwell]]
| title  = [[Minister of Defence (UK)|Minister of Defence]]
| years  = 1951–1952
| after  = [[Harold Alexander, 1st Earl Alexander of Tunis|The Earl Alexander of Tunis]]
}}
{{S-end}}
Preceded by Prime Minister of the United Kingdom
26 October 1951 – 7 April 1955
Succeeded by
Preceded by Minister of Defence
1951–1952
Succeeded by

Example with multiple office-holders

From the article Richard Temple-Grenville, 2nd Duke of Buckingham and Chandos:

{{s-start}}
{{s-par|gb}}
{{succession box
 | title   = [[Member of Parliament (United Kingdom)|Member of Parliament]] for [[Buckinghamshire (UK Parliament constituency)|Buckinghamshire]]
 | with    = [[William Selby Lowndes]] 1818–1820
 | with2   = [[Robert Carrington, 2nd Baron Carrington|Robert Smith]] 1820–1831
 | with3   = [[John Smith (Wendover MP)|John Smith]] 1831–1835
 | with4   = [[Sir George Dashwood, 5th Baronet|Sir George Dashwood, Bt]] 1832–1835
 | with5   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]] 1835–1839
 | with6   = [[George Simon Harcourt]] 1835–1839
 | years   = 1818–1839
 | before  = [[William Selby Lowndes]]
 | before2 = [[Thomas Grenville]]
 | after   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]]
 | after2  = [[George Simon Harcourt]]
 | after3  = [[Caledon Du Pré]]
}}
{{s-end}}
Unrecognised parameter
Preceded by Member of Parliament for Buckinghamshire
1818–1839
With: William Selby Lowndes 1818–1820
Robert Smith 1820–1831
John Smith 1831–1835
Sir George Dashwood, Bt 1832–1835
Sir William Young, Bt 1835–1839
George Simon Harcourt 1835–1839
Succeeded by

TemplateData

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. Click here to see a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for Succession box

This template creates a standard line for succession boxes. It is normally preceded by {{S-start}} and followed by {{S-end}}

Template parameters

This template prefers block formatting of parameters.

ParameterDescriptionTypeStatus
Titletitle

Title of the office

Example
[[Prime Minister of the United Kingdom]]
Stringsuggested
Yearsyears

The years the office held, value may be years or full dates, a range is not require if the post was only held for a year

Example
1912–1935
Stringsuggested
Beforebefore

First predecessor

Stringsuggested
before2before2

Second predecessor

Stringoptional
before3before3

Third predecessor

Stringoptional
before4before4

Forth predecessor

Stringoptional
before5before5

Fifth predecessor

Stringoptional
afterafter

First successors

Stringsuggested
after2after2

Second successors

Stringoptional
after3after3

Third successors

Stringoptional
after4after4

Forth successors

Stringoptional
after5after5

Fifth successors

Stringoptional
alongsidealongside

Used when they 'Served alongside' another person

Stringoptional
withwith

Concurrent office-holders, up to 25 people

Stringoptional
with2with2

no description

Stringoptional
with3with3

no description

Stringoptional
with4with4

no description

Stringoptional
with5with5

no description

Stringoptional
with6with6

no description

Stringoptional
with7with7

no description

Stringoptional
with8with8

no description

Stringoptional
with9with9

no description

Stringoptional
with10with10

no description

Stringoptional
with11with11

no description

Stringoptional
with12with12

no description

Stringoptional
with13with13

no description

Stringoptional
with14with14

no description

Stringoptional
with15with15

no description

Stringoptional
with16with16

no description

Stringoptional
with17with17

no description

Stringoptional
with18with18

no description

Stringoptional
with19with19

no description

Stringoptional
with20with20

no description

Stringoptional
with21with21

no description

Stringoptional
with22with22

no description

Stringoptional
with23with23

no description

Stringoptional
with24with24

no description

Stringoptional
with25with25

no description

Stringoptional
Rowsrows

Number of rows to cover

Numberoptional

See also

  • Documentation for creating more complex succession boxes can be found at Template:S-start.
  • A quick overview of the various templates and parameters of the s-start series can be found at the Cheatsheet.
  • {{Sequence}}