Title Case for French

What is Title Case?

Basically it is using "Capital and Lowercase Letters in Titles". This means only using capital letters for the principal words. Articles, conjunctions, and prepositions do not get capital letters unless they start the title. For example:

• The Last of the Mohicans

In English

There are quite a few nice libraries to Title Case a text in English. This implementation by John Resig is one of them and works well. In English, the first word in the title and all subsequent "important" words (everything except articles, conjunctions, and prepositions) are capitalized.

In French

The capitalization of titles in French and English is quite a bit different. The rules are more complicated in French, so complicated, in fact, that even Le Petit Robert (the quintessential French dictionary) and Le Bon Usage (the French grammar bible) can't seem to agree on how to capitalize titles.

It is clear that either there is no standard system or that the standard is not well known. As a French person I tried to apply the rules that I have most commonly seen.

Using the package

Installation

1npm install titlecase-french

Basic usage

You just need to require the package and call the convert('mon texte de démonstration') function.

1var titleCaseFrench = require('titlecase-french');
2
3var myText = titleCaseFrench.convert('mon texte de démonstration');
4console.log(myText); // => Mon Texte de Démonstration

API

addLowerCaseWords

Description

If you do not want specific words to be capitalized then include them to the list with the function.

Signature

addLowerCaseWords(words: String)

Where words is a list of words separated by Commas.

Example

In the first example the 'démonstration' word is added to the list and won't be capitalized. In the second example both words 'démonstration' and 'texte' won't be capitalized.

1var titleCaseFrench = require('titlecase-french');
2titleCaseFrench.addLowerCaseWords('démonstration');
3
4var myText = titleCaseFrench.convert('mon texte de démonstration');
5console.log(myText); // => Mon Texte de démonstration
6
7titleCaseFrench.addLowerCaseWords('démonstration,texte');
8
9var myText = titleCaseFrench.convert('mon texte de démonstration');
10console.log(myText); // => Mon texte de démonstration

removeLowerCaseWords

Description

If you want to remove specific words from the default list (see words in the rules below) then call this function with your list of words.

Signature

removeLowerCaseWords(words: String)

Where words is a list of words separated by Commas.

Example

In this example the 'de' word should have been in lowercase because it is in the default list of words that are not capitalized. We are going to remove it from the list to get it capitalized.

1var titleCaseFrench = require('titlecase-french');
2titleCaseFrench.removeLowerCaseWords('de,du,la,la');
3
4var myText = titleCaseFrench.convert('mon texte de démonstration');
5console.log(myText); // => Mon Texte De Démonstration

keepCapitalizedSpecials

Description

Sometimes you do not want to replace all the capitalized special letters. You can avoid replacement by declaring which letter you want to keep.

Signature

keepCapitalizedSpecials(letters: String)

Where letters is a list of uppercase special letters separated by Commas.

Example

1var titleCaseFrench = require('titlecase-french');
2titleCaseFrench.keepCapitalizedSpecials('À,Ç,É');
3
4var myText = titleCaseFrench.convert('ça va!');
5console.log(myText); // => Ça Va!

Tests

1npm test

The rules

There are 5 main rules:

• A title always starts with a word in uppercase
• A specific list of words are in lowercase
• After a quote ' words can be in lowercase or uppercase depending of the word before the quote
• Acronyms are in uppercase
• Special uppercase letters (with accent for example) are replaced with their simple version

Some examples (see below for a bigger list).

1/*
2Le Dernier des Mohicans
3Du Vent dans les Branches
4Junior l'Aventurier
5Ca m'intéresse
6Avec S.A.M.
7Cet Eté à la Plage
8*/

List of lowercase words

• Definite articles:

  • le, la, les

• Indefinite articles:

  • un, une, des

• Partitive articles:

  • du, de, des

• Contracted articles:

  • au, aux, du, des

• Demonstrative adjectives:

  • ce, cet, cette, ces

• Exclamative adjectives:

  • quel, quels, quelle, quelles

• Possessive adjectives:

  • mon, ton, son, notre, votre, leur, ma, ta, sa, mes, tes, ses, nos, vos, leurs

• Coordinating conjunctions:

  • mais, ou, et, donc, or, ni, car, voire

• Subordinating conjunctions:

  • que, qu, quand, comme, si, lorsque, lorsqu, puisque, puisqu, quoique, quoiqu

• Prepositions:

  • à, chez, dans, entre, jusque, jusqu, hors, par, pour, sans, vers, sur, pas, parmi, avec, sous, en

• Personal pronouns:

  • je, tu, il, elle, on, nous, vous, ils, elles, me, te, se, y

• Relative pronouns:

  • qui, que, quoi, dont, où

• Other words:

  • ne

After a quote

• Words after a quote are in lowercase if the word before the quote is:

  • c', j', m', n', s', t'

• Words after a quote are in uppercase if the word before the quote is:

  • d', l'

Special uppercase letters

• All the following special uppercase letters are replaced:
  • À, Â, Ä, É, È, Ê, Ë, Ç, Î, Ï, Ô, Ö, Û, Ü, Ù

Samples of converted titles

