docs(i18n): single language configuration

larbish · larbish · commit 70f44387b1af · 2025-11-26T13:29:03.000+01:00
diff --git a/docs/content/en/1.getting-started/4.project-structure.md b/docs/content/en/1.getting-started/4.project-structure.md
@@ -110,7 +110,20 @@ export default defineNuxtConfig({
 You need a `nuxt.config.ts` to be set if you want to override app configuration.
 ::
 
-This is where you can [configure Docus](/en/concepts/configuration) to fit your branding, handle SEO and adapt links and socials.
+This is where you can [configure Docus](/en/concepts/configuration) to fit your branding, handle SEO, set your locale, and adapt links and socials.
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'en', // Set your single-language locale
+  },
+  seo: {
+    title: 'My Docs',
+    description: 'My awesome documentation',
+  },
+  // ... other configurations
+})
+```
 
 ## Full Nuxt Project Capabilities
 
diff --git a/docs/content/en/2.concepts/3.configuration.md b/docs/content/en/2.concepts/3.configuration.md
@@ -158,6 +158,27 @@ export default defineAppConfig({
 })
 ```
 
+## Locale
+
+For single-language documentation (without the full `@nuxtjs/i18n` module), you can configure the locale through `app.config.ts`:
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'fr', // Default: 'en'
+  }
+})
+```
+
+This sets the language for:
+- UI component translations
+- The `lang` and `dir` attributes on the `<html>` tag
+- Built-in Docus interface strings
+
+::prose-tip{to="/en/concepts/internationalization"}
+For multi-language documentation with language switching, see the [Internationalization guide](/en/concepts/internationalization).
+::
+
 ## GitHub Integration
 
 Docus reads your `.git/` folder to get the `url` and `branch` of your repository to add:
diff --git a/docs/content/en/2.concepts/6.internationalization.md b/docs/content/en/2.concepts/6.internationalization.md
@@ -16,8 +16,25 @@ Docus v4 introduces **native internationalization support** based on the `@nuxtj
 - **Dynamic locale routing**: Automatic URL prefixing with language codes (`/en/docs`, `/fr/docs`)
 - **Content collections per locale**: Separate content management for each language
 - **Language switcher**: Built-in component for switching between locales
+- **Single-language configuration**: Simple locale configuration for single-language sites via `app.config.ts`
 
-## Setup an existing project
+## Single Language Configuration
+
+If you're building documentation in a single language (without the full `@nuxtjs/i18n` module), you can configure the locale through `app.config.ts`. This is useful for setting the language for UI components and localizing built-in strings.
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'fr', // Set your locale (default: 'en')
+  }
+})
+```
+
+## Multi-Language Setup
+
+For multi-language documentation, use the full `@nuxtjs/i18n` integration as described below.
+
+### Setup an existing project
 
 To enable i18n in your Docus project, add the `@nuxtjs/i18n` module to your `nuxt.config.ts` and define your locales:
 
diff --git a/docs/content/fr/1.getting-started/4.project-structure.md b/docs/content/fr/1.getting-started/4.project-structure.md
@@ -105,12 +105,25 @@ export default defineNuxtConfig({
 
 *Ce fichier n'est pas obligatoire pour démarrer une application Docus.*
 
-C'est ici que vous pouvez [configurer Docus](/fr/concepts/configuration) pour l'adapter à votre marque, gérer le SEO et adapter les liens et réseaux sociaux.
-
 ::prose-warning
 Un fichier `nuxt.config.ts` doit être existant pour surcharger votre app config. Sans le fichier Nuxt config, vos surcharges ne seront pas prises en compte.
 ::
 
+C'est ici que vous pouvez [configurer Docus](/fr/concepts/configuration) pour l'adapter à votre marque, gérer le SEO, définir votre locale et adapter les liens et réseaux sociaux.
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'fr', // Définir votre locale monolingue
+  },
+  seo: {
+    title: 'Ma Documentation',
+    description: 'Ma super documentation',
+  },
+  // ... autres configurations
+})
+```
+
 ## Structure complète d'un projet Nuxt
 
 Puisque Docus v4 est un layer Nuxt, vous pouvez utiliser **n'importe quelle fonctionnalité** d'un projet Nuxt standard :
diff --git a/docs/content/fr/2.concepts/3.configuration.md b/docs/content/fr/2.concepts/3.configuration.md
@@ -159,6 +159,27 @@ export default defineAppConfig({
 })
 ```
 
+## Locale
+
+Pour une documentation monolingue (sans le module complet `@nuxtjs/i18n`), vous pouvez configurer la locale via `app.config.ts` :
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'fr', // Par défaut : 'en'
+  }
+})
+```
+
+Ceci définit la langue pour :
+- Les traductions des composants UI
+- Les attributs `lang` et `dir` sur la balise `<html>`
+- Les chaînes d'interface intégrées de Docus
+
+::prose-tip{to="/fr/concepts/internationalization"}
+Pour une documentation multilingue avec changement de langue, consultez le [guide d'internationalisation](/fr/concepts/internationalization).
+::
+
 ## Intégration GitHub
 
 Docus lit votre dossier `.git/` pour obtenir l'`url` et la `branch` de votre dépôt afin d'ajouter :
diff --git a/docs/content/fr/2.concepts/6.internationalization.md b/docs/content/fr/2.concepts/6.internationalization.md
@@ -15,8 +15,30 @@ Docus v4 introduit un **support d'internationalisation natif** basé sur le modu
 - **Routage de locale dynamique** : Préfixage automatique des URL avec les codes de langue (`/en/docs`, `/fr/docs`)
 - **Collections de contenu par locale** : Gestion séparée du contenu pour chaque langue
 - **Sélecteur de langue** : Composant intégré pour basculer entre les locales
+- **Configuration monolingue** : Configuration simple de la locale pour les sites monolingues via `app.config.ts`
 
-## Configurer un projet existant
+## Configuration monolingue
+
+Si vous créez une documentation dans une seule langue (sans le module complet `@nuxtjs/i18n`), vous pouvez configurer la locale via `app.config.ts`. Ceci est utile pour définir la langue des composants UI et localiser les chaînes intégrées.
+
+```ts [app.config.ts]
+export default defineAppConfig({
+  docus: {
+    locale: 'fr', // Définissez votre locale (par défaut : 'en')
+  }
+})
+```
+
+Cette configuration affecte :
+- Les traductions des composants UI (boutons, étiquettes, etc.)
+- Les attributs `lang` et `dir` sur la balise `<html>`
+- Les chaînes d'interface intégrées de Docus
+
+## Configuration multilingue
+
+Pour une documentation multilingue, utilisez l'intégration complète `@nuxtjs/i18n` comme décrit ci-dessous.
+
+### Configurer un projet existant
 
 Pour activer l'i18n dans votre projet Docus, ajoutez le module `@nuxtjs/i18n` à votre `nuxt.config.ts` et définissez vos locales :
 
