Merge pull request #89 from javaevolved/copilot/translate-to-french

Add French (fr) locale

Author: brunoborges

html-generators/locales.properties

@@ -3,4 +3,5 @@ en=English
 de=Deutsch
 es=Español
 pt-BR=Português (Brasil)
+fr=Français
 ja=日本語

translations/content/fr/collections/collectors-teeing.yaml

@@ -0,0 +1,18 @@
+---
+title: "Collectors.teeing()"
+oldApproach: "Deux passages"
+modernApproach: "teeing()"
+summary: "Calcule deux agrégations en un seul passage du stream."
+explanation: "Collectors.teeing() envoie chaque élément à deux collectors aval et combine les résultats. Cela évite de parcourir les données deux fois ou d'utiliser un accumulateur mutable."
+whyModernWins:
+- icon: "⚡"
+  title: "Un seul passage"
+  desc: "Traite le stream une seule fois au lieu de deux."
+- icon: "🧩"
+  title: "Composable"
+  desc: "Combine deux collectors quelconques avec une fonction de fusion."
+- icon: "🔒"
+  title: "Résultat immutable"
+  desc: "Fusionne directement dans un record ou un objet valeur."
+support:
+  description: "Disponible depuis JDK 12 (mars 2019)"

translations/content/fr/collections/copying-collections-immutably.yaml

@@ -0,0 +1,18 @@
+---
+title: "Copie immutable de collections"
+oldApproach: "Copie manuelle + wrapper"
+modernApproach: "List.copyOf()"
+summary: "Crée une copie immutable de n'importe quelle collection en un seul appel."
+explanation: "List.copyOf(), Set.copyOf() et Map.copyOf() créent des instantanés immutables de collections existantes. Si la source est déjà une collection immutable, aucune copie n'est effectuée."
+whyModernWins:
+- icon: "⚡"
+  title: "Copie intelligente"
+  desc: "Ignore la copie si la source est déjà immutable."
+- icon: "📏"
+  title: "Un seul appel"
+  desc: "Sans construction manuelle d'ArrayList + wrapper."
+- icon: "🛡️"
+  title: "Copie défensive"
+  desc: "Les modifications de l'original n'affectent pas la copie."
+support:
+  description: "Disponible depuis JDK 10 (mars 2018)"

translations/content/fr/collections/immutable-list-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: "Création de listes immutables"
+oldApproach: "Wrapper verbeux"
+modernApproach: "List.of()"
+summary: "Crée des listes immutables en une seule expression claire."
+explanation: "List.of() crée une liste véritablement immutable — sans wrapper, sans copie défensive. Elle rejette les éléments null et est structurellement immutable. L'ancienne méthode nécessitait trois appels imbriqués."
+whyModernWins:
+- icon: "📏"
+  title: "Un seul appel"
+  desc: "Remplace trois appels imbriqués par une unique méthode factory."
+- icon: "🔒"
+  title: "Véritablement immutable"
+  desc: "Ce n'est pas juste un wrapper — la liste elle-même est immutable."
+- icon: "🛡️"
+  title: "Sûre contre null"
+  desc: "Rejette les éléments null à la création, échouant rapidement."
+support:
+  description: "Disponible depuis JDK 9 (sept. 2017)"

translations/content/fr/collections/immutable-map-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: "Création de maps immutables"
+oldApproach: "Pattern builder de Map"
+modernApproach: "Map.of()"
+summary: "Crée des maps immutables en ligne sans avoir besoin d'un builder."
+explanation: "Map.of() accepte des paires clé-valeur en ligne et retourne une map immutable. Pour plus de 10 entrées, utilisez Map.ofEntries() avec des paires Map.entry()."
+whyModernWins:
+- icon: "📏"
+  title: "Création en ligne"
+  desc: "Aucune map mutable temporaire nécessaire."
+- icon: "🔒"
+  title: "Résultat immutable"
+  desc: "La map ne peut pas être modifiée après sa création."
+- icon: "🚫"
+  title: "Sans clés/valeurs null"
+  desc: "Les entrées null sont rejetées immédiatement."
+support:
+  description: "Disponible depuis JDK 9 (sept. 2017)"

translations/content/fr/collections/immutable-set-creation.yaml

