docs: translate the French locale

.agents/skills/localize-rustfs-docs/references/fr.md

@@ -18,7 +18,7 @@ Treat RustFS source code, APIs, and exact Console labels as authoritative for pr
 - Address the reader with `vous`; use concise active instructions.
 - Prefer natural French clause order and avoid calques from English noun strings.
 - Use sentence-style capitalization for headings.
-- Apply French punctuation and non-breaking spacing where practical without damaging Markdown, URLs, code, or identifiers.
+- Apply French punctuation where practical: a narrow no-break space (U+202F) before `;` `:` `?` `!` in prose, and French guillemets « » for quotations. Do not insert that space into code fences, URLs, identifiers, or the `:::` admonition marker.
 - Keep grammatical gender and number consistent across headings, prose, tables, and navigation.
 - Retain established English ecosystem terms only when they are conventional in French technical writing.
 - Avoid casual slang, promotional wording, and unjustified claims of seamless replacement.
@@ -32,7 +32,7 @@ Treat RustFS source code, APIs, and exact Console labels as authoritative for pr
 | Amazon S3 / S3 | Amazon S3 / S3 | Keep the service and protocol name. |
 | S3-compatible | compatible avec S3 | Never strengthen to complete or 100% compatibility. |
 | object storage | stockage objet | Use for the storage model. |
-| Bucket | compartiment / compartiment S3 | Preserve `Bucket` in APIs, identifiers, and exact UI labels. |
+| Bucket | compartiment (bucket) | Use compartiment in prose. Add `(bucket)` on the first mention in a page when it helps. Do not mix bucket and compartiment in prose. Preserve `Bucket`, `bucket`, and `my-bucket` in APIs, code, identifiers, and exact UI labels. |
 | Object | objet / objet S3 | Distinguish it from a local `fichier`. |
 | object key | clé d’objet | Use `nom de clé` when specifically describing the key name; preserve `Key` in APIs. |
 | Bucket policy | politique de compartiment | Preserve policy JSON and API names. |
@@ -54,13 +54,26 @@ Treat RustFS source code, APIs, and exact Console labels as authoritative for pr
 | multipart upload | chargement partitionné | Preserve API actions such as `CreateMultipartUpload`. |
 | server-side encryption | chiffrement côté serveur | Keep SSE-S3, SSE-KMS, and SSE-C unchanged. |
 | presigned URL | URL présignée | Keep URL uppercase and preserve API names. |
-| path-style addressing | adressage de type chemin | Preserve SDK option names. |
+| path-style addressing | adressage de type chemin (path-style) | Add `(path-style)` on the first mention in a page. Preserve SDK option names. |
 | virtual-hosted-style addressing | adressage de type hôte virtuel | Relate it to `RUSTFS_SERVER_DOMAINS` when relevant. |
 | health check | contrôle d’intégrité | Preserve endpoint paths and probe names. |
 | readiness | état de préparation | Preserve `/health/ready` and Kubernetes field names. |
 | observability | observabilité | Keep OpenTelemetry and OTLP unchanged. |
 | rootless | sans privilèges root | Prefer this over a literal calque. |
-| root credentials | informations d’identification racine | Distinguish RustFS deployment credentials from the operating-system root account. |
+| credentials | identifiants | Use for access credentials in prose. In IAM detail, use clés d’accès and clé secrète. Preserve `AccessKeyId`, `SecretAccessKey`, and environment variables. |
+| root credentials | identifiants racine | Distinguish RustFS deployment credentials from the operating-system root account. |
+| upload | charger / chargement | Prefer this over téléverser. A first mention may add `(upload)`. |
+| download | télécharger | Use for retrieving an object or file. |
+| docker pull | tirer / récupérer | Never translate `docker pull` as retirer. retirer means remove. |
+| registry (prose) | registre | Product names such as Docker Registry and Harbor may stay. Keep `registry` inside commands, paths, and config keys. |
+| support matrix | matrice de prise en charge | Do not write matrice de support. |
+| table bucket | compartiment de tables (table bucket) | Never write un table bucket. Preserve API fields such as `table-bucket`. |
+| single-binary | binaire unique (single-binary) | Explain the English term on first use in a page. |
+| location (prose) | emplacement | Preserve configuration keys and API fields named `location`. |
+| file metastore | metastore fichier | Do not leave file as an English adjective. |
+| Next steps | Étapes suivantes | Use this heading, not Prochaines étapes. |
+| commit a .env file | N’ajoutez pas le fichier .env au dépôt | Do not calque commit as commettre. |
+| preview | préversion (preview) | Use on first mention of a pre-release feature. |
 
 ## Common review failures
 

