មើលកូដរបស់ ទំព័រគំរូ:Succession box/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This template creates a standard line for succession boxes.

Mostly deprecated, the ''succession box'' template ought to 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 ''{{tl|s-start}}'' series should be used instead of this one.

===Syntax===
Basic usage:
<pre style="overflow:auto;">
{{S-start}}
{{Succession box
 | title  = 
 | years  = 
 | with   =
 | before = 
 | after  = 
}}
{{S-end}}
</pre>

Full usage:
<pre style="overflow:auto;">
{{S-start}}
{{Succession box
 | title   = 
 | years   = 
 | with    =
 | with    =
 | with2   =
 | with3   =
 | with4   =
 | with5   =
 | with6   =
 | with7   =
 | with8   =
 | with9   =
 | with10  =
 | before  = 
 | before2 = 
 | before3 = 
 | before4 = 
 | before5 = 
 | after   = 
 | after2  = 
 | after3  = 
 | after4  = 
 | after5  = 
}}
{{S-end}}
</pre>

===Usage===
A succession box may start with a single {{Tld|S-start}} and end with one {{Tld|S-end}}. Alternatively, the old versions may be used, namely {{Tld|Start box}} as the initial template and {{Tld|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 {{tld|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.

==== 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]]:

<pre style="overflow:auto;">
{{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}}
</pre>

{{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}}

==== Example with multiple office-holders ====
From the article [[Richard Temple-Grenville, 2nd Duke of Buckingham and Chandos]]:

<pre style="overflow:auto;">
{{s-start}}
{{s-par|gb}}
{{succession box
 | title   = [[Member of Parliament]] for [[Buckinghamshire (UK Parliament constituency)|Buckinghamshire]]
 | with    = [[William Selby Lowndes]] 1818&ndash;1820
 | with2   = [[Robert Carrington, 2nd Baron Carrington|Robert Smith]] 1820&ndash;1831
 | with3   = [[John Smith (Wendover MP)|John Smith]] 1831&ndash;1835
 | with4   = [[Sir George Dashwood, 5th Baronet|Sir George Dashwood, Bt]] 1832&ndash;1835
 | with5   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]] 1835&ndash;1839
 | with6   = [[George Simon Harcourt]] 1835&ndash;1839
 | years   = 1818&ndash;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 Pre]]
}}
{{s-end}}
</pre>

{{s-start}}
{{s-par|gb}}
{{succession box
 | title   = [[Member of Parliament]] for [[Buckinghamshire (UK Parliament constituency)|Buckinghamshire]]
 | with    = [[William Selby Lowndes]] 1818&ndash;1820
 | with2   = [[Robert Carrington, 2nd Baron Carrington|Robert Smith]] 1820&ndash;1831
 | with3   = [[John Smith (Wendover MP)|John Smith]] 1831&ndash;1835
 | with4   = [[Sir George Dashwood, 5th Baronet|Sir George Dashwood, Bt]] 1832&ndash;1835
 | with5   = [[Sir William Young, 4th Baronet|Sir William Young, Bt]] 1835&ndash;1839
 | with6   = [[George Simon Harcourt]] 1835&ndash;1839
 | years   = 1818&ndash;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 Pre]]
}}
{{s-end}}

==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 [[Wikipedia:WikiProject Succession Box Standardization/Cheatsheet|Cheatsheet]].
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Exclude in print]]
[[Category:Succession templates|{{PAGENAME}}]]

[[ar:قالب:Succession box]]
[[az:Şablon:Vərəsəlik qutusu]]
[[cy:Nodyn:Bocs-olyniaeth]]
[[es:Plantilla:Succession box]]
[[id:Templat:Succession box]]
[[ja:Template:Succession box]]
[[ka:თარგი:Succession box]]
[[pt:Predefinição:Caixa de sucessão]]
[[ru:Шаблон:Succession box]]
[[sl:Predloga:S-polje]]
[[sv:Mall:Succession box]]
[[uk:Шаблон:Скринька наступництва]]
[[zh:Template:Succession box]]
</includeonly>