Template:BD/doc

This is a documentation subpage for Template:BD. It may contain usage information, categories and other content that is not part of the original template page.

This template is a shortcut to generate birth and death categories and DEFAULTSORT.

This template should be substituted.

This template should always be substituted (i.e., use {{subst:BD}}).

{{BD}} is for quickly generating category tags related to birth and death years, including living people and missing or unknown values. The general DEFAULTSORT can be embedded as well. It should not be used to replace existing DEFAULTSORT and/or category tags.

{{subst:BD|year of birth|year of death|sort key}}

will generate:

{{DEFAULTSORT:sort key}}

[[Category:BIRTH births]]

[[Category:DEATH deaths]]

Other cases are handled with options. The embedded magic word DEFAULTSORT applies to all categories on the page, no matter whether the BD template is before or after them.

This template shoukd be substituted. To substitute it, use the following syntax:

{{subst:BD|year of birth|year of death|sort key}}

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

[[Category:ABC]]

:

[[Category:XYZ]]

{{subst:BD|year of birth|year of death|sort key}}

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:Year of birth missing or Category:Year of birth missing (living people)

• year of birth : such as "1899" or known approximations such as "1890s" or "19th century".

  Category:1899 births or Category:1890s births or Category:19th century births

2 (death)

• LIVING : living or assumed living people.

  Category:Living people

• MISSING : believed dead and year seems possible to be found.

  Category:Year of death missing

• year of death : such as "1986" or known approximations such as "1980s" or "20th century".

  Category:1986 deaths or Category:1980s deaths or Category:20th century deaths

3 (sortkey)

• {{PAGENAME}} : should not be left blank even if it is the same as the page name - only if you don't know what it should be.
• Asian name, Honorific prefix (qualifier suffix) : for assertion of sortkey assessment.

  "Mao, Zedong" - "Kim, Il-sung" - "Matsuo Bashō|Matsuo, Basho" - "Nu, U" - "Wang, Li (politician)"

• Family name, Given name, Honorific-prefix (qualifier suffix) : for proper sorting.

  "Newton, Isaac, Sir" - "Karlsson, Ove (sports journalist)"

• For further details, see Wikipedia: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

{{subst:BD|1899||Surname, Name}}

or

{{subst:BD|1899|LIVING|Surname, Name}}

will replace:

{{DEFAULTSORT:Surname, Name}}

[[Category:1899 births]]

[[Category:Living people]]

For a missing birth and living person

{{subst:BD|||Surname, Name}}

or

{{subst:BD|MISSING|LIVING|Surname, Name}}

will replace:

{{DEFAULTSORT:Surname, Name}}

[[Category:Year of birth missing (living people)]]

[[Category:Living people]]

For a dead person

{{subst:BD|1899|1986|Surname, Name}}

will replace:

{{DEFAULTSORT:Surname, Name}}

[[Category:1899 births]]

[[Category:1986 deaths]]

Etc.

Before changing the template's code or text, please bear in mind:

• The extra bars in the switch statements are for empty values.
• Extra whitespace around years doesn't matter, because page titles are not sensitive to extra spaces.

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