1/*
2Le Triangle Rouge
3Loki, le Détective Mythique
4La Secte
5Leon la Came
6Littlest Petshop les Aventures
7Les Banquiers
8Junior l'Aventurier
9L'Accordeur
10Je Suis un Vampire
11Un Messager
12Il Etait une Fois...
13Une Histoire de France
14Le Haut des Arbres
15Des Mohicans
16Danse du Temps
17Du Côté de chez Poje
18Le Masque de Fer
19De Beaux Moments
20Le Marteau des Sorcières
21Des Bêtes
22Rentre au Pays
23Au Pays des Monstres
24Rentrez aux Pays
25Aux Pays des Monstres
26Histoires du Passé
27Du Vent dans les Branches
28Avant des Lustres
29Des Répétitions
30Regarde ce Chemin
31Ce Chemin Est Long
32A la Plage cet Eté
33Cet Eté à la Plage
34Ils Font cette Liste
35Cette Liste
36Regarde-Moi ces Hommes
37Ces Longs Trajets
38Dis Moi quel Nom
39Quel Beau Paysage
40En quel Pays
41Quels Sapins pour Noël
42En quelle Saison
43Quelle Ville
44Elles Font quelles Recettes
45Quelles Couleurs
46Sauf mon Père
47Mon Ancètre
48Vis ton Rêve
49Ton Espoir ne Meurt pas
50Louna et son Fils
51Son Coeur Résistera
52A notre Bourse
53Notre Vie
54Avec votre Accord
55Votre Avis
56C'est leur Choix
57Leur Style
58Tout Est de ma Faute
59Ma Mère
60Range ta Chambre
61Ta Lumière
62Un Père et sa Fille
63Sa Dulciné
64Pourtant mes Choix Etaient Bons
65Mes Devoirs
66Prends tes Responsabilités
67Tes Dessins Sont Brillants
68Lui et ses Frères
69Ses Cousins et Cousines
70Ce Sont nos Femmes
71Nos Clients
72A vos Marques
73Vos Idées
74Jamais sans leurs Bicyclettes
75Leurs Régions Ont du Talents
76Il Est Studieux mais Turbulent
77Mais Comment Font-Ils?
78Ici ou Là
79Ou Bien
80Entre Ciel et Terre
81Boule et Bill
82Je Pense donc je Suis
83Donc nous Partons
84Le Temps Est Chaud or il A Froid
85Or il Tomba
86Je ne Bois, ni ne Fume
87Ni Eux ni Moi
88Part car il Est Temps
89Car il Partait
90Deux voire Trois
91Voire Même Trois
92Il Faut que je Parte
93Que Faire
94A Moins qu'elle Parte
95Qu'en Dise les Gens
96Elle Rêve quand elle Dors
97Quand Viendra le Temps
98Elle Est Belle comme le Jour
99Comme si nous Pouvions
100Nous Sommes Allé si Loin
101Si Loin
102Elle Partit lorsque tu Arrivas
103Lorsque tu Pars
104Il Partit lorsqu'elle Arriva
105Lorsqu'elle Arriva
106Il Est Là puisque je l'Ai Vu
107Puisque tu Pars
108Ils Viennent puisqu'elle Part
109Puisqu'elle Part
110Il Ira quoique tu Fasses
111Quoique nous Fassions
112Il l'Aime quoiqu'elle Fasse
113Quoiqu'elle Fasse
114Motards à Jamais
115A Toute Allure
116Viens chez nous
117Chez nous
118Le Pont dans la Vase
119Dans mes Veines
120Le Jour entre les Lattes
121Entre Lui et elle
122Depuis Là jusque dans la Maison
123Jusque Par-Dessus la Tête
124Révêr jusqu'au Jour
125Jusqu'au Lendemain
126Sortez hors de chez Moi
127Hors la Loi
128Deçue par la Vie
129Par Dessus les Nuages
130Tout pour le Tout
131Pour la Vie
132Vivre sans Limite
133Sans Foi ni Loi
134Le Regard vers le Large
135Vers l'Infini et Au-Delà
136Argent sur Providence
137Sur Lui
138Il ne Faut pas
139Pas Toi
140L'Intru parmi Eux
141Parmi nous
142Lui avec ses Amis
143Avec Eux
144L'Eau sous la Glace
145Sous la Neige
146En Route
147Escales en Terres Inconnues
148Pourquoi je Pleure
149Je Suis Moi
150Toi au Moins, tu Es Mort Avant
151Tu Mourras Moins Bête
152Après il Est Parti
153Il Etait Seul
154En Chemin elle Rencontre...
155Elle et Lui
156Après on Ira au Bois
157On nous Dit Rien
158Le Monde Est à nous
159Nous Rentrons
160Si vous Acceptez
161Vous et Eux
162Après ils Sont Partis
163Ils Etaient Dix
164Comme elles
165Elles Etaient Dix
166Laisse Moi me Prendre en Charge
167Me Perdre
168Je te Rejoindrai
169Te Dira pas
170Il Faut se Connaître Soi-Même
171Se Perdre
172Il y Avait
173Y A pas
174Ceux qui Ont des Ailes
175Qui Est La?
176Pendant que le Roi de Prusse...
177Que sa Volonté Soit Faite
178A quoi Bon
179Quoi Faire
180Celui dont on Parle
181Dont nous Aimons la Compagnie
182Le Pays où il Est Né
183Où Aller?
184Il ne Viendra pas
185Ne Fais pas Ca
186Ca, c'est Paris
187C'est Triste
188Le Marquis d'Anaon
189D'Artagnan
190Dites-Moi que j'existe
191J'ai Tué François
192Moi l'Homme
193L'Emmerdeur
194Ca m'intéresse
195Avoue tu m'aimes
196Je n'ai pas Raison
197N'ai pas Peur
198Elle s'est Fait Mal
199S'affoler pour Rien
200Simon's Cat
201Si tu Freines t'es un Lâche
202T'abuses Ikko
203En Extrême-Orient
204Extrême-Orient
205Comment s'appelle-t-il?
206Ce Mot Existe-t-il?
207Avec S.A.M.
208S.A.M.
209Motards à Jamais
210A Toute Allure
211Le Bruit de l'Echo
212Echo des Savanes
213Post Ere Moderne
214Ere Moderne
215Ca m'intéresse
216Tu Aimes Ca
217*/