@@ -0,0 +1,18 @@
+---
+title: "Création de sets immutables"
+oldApproach: "Wrapper verbeux"
+modernApproach: "Set.of()"
+summary: "Crée des sets immutables avec un unique appel factory."
+explanation: "Set.of() crée un set véritablement immutable qui rejette les éléments null et les doublons à la création. Fini de wrapper des sets mutables."
+whyModernWins:
+- icon: "📏"
+  title: "Concis"
+  desc: "Une ligne au lieu de trois appels imbriqués."
+- icon: "🚫"
+  title: "Détecte les doublons"
+  desc: "Lève une exception si vous passez des éléments dupliqués par accident."
+- icon: "🔒"
+  title: "Immutable"
+  desc: "Impossible d'ajouter ou de supprimer après la création."
+support:
+  description: "Disponible depuis JDK 9 (sept. 2017)"

translations/content/fr/collections/map-entry-factory.yaml

@@ -0,0 +1,18 @@
+---
+title: "Factory Map.entry()"
+oldApproach: "SimpleEntry"
+modernApproach: "Map.entry()"
+summary: "Crée des entrées de map avec une méthode factory propre."
+explanation: "Map.entry() remplace le constructeur verbeux de AbstractMap.SimpleEntry. Elle retourne une entrée immutable, idéale pour Map.ofEntries() et les opérations de stream."
+whyModernWins:
+- icon: "📏"
+  title: "Concis"
+  desc: "Une ligne au lieu de trois, avec une intention plus claire."
+- icon: "🔒"
+  title: "Immutable"
+  desc: "L'entrée retournée ne peut pas être modifiée."
+- icon: "🧩"
+  title: "Composable"
+  desc: "Fonctionne parfaitement avec Map.ofEntries() pour les grandes maps."
+support:
+  description: "Disponible depuis JDK 9 (sept. 2017)"

translations/content/fr/collections/reverse-list-iteration.yaml

@@ -0,0 +1,18 @@
+---
+title: "Itération inverse de listes"
+oldApproach: "ListIterator manuel"
+modernApproach: "reversed()"
+summary: "Itère sur une liste dans l'ordre inverse avec une boucle for-each propre."
+explanation: "La méthode reversed() de SequencedCollection retourne une vue dans l'ordre inverse de la liste. Cette vue est soutenue par la liste originale, donc aucune copie n'est effectuée. La syntaxe de la boucle for améliorée rend l'itération inverse aussi lisible que l'itération vers l'avant."
+whyModernWins:
+- icon: "📖"
+  title: "Syntaxe naturelle"
+  desc: "Boucle for améliorée au lieu du verbose ListIterator."
+- icon: "⚡"
+  title: "Sans copie"
+  desc: "reversed() retourne une vue — sans surcharge de performance."
+- icon: "🧩"
+  title: "API cohérente"
+  desc: "Fonctionne uniformément sur List, Deque et SortedSet."
+support:
+  description: "Disponible depuis JDK 21 LTS (sept. 2023)"

translations/content/fr/collections/sequenced-collections.yaml

@@ -0,0 +1,18 @@
+---
+title: "Collections séquencées"
+oldApproach: "Arithmétique d'indices"
+modernApproach: "getFirst/getLast"
+summary: "Accédez au premier et dernier élément et obtenez des vues inversées avec des méthodes d'API propres."
+explanation: "SequencedCollection ajoute getFirst(), getLast(), reversed(), addFirst() et addLast() à List, Deque, SortedSet et LinkedHashSet. Fini l'arithmétique size-1 ou l'itération inverse manuelle."
+whyModernWins:
+- icon: "📖"
+  title: "Auto-documenté"
+  desc: "getLast() est plus clair que get(size()-1)."
+- icon: "🔄"
+  title: "Vue inverse"
+  desc: "reversed() offre une vue — sans besoin de copier."
+- icon: "🧩"
+  title: "API uniforme"
+  desc: "Fonctionne pareillement sur List, Deque et SortedSet."
+support:
+  description: "Disponible depuis JDK 21 LTS (sept. 2023)"

translations/content/fr/collections/stream-toarray-typed.yaml

@@ -0,0 +1,18 @@
+---
+title: "toArray typé dans les streams"
+oldApproach: "Copie manuelle de tableau"
+modernApproach: "toArray(generator)"
+summary: "Convertit des streams en tableaux typés avec une référence de méthode."
+explanation: "La méthode toArray(IntFunction) crée un tableau correctement typé à partir d'un stream. Le générateur (String[]::new) indique au stream quel type de tableau créer."
+whyModernWins:
+- icon: "🎯"
+  title: "Sûr en termes de types"
+  desc: "Sans cast vers Object[] — le type du tableau est correct."
+- icon: "🔗"
+  title: "Enchaînable"
+  desc: "Fonctionne à la fin de n'importe quel pipeline de stream."
+- icon: "📏"
+  title: "Concis"
+  desc: "Une seule expression remplace la boucle manuelle."
+support:
+  description: "Disponible depuis JDK 8 (mars 2014)"