Template:given name/documentation

This template is used in definitions for given names. The content is generated by Module:names.

Parameters

 * 1
 * Language code; see List of languages. The parameter lang is a deprecated synonym; please do not use. If this is used, all numbered parameters move down by one.


 * 2 or gender
 * gender:,   or  ; if any other gender is specified, the template adds a tracking template.


 * or
 * 2nd gender:  or


 * from, from2, from3, etc.; or 3, 4, 5, etc.
 * Source of name: a language name (not a code), such as  or   (etymology-only languages are recognized and allowed); a family name such as  ; ,  , or  ; or a language code + term such as  ,   or  . You can specify glosses, transliterations, alternative forms, equivalent forms, etc. inline using a syntax like non:bjǫrn to specify a gloss for an Old Norse term. You can also specify multiple languages or terms separated by   (which must have spaces around it) to indicate a chain of derivation. An example is Latin < Ancient Greek < Biblical Hebrew to indicate a name derived from Latin, in turn from Ancient Greek, and in turn from Biblical Hebrew. Another example is fr:Édouard < en:Edward to indicate a name (e.g. ) derived from , which in turn comes from . This is documented in more detail below. See below for more examples.


 * dimform, dimform2
 * Specify diminutive forms of this name, when the lemma is the main form of the name. This is conceptually the opposite of dim, dim2, etc., which are used when the lemma itself is a diminutive, to indicate the main form. You can specify transliterations, alternative forms, English equivalents and other modifiers inline, as described below.


 * varform, varform2
 * Specify variant forms of this name, when the lemma is the main form of the name. This is conceptually the opposite of var, var2, etc., which are used when the lemma itself is a variant form, to indicate the main form. You can specify transliterations, alternative forms, English equivalents and other modifiers inline, as described below.


 * usage
 * Parameter indicating the usage of this name, e.g.  or.


 * meaning, meaning2, meaning3, etc.
 * One or more meanings of the name.


 * dim, dim2, dim3, etc.; or diminutive, diminutive2, diminutive3, etc.
 * Main form(s), if the lemma is a diminutive. You can specify transliterations, English-equivalent names and other modifiers inline using e.g. מרים to specify a manual transliteration, Cäcilie to specify an English equivalent. This is documented in more detail below.


 * eq, eq2, eq3, etc.
 * Equivalent name in English or some other language, for use in foreign-language entries. To specify an equivalent name in a language other than English, precede the name with the language code of the language followed by a colon, e.g.  or  . You can specify specify transliterations, alternative forms and other modifiers inline using e.g. ru:Изабе́лла to specify a Russian equivalent name with manual transliteration. This is documented in more detail below.


 * xlit, xlit2, xlit3, etc.
 * Transliterated name in English, for use in foreign-language entries. You can specify alternative forms and other modifiers inline, as described below.


 * var, var2, var3, etc.
 * If the lemma is a variant form, the main form(s) that this name is a variant of. You can specify transliterations, alternative forms, English equivalents and other modifiers inline using e.g. Theresa to specify a variant with specified English equivalent. This is documented in more detail below.


 * m, m2, m3, etc.
 * The masculine equivalent(s) of this name. You can specify transliterations, alternative forms, English equivalents and other modifiers inline, as described below.


 * f, f2, f3, etc.
 * The feminine equivalent(s) of this name. You can specify transliterations, alternative forms, English equivalents and other modifiers inline, as described below.


 * A
 * Override the initial indefinite article; see below.


 * sort
 * What to sort by (in the generated categories) if not the pagename. Generally only needed for Japanese.

Comments:
 * Note the difference between equivalent and transliterated names. For example, the Russian name has transliterated name Mikhail and equivalent name Michael.
 * The module automatically determines whether to use initial a or an depending on the first following word (and knows that unisex should use a even though it begins with a vowel). The initial indefinite article is normally capitalized when the language specified by 1 is English, and lowercase otherwise. This is consistent with the general format of definitions in Wiktionary, where English-language terms are normally defined using long, sentence-style definitions that begin with a capital letter and end with a period (full stop), but foreign-language terms are defined using short glosses that are formatted with an initial lowercase letter and no final period/full stop. Both the case of the initial article and whether it is a or an can be overridden with the A parameter.

General examples
To display the result

and categorise the entry into Category:English male given names, use the following : .

If one knows the origin of the name; to display the result

and categorise the entry into Category:English male given names from Hebrew, use the following : . Substituting for 'Hebrew' the proper origin of the word : e.g., Latin, Chinese, Germanic languages, surnames, place names.

To display the result

and categorise the entry into Category:English female given names, use the following : .

Similarly, if one knows that the name is transferred from an English surname; to display the result

and categorise the entry into Category:English female given names from surnames, use the following : .

If the name is male or female, use

For foreign languages' names: for a German name for which one does not know the origin, use For a German name which one knows to be from Hebrew, use

1. Variant name, originating in place name, modern usage
For the English name, to display the result

and categorise the entry into Category:English female given names from place names, use the following : .

2. Diminutive of multiple base names
For the English name, to display the result

and categorise the entry into Category:English diminutives of male given names, use the following : .

3. Equivalent to names in multiple languages
For the Danish name, to display the result

and categorise the entry into Category:Danish male given names, use the following :

4. Specifying a masculine equivalent
For the English name, to display the result

and categorise the entry into Category:English female given names from Hebrew, use the following : .

5. Originating from a language family, with equivalent names in multiple languages, some using non-Latin script
For the Latvian name, to display the result

and categorise the entry into Category:Latvian male given names from Slavic languages, use the following :

6. Name in non-Latin script with standard (non-scientific) transliteration into English
For the Russian name, to display the result

and categorise the entry into Category:Russian male given names from Hebrew, use the following :

7. Specifying the foreign-language name that a given name is derived from
For the Danish name, to display the result

and categorise the entry into Category:Danish male given names from German, use the following :

For the Danish name, to display the result

and categorise the entry into Category:Danish male given names from Latin and Category:Danish male given names from Russian, use the following :

(In this latter example, the name linked to is a non-lemma form, so a link is inserted to display the non-lemma form but link to the lemma  (found on a page name without macrons). This could be equivalently achieved using la:Nicolaus.)

8. Specifying the foreign-language common word (with definition) that a given name is derived from
For the Danish name, to display the result

and categorise the entry into Category:Danish male given names from Old Norse, use the following :

9. Specifying a chain or foreign-language names that a given name is derived from
An example that demonstrates the full capabilities of from is the following, for : . which displays: