عرض مصدر قالب:S-vac/شرح

{{صفحة توثيق فرعية}}
This template creates a single succession box column to be used with [[قالب:S-start/doc|succession boxes]].

== الاستخدام ==

The format is <code><nowiki>{{</nowiki>s-vac|''parameter=''}}</code>, 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'' — Designates the last title-holder; enter the name of the last title-holder after entering this parameter.
:''unknlast'' — 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'' — Designates the next title-holder; enter the name of the next title-holder after entering this parameter.
:''unknnext'' — 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'' — 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'' — Designates the reason(s) for the vacancy; enter a short explanation after entering this parameter, if necessary.
:''abeyance'' — Replaces "Vacant" with "In abeyance"
:''commission'' — Replaces "Vacant" with "In commission"
:''recreated'' — Replaces "Vacant" with "Recreated"
:''forfeit'' — Replaces "Vacant" with "Forfeit"
:''suspended'' — Replaces "Vacant" with "Suspended"
:''disclaimed'' — Replaces "Vacant" with "Disclaimed"
:''dormant'' — Replaces "Vacant" with "Dormant"
:''unknown'' — Replaces "Vacant" with "Unknown"

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

== مثال ==
من مقالة [[تشارلز الأول ملك إنجلترا]]:
<pre style="font-size:95%; width:95%; overflow:auto;">
{{بداية صندوق}}
{{الحكم}}
{{صندوق تعاقب/سبقه| before = [[جيمس الأول ملك إنجلترا]]}}
{{تعاقب-لقب| title = [[قائمة ملوك إنجلترا]] | years = 27 March 1625 – 30 January 1649}}
{{S-vac| next = [[تشارلز الثاني ملك إنجلترا]] | reason = [[الحرب الأهلية الإنجليزية]]}}
{{نهاية صندوق}}
</pre>
{{بداية صندوق}}
{{الحكم}}
{{صندوق تعاقب/سبقه| before = [[جيمس السادس والأول|جيمس الأول ملك إنجلترا]]}}
{{تعاقب-لقب| title = [[قائمة ملوك إنجلترا]] | years = 27 March 1625 – 30 January 1649}}
{{S-vac| next = [[تشارلز الثاني ملك إنجلترا]] | reason = [[الحرب الأهلية الإنجليزية]]}}
{{نهاية صندوق}}

== بيانات قالب ==
{{رأس بيانات القالب}}

<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
 }
 }
}
</templatedata>

== انظلا أيضاً ==
Documentation for creating succession boxes can be found at [[قالب:S-start/doc]].
<includeonly>
[[تصنيف:مستثنى من الطباعة]]

</includeonly>