Template:fr-IPA/documentation

This template uses Module:fr-pron to generate the IPA pronunciation of French words or text. If no parameter is provided, it will use the page title. Normally the text should be the standard written form of the text.

Examples
Many tricky cases are handled correctly.

But in some cases it is necessary to use respelling to indicate the correct pronunciation. Example:

Use v to indicate that a word is a verb. This currently only affects final, , and.

Use the symbols ŏ, eŭ, ă to force the "lax" sounds   in certain circumstances where the "tense" variants    would otherwise be used (see below). These are the opposite of the standard symbols ô, eû, â, which force the "tense" variants.

Schwas of various sorts:
 * Use ə (a schwa symbol) to force a normal schwa where e would otherwise be interpreted differently (e.g. in -ess-; but note that ress- is special-cased). This may be indicated as mandatory, optional or deleted depending on context, exactly like any other schwa.
 * Use (ə) (a schwa in parens) to force an optional schwa.
 * Use ĕ to force an always-pronounced schwa.
 * Use ė to force a never-pronounced schwa.

Use an underscore to break up a set of letters that would be interpreted specially and force the letters on either side to be interpreted on their own. Examples:

Use the symbol ‿ to indicate liaison.

Many more examples can be found in Module:fr-pron/testcases.

Substitution specs
In place of a respelling, you can use a substitution spec. For example, the spec  says "respell  as  in the page name" (i.e. wherever it occurs), and similarly   says "respell as in the page name". This is useful in long page names, to avoid having to repeat most of the page name in the respelling:

If you precede a substitution spec with, e.g.  , it restricts the substitution to apply to a whole word; by default, substitution specs can match within a word.

Parameters
1, 2, etc. are used to indicate one or more pronunciations, possibly respelled. See examples above for how this respelling works. An omitted parameter defaults to the pagename. You can indicate multiple pronunciations, e.g.



v indicates that a word in the text is a verb, and controls the handling of certain endings (-ai, -ent, -tions); see examples above.

You can tag any pronunciation with a qualifier using qual, qual2, etc. and a reference using n, n2, etc., as with.

1 disables the automatic generation of alternative pronunciations (see above).

Consonants

 * b is normally, but:
 * It is silent in final -mb(s).
 * It is in the sequence bs.
 * c is normally, but:
 * It is before a front vowel, i.e. e, i, y, æ, ə or accented versions of these; also œ, except in the sequence œu ( with ). To get a hard c before a front vowel, write k or qu; to get a soft c before a back vowel, write ç.
 * ch is.
 * c is silent in final nc(t)(s).
 * ç is always.
 * d is, but:
 * It is silent in final -d and -ds. -ied(s) is (,, etc.).
 * f is always.
 * g is normally (note, this is a special IPA character, not the normal g character), except:
 * g is before a front vowel, i.e. e, i, y, æ, ə or accented versions of these; also œ, except in the sequence œu ( with ). To get a hard g before a front vowel, write gu; to get a soft g before a back vowel, write j; to get a pronounced gu before a front vowel, write gü.
 * gn is . To get, write g_n.
 * ng is (as in, ) in the sequence consonant+ing when word-finally, before final s, or before _. Use _ to get ing ->  elsewhere in a word, e.g. respell  as Washing_tonne and  as swing_guer. Note that vowel+ing (as in ) is interpreted by the next rule.
 * Final g(s) is silent, as in, , , and plurals.
 * g is silent in the sequence ngt, as in.
 * h is normally silent. Note:
 * ch, sh, sch, ssh are, except that initial désh- is.
 * ph is.
 * h between vowels prevents conversion of and  into glides (as in,  respelled djihade), but does not have a similar effect on  (hence  is rendered as ).
 * nh is treated as if spelled n (as in, ), except in word-initial enh-, rendered as (as in , , ). For words where the h is "mute" and the enh- needs to be rendered as  , use a respelling beginning with enn-.
 * Word-initial eu- is normally rendered as, but word-initial h blocks this, hence is  but  is.
 * j is always.
 * k is always.
 * l is, except:
 * ill is after a vowel,  after a consonant , and  word-initially . This applies regardless of what follows, which is useful in respellings (e.g.  can be respelled boillcotter to get ). An exception is the sequence uill following a consonant, which is rendered  (as in , ) rather than expected *. Note that many words having ill after a consonant are pronounced with  rather than  , and will need respelling using il.
 * The sequence oil is, unless another l follows (to allow respellings like cauboille  for ).
 * Otherwise, word-final il(s) is after a vowel,  otherwise.
 * In the sequence vowel+il+consonant, il is rendered as ; this is an alternative way to get in respellings.
 * Special cases:
 * œil is interpreted as if spelled œuil.
 * cueil is interpreted as if spelled keuil.
 * gueil is interpreted as if spelled gueuil.
 * oel, oêl are interpreted as if spelled wal.
 * m is, except that it normally indicates nasalization when preceding b, p, or f , and also in the word-final sequences om(s), aim(s), eim(s) . Exceptions and special cases:
 * The sequence oum represents, not a nasal vowel.
 * Word-final um(s) represents.
 * n is normally, but usually indicates nasalization when following a vowel and not preceding a vowel or another n. Exceptions and special cases:
 * The sequence oun represents, not a nasal vowel.
 * Word-final ing(s) after a consonant represents . See the entry for g above for the precise rules.
 * nh is rendered as except in word-initial enh-. See the entry for h above for the precise rules.
 * p is, except:
 * ph is.
 * Word-final p(s) is silent.
 * The sequence compt is as if spelled cont.
 * q and qu are always . To represent a pronounced u, use ü if pronounced (as in, ), and w if pronounced  (as in , , ).
 * r is, but is silent in final -er(s), which is rendered . Exception: -er(s) in single-syllable words  is rendered . Words with pronounced final -er(s) in multisyllabic words will need respelling with -erre, e.g. ,.
 * s is normally, but:
 * It is between vowels and silent word-finally.
 * Words where s between vowels is  will need respelling with ç, ss or (if before a front vowel) c. (Be careful with respelling using ss, as it may change the interpretation of a preceding e.)
 * Words where final s is pronounced will need respelling (e.g. ourse/ource/ourss/ourç/etc., métisse, sense).
 * sh, sch, ssh are, except that initial désh- is.
 * In initial trans- and intrans- preceding a vowel, s is.
 * The words es and est are rendered as if spelled ès and èt, respectively (i.e. they will be rendered as except in a liaison context).
 * Except in the word est, final -st is pronounced.
 * t is normally, but:
 * Word-final t(s) is silent except in st(s) and ct(s) ; but it **is** silent in nct(s) . The word  is handled specially; see above for details. Note that final -et(s) is rendered.
 * t in the sequences tion, tien , tial , tiel is pronounced , except when those sequences come at the beginning of a word  or directly follow s, x or ç . To force a  in these sequences, insert an underscore after the t, e.g.  spelled cat_ion,  spelled crét_ien.
 * As an exception to the above rule, final -tions is rendered with not  when v (,  with final  as plural nouns, but final  as present subjunctive verbs).
 * v is always.
 * w is always.
 * x is normally, but:
 * Word-final x is silent after i and u . It is pronounced after other letters.
 * Word-initial x is.
 * x is also in the following circumstances: word-initial ex-, word-initial hex- , word-initial inex- , and -ex- after a vowel.
 * z is normally, but:
 * Final z is silent . [FIXME: Should only apply to -ez.] Final -ez is rendered as.

Vowels

 * a is, except that it is before final -s and -z.
 * (continue to fill in)