.agents/skills/localize-rustfs-docs/scripts/audit-locales.mjs

@@ -225,6 +225,27 @@ function extractExternalUrls(content) {
   return urls.sort();
 }
 
+// Vendor docs sometimes put a language code in an absolute URL. Ray's Sphinx
+// site, for example, publishes only https://docs.ray.io/en/latest/... and
+// returns 404 for the same path without /en/. Those are not internal locale
+// links. Keep absolute docs.rustfs.com URLs so a fully qualified /en/ page
+// is still reported.
+function withoutExternalUrls(content) {
+  return content.replace(/https?:\/\/[^\s)<>{}"']+/g, (url) => {
+    try {
+      const hostname = new URL(url).hostname;
+      if (hostname === "docs.rustfs.com" || hostname.endsWith(".rustfs.com")) return url;
+    } catch {
+      return url;
+    }
+    return "";
+  });
+}
+
+function containsInternalLocaleLink(content, sourceLocale) {
+  return withoutExternalUrls(content).includes(`/${sourceLocale}/`);
+}
+
 function normalizeLocaleLinks(content, locale, source) {
   return content.replaceAll(`/${locale}/`, `/${source}/`);
 }
@@ -318,7 +339,7 @@ function auditMeta(sourceContent, targetContent, sourceLocale, locale, file, iss
   if (unchangedVisible.length > 0) {
     addIssue(issues, "warning", "UNLOCALIZED_META", locale, file, `${unchangedVisible.length} visible navigation string(s) remain unchanged from English`);
   }
-  if (targetContent.includes(`/${sourceLocale}/`)) {
+  if (containsInternalLocaleLink(targetContent, sourceLocale)) {
     addIssue(issues, "error", "SOURCE_LOCALE_LINK", locale, file, `contains an internal /${sourceLocale}/ link`);
   }
 }
@@ -364,7 +385,7 @@ function auditDocument(sourceContent, targetContent, source, locale, file, issue
   }
 
   const visibleTarget = removeCodeFences(targetContent);
-  if (visibleTarget.includes(`/${source}/`)) {
+  if (containsInternalLocaleLink(visibleTarget, source)) {
     addIssue(issues, "error", "SOURCE_LOCALE_LINK", locale, file, `contains an internal /${source}/ link`);
   }
 

content/de/developer/integration/ai/vllm.md

@@ -155,4 +155,4 @@ Die Standardreservierung für den KV-Cache beträgt 90 Prozent des Arbeitsspeich
 
 - Lesen Sie die [S3-Kompatibilitätshinweise](/de/administration/protocols/s3), bevor Sie weitere Inferenz-Bereitstellungen verwenden.
 - Erstellen Sie dedizierte Produktions-Zugangsdaten über die [Zugriffsschlüssel-Verwaltung](/de/security-compliance/iam/access-token).
-- Folgen Sie der [vLLM-Dokumentation](https://docs.vllm.ai/en/latest/serving/openai_compatible_server.html) für Chat-Templates, Tensor-Parallelität und quantisierte Gewichte auf demselben Bucket als Modellspeicher.
+- Folgen Sie der [vLLM-Dokumentation](https://docs.vllm.ai/serving/openai_compatible_server.html) für Chat-Templates, Tensor-Parallelität und quantisierte Gewichte auf demselben Bucket als Modellspeicher.

content/de/developer/integration/devops/elasticsearch.md

@@ -262,4 +262,4 @@ docker compose logs create-bucket
 
 - Lesen Sie die [S3-Kompatibilitätshinweise](/de/administration/protocols/s3), bevor Sie weitere S3-Operationen verwenden.
 - Erstellen Sie dedizierte Produktions-Zugangsdaten über die [Zugriffsschlüssel-Verwaltung](/de/security-compliance/iam/access-token).
-- Folgen Sie der [Elasticsearch-Snapshot-Dokumentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html) zur Snapshot-Lebenszyklusverwaltung (SLM).
+- Folgen Sie der [Elasticsearch-Snapshot-Dokumentation](https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore) zur Snapshot-Lebenszyklusverwaltung (SLM).

content/en/developer/integration/ai/vllm.md

@@ -151,4 +151,4 @@ The default KV-cache reservation is 90% of system RAM. Lower it with `--gpu-memo
 
 - Review [S3 compatibility notes](/administration/protocols/s3) before adopting additional serving setups.
 - Create dedicated production credentials with [Access Key Management](/security-compliance/iam/access-token).
-- Follow the [vLLM documentation](https://docs.vllm.ai/en/latest/serving/openai_compatible_server.html) for chat templates, tensor parallelism, and quantized weights on top of the same bucket-backed model store.
+- Follow the [vLLM documentation](https://docs.vllm.ai/serving/openai_compatible_server.html) for chat templates, tensor parallelism, and quantized weights on top of the same bucket-backed model store.

content/en/developer/integration/devops/elasticsearch.md

@@ -259,4 +259,4 @@ docker compose logs create-bucket
 
 - Review [S3 compatibility notes](/administration/protocols/s3) before adopting additional S3 operations.
 - Create dedicated production credentials with [Access Key Management](/security-compliance/iam/access-token).
-- Follow the [Elasticsearch snapshot documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshot-restore.html) for snapshot lifecycle management (SLM).
+- Follow the [Elasticsearch snapshot documentation](https://www.elastic.co/docs/deploy-manage/tools/snapshot-and-restore) for snapshot lifecycle management (SLM).

content/fr/administration/console/index.md

@@ -1,13 +1,13 @@
 ---
 title: "Console"
-description: "Enable the RustFS Console, connect it to a server, and sign in securely."
+description: "Activez la Console RustFS, connectez-la à un serveur et connectez-vous de façon sûre."
 ---
 
-The **RustFS Console** is the web administration interface for RustFS. Use this page to enable the Console, open the login page, and choose the appropriate sign-in method. Detailed procedures for buckets, objects, and identity management are covered in their respective documentation sections.
+La **Console RustFS** est l’interface d’administration web de RustFS. Utilisez cette page pour activer la Console, ouvrir la page de connexion et choisir la méthode de connexion adaptée. Les procédures détaillées sur les compartiments (buckets), les objets et la gestion des identités sont décrites dans les sections de documentation correspondantes.
 
-## Enable the Console
+## Activer la Console
 
-The Console is enabled by default and listens on port `9001`, separately from the S3 API on port `9000`. You can set the behavior explicitly with the following environment variables:
+La Console est activée par défaut et écoute sur le port `9001`, séparément de l’API S3 sur le port `9000`. Vous pouvez fixer explicitement ce comportement avec les variables d’environnement suivantes :
 
 ```ini title="/etc/default/rustfs"
 RUSTFS_ADDRESS=":9000"
@@ -17,56 +17,56 @@ RUSTFS_OBS_LOGGER_LEVEL=error
 RUSTFS_OBS_LOG_DIRECTORY="/var/log/rustfs/"
 ```
 
-Restart RustFS after changing these values. Set `RUSTFS_CONSOLE_ENABLE=false` when the Console must not run.
+Redémarrez RustFS après avoir modifié ces valeurs. Définissez `RUSTFS_CONSOLE_ENABLE=false` lorsque la Console ne doit pas s’exécuter.
 
-The equivalent command-line options are `--console-enable` and `--console-address`. See the [CLI reference](/reference/cli) and [environment variable reference](/reference/environment-variables) for the complete server configuration.
+Les options de ligne de commande équivalentes sont `--console-enable` et `--console-address`. Consultez la [référence de la CLI](/fr/reference/cli) et la [référence des variables d’environnement](/fr/reference/environment-variables) pour la configuration complète du serveur.
 
-## Open the Console
+## Ouvrir la Console
 
-Open the following address, replacing `<server-ip>` with the RustFS server address:
+Ouvrez l’adresse suivante, en remplaçant `<server-ip>` par l’adresse du serveur RustFS :
 
 ```text
 http://<server-ip>:9001
 ```
 
-![RustFS Console login page with key, STS, and OIDC sign-in options](./images/rustfs-console-login.png)
+![page de connexion de la Console RustFS, avec les options de connexion par clé, STS et OIDC](./images/rustfs-console-login.png)
 
-For a local deployment, use `http://localhost:9001`. Windows and macOS desktop launchers use port `7001` instead.
+Pour un déploiement local, y compris les lanceurs de bureau Windows et macOS, ouvrez `http://localhost:9001`. L’API S3 écoute sur le port `9000`.
 
-If the login page cannot reach the target RustFS service, select **Server Configuration** or open `/config`. Enter the externally reachable RustFS service address and save it after the health check succeeds. **Reset** clears the saved address; **Skip** returns to login without changing it.
+Si la page de connexion ne peut pas joindre le service RustFS cible, sélectionnez **Server Configuration** ou ouvrez `/config`. Saisissez l’adresse du service RustFS accessible depuis l’extérieur et enregistrez-la une fois le contrôle d’intégrité réussi. **Reset** efface l’adresse enregistrée ; **Skip** revient à la connexion sans la modifier.
 
-## Log in
+## Connexion
 
-The login methods shown depend on the deployment configuration:
+Les méthodes de connexion affichées dépendent de la configuration du déploiement :
 
-- **Key Login** uses the access key and secret key configured for the RustFS deployment. This is the standard login method for a local administrator.
-- **STS Login** uses temporary Security Token Service (STS) credentials. Use it only when your identity workflow has issued a valid session token.
-- **OIDC Login** appears when an OpenID Connect (OIDC) provider is configured. Select the provider and complete authentication with the identity provider.
+- **Key Login** utilise la clé d’accès et la clé secrète configurées pour le déploiement RustFS. C’est la méthode de connexion habituelle d’un administrateur local.
+- **STS Login** utilise des identifiants temporaires du Security Token Service (STS). Ne l’utilisez que si votre flux d’identité a émis un jeton de session valide.
+- **OIDC Login** apparaît lorsqu’un fournisseur OpenID Connect (OIDC) est configuré. Sélectionnez le fournisseur et terminez l’authentification auprès du fournisseur d’identité.
 
-After login, the Console opens the first page your account can access. Menus and actions vary by account policy and enabled platform capabilities; a missing menu does not necessarily indicate a Console error.
+Après la connexion, la Console ouvre la première page à laquelle votre compte peut accéder. Les menus et les actions varient selon la politique du compte et les capacités de plateforme activées ; un menu absent n’indique pas nécessairement une erreur de la Console.
 
-If login fails, verify the selected login method, credentials, target server address, and account status before retrying.
+Si la connexion échoue, vérifiez la méthode de connexion choisie, les identifiants, l’adresse du serveur cible et l’état du compte avant de réessayer.
 
-:::warning[Do not expose default credentials]
+:::warning[N’exposez pas les identifiants par défaut]
 
-RustFS falls back to `rustfsadmin` / `rustfsadmin` when custom credentials are not configured. Use these defaults only for a throwaway local test. Configure a unique access key and a strong secret key before making the Console reachable by other users.
+RustFS revient à `rustfsadmin` / `rustfsadmin` lorsque aucun identifiant personnalisé n’est configuré. N’utilisez ces valeurs par défaut que pour un test local jetable. Configurez une clé d’accès unique et une clé secrète robuste avant de rendre la Console accessible à d’autres utilisateurs.
 
 :::
 
-## Operational notes
+## Notes d’exploitation
 
-- Use [TLS](/integration/tls-configured) before exposing the Console outside a trusted network.
-- Restrict network access to the Console listener and configure [Console CORS](/administration/cors) only when cross-origin access is required.
-- The Console session inherits the permissions of the signed-in identity. Use a least-privilege account for routine work.
-- Signing out or an expired session returns you to the login page. Do not store administrator credentials in shared browsers.
+- Utilisez [TLS](/fr/integration/tls-configured) avant d’exposer la Console en dehors d’un réseau de confiance.
+- Restreignez l’accès réseau à l’écouteur de la Console et ne configurez [CORS pour la Console](/fr/administration/cors) que lorsque l’accès inter-origines est requis.
+- La session de la Console hérite des autorisations de l’identité connectée. Utilisez un compte à moindre privilège pour le travail courant.
+- La déconnexion, ou l’expiration de la session, vous ramène à la page de connexion. Ne stockez pas les identifiants d’administrateur dans des navigateurs partagés.
 
-## Management workflows
+## Flux de gestion
 
-- [Create and manage buckets](/administration/data/bucket/creation)
-- [Upload and manage objects](/administration/data/object/creation)
-- [Manage access keys](/security-compliance/iam/access-token)
-- [Configure identity and access management](/security-compliance/iam)
+- [Créer et gérer des compartiments](/fr/administration/data/bucket/creation)
+- [Charger et gérer des objets](/fr/administration/data/object/creation)
+- [Gérer les clés d’accès](/fr/security-compliance/iam/access-token)
+- [Configurer la gestion des identités et des accès](/fr/security-compliance/iam)
 
-## Next steps
+## Étapes suivantes
 
-Review the [security checklist](/installation/requirement/checklists/security-checklists) before exposing the Console outside a trusted network. For OIDC-based login, continue with the [OIDC configuration guide](/security-compliance/oidc).
+Consultez la [liste de contrôle de sécurité](/fr/installation/requirement/checklists/security-checklists) avant d’exposer la Console en dehors d’un réseau de confiance. Pour une connexion fondée sur OIDC, poursuivez avec le [guide de configuration OIDC](/fr/security-compliance/oidc).