Template:Given name/doc

Template: is only for use on Wikipedia set index articles.

It is not for and should not be used on disambiguation pages! The template will not render output if transcluded on a page that ends with "(disambiguation)" and its title will sort in Category:Wikipedia page transclusions with strong class errors until corrected.

When disambiguation pages have lists of people by given name, among the ambiguous clarifications, on the page, therein made: set 1 to "given name" in the disambiguation template (for example, ). This will sort the disambiguation page in Category:Disambiguation pages with given-name-holder lists.

Usage
When a page is titled in the following form: "Name (given name)" where "Name" is any given name and "(given name)" is the parenthetical index identifier, use template ""; placed at the bottom of a page to identify it as a set index article and, without parameters, will render text in broad generalizations. For example, the introduction says: "this page or section" lists ...". For more specific text, use page or section to modify the template's output to say: "this page lists ..." or "this section lists ..." respectively.

By default, articles that include this template will be auto-categorized into Category:Given names. To override this functionality: Example: Example:
 * Use  when the category should be changed to something else.
 * Use  when no category should be included at all (e.g. when using as an example in discussion or template documentation).

If it's just for a section, you can say so:

Example:

Multiple categories are also possible. To accomplish this, use  for the first category,   for the second, and so on. Note that this will auto-categorize the article into Category:Given names.

Example:

can still be used with multiple categories to suppress auto-categorization into Category:Given names:

Example:

Pages that include both given names and family names may be tagged with. This adjusts the displayed text accordingly, and obviates the need to include multiple templates.

Example:

However, category names must still be provided in full.

Example:

In addition,  must still be used in order to avoid auto-categorization into Category:Given names and Category:Surnames:

Example:

TemplateData
{	"params": { "section": {}, "page": {}, "type": { "label": "Type", "description": "If set to \"both\", it indicates that the article also covers people having the same name as their surname.", "example": "both", "type": "string" },		"nocat": {}, "cat": { "aliases": [ "cat1", "1 "			],			"label": "First category", "description": "The first category to categorize the article into.", "example": "Welsh given names", "type": "string" },		"cat2": { "label": "Second category", "description": "The second category to categorize the article into.", "type": "string", "aliases": [ "2"			]		},		"cat3": { "label": "Third category", "description": "The third category to categorize the article into.", "type": "string" },		"cat4": {}, "cat5": {}, "cat6": {}, "cat7": {}, "cat8": {}, "cat9": {} },	"description": "Indicates that an article is about a given name. Typically, such articles contain a list of notable people with this name.", "paramOrder": [ "section", "page", "type", "nocat", "cat", "cat2", "cat3", "cat4", "cat5", "cat6", "cat7", "cat8", "cat9" ] }