Template:fr-noun/documentation

	Documentation for Template:fr-noun.
	This page contains usage information, categories, interwiki links and other content describing the template.

This template is used for the headword line of French nouns. It uses Module:fr-headword as a back-end.

It should be used just under the 'Noun' header for French words. For example, on chien:

===Noun===
{{fr-noun|m|f=+}}

This template contains the necessary meta-data to allow users who are using accelerated editing to create any grammatical forms semi-automatically.

Multiword expressions use an intelligent algorithm to form the feminine and the plural. Specifically, if a known preposition is seen, the algorithm forms the feminine or plural only of the preceding word; otherwise, it forms the feminine or plural of the first and last word of the expression. (If multiple words precede a preposition, the algorithm forms the feminine or plural of the first and last such word.) The recognized prepositions are:

• à, au, aux
• de, du, des, d'
• en, dans
• sous, sur
• avec
• pour, par
• contre
• sans
• comme
• jusqu'

Note that all prepositions must be preceded by a space to be recognized, and all except d' and jusqu' must be followed by a space.

An example is attaché de presse (“press secretary”):

{{fr-noun|m|f=+}}

which produces

attaché de presse m (plural attachés de presse, feminine attachée de presse)

Note how the word attaché before the preposition de is inflected automatically according to the default rules.

An example without a preposition is baleine bleue (“blue whale”):

{{fr-noun|f}}

which produces

baleine bleue f (plural baleines bleues)

Here, the first and last word (i.e. both words, as there are only two) are inflected according to the default rules.

Some multiword terms inflect differently from the above rules. Use +SPEC to specify which word or words inflect in a multiword term:

• Use +first if only the first word inflects.
• Use +last if only the last word inflects.
• Use +first-last if the first and last word inflect.
• Use +each if all words inflect.
• Use +first-second if the first and second words inflect.
• Use +second if only the second word inflects.

Examples:

For assistant numérique personnel (“personal digital assistant”), use +each:

{{fr-noun|m|+each}}

which produces

assistant numérique personnel m (plural assistants numériques personnels)

For station essence (“gas station, petrol station”), use +first:

{{fr-noun|f|+first}}

which produces

station essence f (plural stations essence)

An example using such a spec for the feminine is mal élevé (“ill-mannered person, rascal”):

{{fr-noun|m|+last|f=+last}}

which produces

mal élevé m (plural mal élevés, feminine mal élevée)

In this case, an alternative which is shorter is to use s for the plural and e for the feminine:

{{fr-noun|m|s|f=e}}

which produces

mal élevé m (plural mal élevés, feminine mal élevée)

|head=; |head2=; ...

The head word(s), if different from the page name, or to link to individual words. Note that the default behavior with multiword and multipart pronouns is to split the pronoun intelligently and link the individual parts (see below), so this isn't normally needed.

|1= (or |g=); |g2=; ...

The gender(s), which should be one of m, f, mf (gender can be either masculine or feminine), mfbysense (gender can be either masculine or feminine according to the natural gender of the word; categorizes into Category:French masculine and feminine nouns by sense), m-p, f-p, mf-p, mfbysense-p.

|2=; |3=; |4=; ...

The plural forms, if the noun is not already plural (as indicated in the gender). Some shortcuts can be used:

• +: explicitly request the default plural.
• +first, +last, etc.: specify how to pluralize multiword terms. See #Multiword expressions above.
• #: if the plural is the same as the singular.
• s or x: if the plural is formed by adding s or x.

If no plural forms are given, the first plural is formed according to default rules (see below). The first plural can also have some special values:

• -: if the noun is uncountable. The second and higher plural parameters can still be given, and indicate that the noun is usually uncountable, but can sometimes be pluralized.
• ~: if the noun can be either countable or uncountable, depending on meaning. The countable plural(s) should be specified using the second and higher plural parameters; if not given, the default is the same as for countable nouns.
• !: if the plural is not attested.
• ?: if you don't know the plural or are not sure if it even has a plural.

|pqual=; |pqual2=; ...

Qualifiers for the plurals; useful if different plurals have different uses (e.g. for different meanings of the word) or different connotations (e.g. some may be rare, some nonstandard, etc.). |pqual= corresponds to the first plural (specified by |2=); |pqual2= to the second plural (specified by |3=); etc.

|f=; |f2=; ...

Feminine equivalent noun(s), if any. Some shortcuts can be used:

• +: request the default feminine (see below).
• +first, +last, etc.: specify how to form the feminine of multiword terms. See #Multiword expressions above.
• #: if the feminine is the same as the masculine (but in this case, it's better to use a gender of mfbysense instead).
• e: if the feminine is formed by adding e (particularly in the default feminine would generate something else).

|fqual=; |fqual2=; ...

Qualifiers for the feminines; useful if different feminines have different uses or connotations.

|m=; |m2=; ...

Masculine equivalent noun(s), if any.

|mqual=; |mqual2=; ...

Qualifiers for the masculines; useful if different masculines have different uses or connotations.

|dim=; |dim2=; ...

Diminutive equivalent(s), if any.

|dimqual=; |dimqual2=; ...

Qualifiers for the diminutives; useful if different diminutives have different uses or connotations.

|nolinkhead=1

Don't link individual words in the headword of a multiword term. Useful for foreign terms like a posteriori and top model where the expression functions as a whole in French but the individual parts are not French words.

|splithyph=1

Indicate that automatic splitting and linking of words should split on hyphens in multiword expressions with spaces in them (splitting on hyphens is automatic if there are no spaces in the term). See below and Module:fr-headword.

If the term begins with a hyphen (-), it is assumed to be a suffix rather than a base form, and is categorized into Category:French suffixes and Category:French noun-forming suffixes rather than Category:French nouns.

The template uses an intelligent algorithm to split and link words in multiword expressions. Individual words of a multiword expression like tout le monde will be linked, as will individual words in a hyphenated expression like avant-avant-hier and parts of words with apostrophes in them, like n'importe quoi (linked as ]] ]). See Module:fr-headword for more details.