عبد العزيز: بوت: تعريب V2.1

2023-09-13T11:12:17Z

صفحة جديدة

{{صفحة توثيق فرعية}}

{{اختصار قالب|BIRTH-DEATH-SORT}}
{{فهرس يمين}}

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

'''<code><nowiki>{{</nowiki>{{BASEPAGENAME}}}}</code>''' is for automatically generating all category tags related to birth and death years, including living people and missing or unknown values. The general DEFAULTSORT can be embedded as well.

: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year of birth''|''year of death''|''sort key''}}</code>

will replace:

: <code><nowiki>{{</nowiki>DEFAULTSORT:''sort key''}}</code>
: <code><nowiki>[[</nowiki>Category:''BIRTH'' births]]</code>
: <code><nowiki>[[</nowiki>Category:''DEATH'' deaths]]</code>

Other cases are handled with options, see below. As with the original, the embedded [[مساعدة:Magic words|magic word]] DEFAULTSORT also applies to all categories on the page, nomatter whether the lifetime template is before or after them.

This template supports [[مساعدة:Substitution#Optional substitution|optional substitution]]. If you want to substitute it, use the following syntax:

: <code><nowiki>{{</nowiki>'''subst:'''{{BASEPAGENAME}}|''year of birth''|''year of death''|''sort key'''''|subst=subst:'''}}</code>

Since Categories are preferred to be listed in most-common order, the {{BASEPAGENAME}} template should generally be placed after the last Category tag, for example:

: <code><nowiki>[[</nowiki>Category:ABC]]</code>
:: <nowiki>:</nowiki>
: <code><nowiki>[[</nowiki>Category:XYZ]]</code>
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|''year of birth''|''year of death''|''sort key''}}</code>

== خيارات ==

For each option, the '''default value''' is displayed in bold and automatically assumed if the field is left blank.

''Please note that MISSING results in Categories that are '''''not displayed''''' on the page.''

; 1 (birth)
:* '''MISSING''' : when year seems possible to be found.
:*: [[:Category:صفحات تحتاج تصنيف سنة الولادة]] or [[:Category:صفحات تحتاج تصنيف سنة الولادة (أشخاص أحياء)]]
:* ''year of birth'' : such as "1899" or known approximations such as "1890s" or "19th-century" (note the hyphen).
:*: [[:Category:مواليد 1899]] or [[:Category:مواليد عقد 1890]] or [[:Category:مواليد القرن 19]]

; 2 (death)
:* '''LIVING''' : living or assumed living people.
:*: [[:Category:أشخاص على قيد الحياة]]
:* MISSING : believed dead and year seems possible to be found.
:*: [[:Category:أشخاص لم تذكر تاريخ الوفاة]]
:* ''year of death'' : such as "1986" or known approximations such as "1980s" or "20th-century" (note the hyphen).
:*: [[:Category:وفيات 1986]] or [[:Category:وفيات عقد 1980]] or [[:Category:وفيات القرن 20]]

; 3 (sortkey)
:* '''<nowiki>{{</nowiki>PAGENAME}}''' : should usually never be left blank (especially with Asian names, it is hard to make the difference between a missing sortkey and a sortkey identical to the article name due to a family-first name).
:* ''Asian name, Honorific prefix (qualifier suffix)'' : for assertion of sortkey assessment.
:*: "Mao, Zedong" - "Kim, Il-sung" - "Matsuo Bashō|Matsuo, Basho" - "[[يو نو]]" - "{{Ill-WD2|Wang, Li|id=Q355614}} (politician)"
:* ''Family name, Given name, Honorific-prefix (qualifier suffix)'' : for proper sorting.
:*: "Newton, Isaac, Sir" - "{{Ill-WD2|Karlsson, Ove|id=Q2042242}} (sports journalist)"
:* For further details, see [[أرابيكا:Categorization of people#Ordering names in a category]].

Most values are case-insensitive ("LIVING" or "LiVinG" work the same), except when it matters (such as century names).

== أمثلة ==

; For a living person
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1899||Surname, Name}}</code>
or
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1899|LIVING|Surname, Name}}</code>
will replace:
: <code><nowiki>{{DEFAULTSORT:Surname, Name}}</nowiki></code>
: <code><nowiki>[[تصنيف:مواليد 1899]]</nowiki></code>
: <code><nowiki>[[تصنيف:أشخاص على قيد الحياة]]</nowiki></code>

; For a missing birth and living person
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|||Surname, Name}}</code>
or
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|MISSING|LIVING|Surname, Name}}</code>
will replace:
: <code><nowiki>{{DEFAULTSORT:Surname, Name}}</nowiki></code>
: <code><nowiki>[[تصنيف:صفحات تحتاج تصنيف سنة الولادة (أشخاص أحياء)]]</nowiki></code>
: <code><nowiki>[[تصنيف:أشخاص على قيد الحياة]]</nowiki></code>

; For a dead person
: <code><nowiki>{{</nowiki>{{BASEPAGENAME}}|1899|1986|Surname, Name}}</code>
will replace:
: <code><nowiki>{{DEFAULTSORT:Surname, Name}}</nowiki></code>
: <code><nowiki>[[تصنيف:مواليد 1899]]</nowiki></code>
: <code><nowiki>[[تصنيف:وفيات 1986]]</nowiki></code>

; Etc.

== Technical ==

Before changing the template's code or text, please bear in mind some points that should be preserved:

* The template's name and its aliases are in all-caps and feature the suffix -SORT so as to clue in editors that it embeds and replaces DEFAULTSORT. (The original alias "BD" was renamed and is unlisted for the same reason.)
* The seemingingly useless extra bars in the switch statements are for empty values.
* Extra whitespace around years doesn't matter, because page titles (category names in this case) are not sensitive to extra spaces. Calls such as <span style="white-space:pre;">{{tlx|Lifetime| 1899 | … }}</span> will produce the wikitext <tt style="white-space:pre;">[[Category: 1899 births]]</tt>, but the extra spaces do not change the effect of the link, see <span style="white-space:pre;">[[:Category:مواليد 1899]]</span>.
* Please, do not edit war by replacing DEFAULTSORT, xxxx births, yyyy deaths with this template, or the opposite.

The template provides a local sandbox and testcases for developing and testing changes (see documentation's hatnote).

== طالع أيضاً ==

* [[مساعدة:Category#Default sort key]], about categories and DEFAULTSORT
* [[مساعدة:Magic words#Parser functions]], about DEFAULTSORT technically

<includeonly>


[[تصنيف:قوالب بأسماء أجنبية]]
[[تصنيف:قوالب ترتيب|{{اسم_الصفحة}}]]

</includeonly>

قالب:Lifetime/شرح - تاريخ المراجعة

عبد العزيز: بوت: تعريب V2.1