diff --git a/docs/src/content/docs/es/reference/configuration.mdx b/docs/src/content/docs/es/reference/configuration.mdx index 460980f516..2f0981ac44 100644 --- a/docs/src/content/docs/es/reference/configuration.mdx +++ b/docs/src/content/docs/es/reference/configuration.mdx @@ -24,10 +24,22 @@ Puedes pasar las siguientes opciones a la integración `starlight`. ### `title` (requerido) -**tipo:** `string` +**tipo:** `string | Record` Establece el título de tu sitio web. Se utilizará en los metadatos y en el título de la pestaña del navegador. +El valor puede ser un string o para sitios multilingües, un objeto con valores para cada idioma diferente. +Cuando se usa la forma de objeto, las claves deben ser etiquetas BCP-47 (por ejemplo, `en`, `ar` o `zh-CN`): + +```ts +starlight({ + title: { + es: 'Mi encantador sitio de documentación', + de: 'Meine bezaubernde Dokumentationsseite', + }, +}); +``` + ### `description` **tipo:** `string` diff --git a/docs/src/content/docs/es/reference/frontmatter.md b/docs/src/content/docs/es/reference/frontmatter.md index ddc07b2bc8..f7645f786d 100644 --- a/docs/src/content/docs/es/reference/frontmatter.md +++ b/docs/src/content/docs/es/reference/frontmatter.md @@ -270,6 +270,21 @@ pagefind: false --- ``` +### `draft` + +**tipo:** `boolean` +**por defecto:** `false` + +Establece si esta página debe considerarse como un borrador y no incluirse en las [compilaciones de producción](https://docs.astro.build/es/reference/cli-reference/#astro-build) y [grupos de enlaces autogenerados](/es/guides/sidebar/#grupos-autogenerados). Establece en `true` para marcar una página como borrador y hacerla visible solo durante el desarrollo. + +```md +--- +# src/content/docs/example.md +# Excluye esta página de las compilaciones de producción +draft: true +--- +``` + ### `sidebar` **tipo:** [`SidebarConfig`](#sidebarconfig) diff --git a/docs/src/content/docs/es/resources/community-content.mdx b/docs/src/content/docs/es/resources/community-content.mdx index 1cd5a3b535..5ec55f2691 100644 --- a/docs/src/content/docs/es/resources/community-content.mdx +++ b/docs/src/content/docs/es/resources/community-content.mdx @@ -128,5 +128,12 @@ import YouTubeGrid from '~/components/youtube-grid.astro'; description: 'Pon en marcha un nuevo sitio de Starlight en unos 5 minutos', }, + { + href: 'https://www.youtube.com/watch?v=12o7WxjAxjM', + title: + 'Incluye la documentación de Starlight en un proyecto de Next.js con proxies', + description: + 'Configura Starlight como un proyecto de subdirectorio dentro de un sitio web de Next.js', + }, ]} /> diff --git a/docs/src/content/docs/fr/getting-started.mdx b/docs/src/content/docs/fr/getting-started.mdx index 4c38de663f..7c00093bbd 100644 --- a/docs/src/content/docs/fr/getting-started.mdx +++ b/docs/src/content/docs/fr/getting-started.mdx @@ -15,7 +15,7 @@ Consultez les [instructions d'installation manuelle](/fr/manual-setup/) pour ajo Créez un nouveau projet Astro + Starlight en lançant la commande suivante dans votre terminal : - + ```sh @@ -52,7 +52,7 @@ Lorsque vous travaillez localement, [le serveur de développement d'Astro](https À l'intérieur du répertoire de votre projet, exécutez la commande suivante pour démarrer le serveur de développement : - + ```sh @@ -103,7 +103,7 @@ Assurez-vous de mettre à jour Starlight régulièrement ! Starlight est une intégration Astro. Vous pouvez la mettre à jour ainsi que tous autres packages Astro en exécutant la commande suivante dans votre terminal : - + ```sh diff --git a/docs/src/content/docs/fr/guides/components.mdx b/docs/src/content/docs/fr/guides/components.mdx index e9e13b4a97..94f5e93fdf 100644 --- a/docs/src/content/docs/fr/guides/components.mdx +++ b/docs/src/content/docs/fr/guides/components.mdx @@ -87,6 +87,51 @@ Le code ci-dessus génère les onglets suivants sur la page : +#### Onglets synchronisés + +Conservez plusieurs groupes d'onglets synchronisés en ajoutant l'attribut `syncKey`. + +Tous les composants `` sur une page avec la même valeur `syncKey` afficheront le même label actif. +Cela permet à votre lecteur de choisir une fois (par exemple, leur système d'exploitation ou leur gestionnaire de paquets) et de voir leur choix reflété sur l'ensemble de la page. + +Pour synchroniser des onglets liés, ajoutez une propriété `syncKey` identique à chaque composant `` et assurez-vous qu'ils utilisent tous les mêmes libellés de `` : + +```mdx 'syncKey="constellations"' +# src/content/docs/exemple.mdx + +import { Tabs, TabItem } from '@astrojs/starlight/components'; + +_Quelques étoiles :_ + + + Bellatrix, Rigel, Bételgeuse + Pollux, Castor A, Castor B + + +_Quelques exoplanètes :_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + +``` + +Le code ci-dessus génère les onglets suivants sur la page : + +_Quelques étoiles :_ + + + Bellatrix, Rigel, Bételgeuse + Pollux, Castor A, Castor B + + +_Quelques exoplanètes :_ + + + HD 34445 b, Gliese 179 b, Wasp-82 b + Pollux b, HAT-P-24b, HD 50554 b + + ### Cartes import { Card, CardGrid } from '@astrojs/starlight/components'; diff --git a/docs/src/content/docs/fr/guides/css-and-tailwind.mdx b/docs/src/content/docs/fr/guides/css-and-tailwind.mdx index 2a2da0fd59..63f3420119 100644 --- a/docs/src/content/docs/fr/guides/css-and-tailwind.mdx +++ b/docs/src/content/docs/fr/guides/css-and-tailwind.mdx @@ -63,7 +63,7 @@ Le module d'extension Tailwind de Starlight applique la configuration suivante : Démarrez un nouveau projet Starlight avec Tailwind CSS préconfiguré en utilisant `create astro` : - + ```sh @@ -95,7 +95,7 @@ Si vous avez déjà un site Starlight et que vous souhaitez ajouter Tailwind CSS 1. Ajoutez l'intégration Astro pour Tailwind : - + @@ -125,7 +125,7 @@ Si vous avez déjà un site Starlight et que vous souhaitez ajouter Tailwind CSS 2. Installez le module d'extension Tailwind de Starlight : - + diff --git a/docs/src/content/docs/fr/guides/customization.mdx b/docs/src/content/docs/fr/guides/customization.mdx index efaab45ae4..f9cd3ced78 100644 --- a/docs/src/content/docs/fr/guides/customization.mdx +++ b/docs/src/content/docs/fr/guides/customization.mdx @@ -130,7 +130,7 @@ Vous pouvez personnaliser - ou même désactiver - la table des matières global Par défaut, les titres `

` et `

` sont inclus dans la table des matières. Modifiez les niveaux de titres à inclure à l’échelle du site à l’aide des options `minHeadingLevel` et `maxHeadingLevel` dans votre option de configuration [globale `tableOfContents`](/fr/reference/configuration/#tableofcontents). Remplacez ces valeurs par défaut sur une page individuelle en ajoutant les propriétés [frontmatter `tableOfContents`](/fr/reference/frontmatter/#tableofcontents) correspondantes : - + ```md {4-6} @@ -164,7 +164,7 @@ defineConfig({ Désactivez la table des matières complètement en définissant l’option `tableOfContents` à `false`: - + ```md {4} diff --git a/docs/src/content/docs/fr/guides/i18n.mdx b/docs/src/content/docs/fr/guides/i18n.mdx index a1592cdc19..e02ef168b0 100644 --- a/docs/src/content/docs/fr/guides/i18n.mdx +++ b/docs/src/content/docs/fr/guides/i18n.mdx @@ -143,6 +143,34 @@ Starlight s'attend à ce que vous créiez des pages équivalentes dans toutes vo Si une traduction n'est pas encore disponible pour une langue, Starlight affichera aux lecteurs le contenu de cette page dans la langue par défaut (définie via `defaultLocale`). Par exemple, si vous n'avez pas encore créé de version française de votre page À propos et que votre langue par défaut est l'anglais, les visiteurs de `/fr/about` verront le contenu anglais de `/en/about` avec un avis indiquant que cette page n'a pas encore été traduite. Cela vous permet d'ajouter du contenu dans votre langue par défaut et de le traduire progressivement lorsque vos traducteurs en ont le temps. +## Traduire le titre du site + +Par défaut, Starlight utilisera le même titre de site pour toutes les langues. +Si vous avez besoin de personnaliser le titre pour chaque langue, vous pouvez passer un objet à [`title`](/fr/reference/configuration/#title-obligatoire) dans les options de Starlight : + +```diff lang="js" +// astro.config.mjs +import { defineConfig } from 'astro/config'; +import starlight from '@astrojs/starlight'; + +export default defineConfig({ + integrations: [ + starlight({ +- title: 'Ma documentation', ++ title: { ++ fr: 'Ma documentation', ++ 'zh-CN': '我的文档', ++ }, + defaultLocale: 'fr', + locales: { + fr: { label: 'Français' }, + 'zh-cn': { label: '简体中文', lang: 'zh-CN' }, + }, + }), + ], +}); +``` + ## Traduire l'interface utilisateur de Starlight import LanguagesList from '~/components/languages-list.astro'; diff --git a/docs/src/content/docs/fr/guides/pages.mdx b/docs/src/content/docs/fr/guides/pages.mdx index d784f74ca3..047b9fefdd 100644 --- a/docs/src/content/docs/fr/guides/pages.mdx +++ b/docs/src/content/docs/fr/guides/pages.mdx @@ -105,6 +105,7 @@ Les propriétés suivantes diffèrent du frontmatter en Markdown : - La propriété [`slug`](/fr/reference/frontmatter/#slug) n'est pas supportée et est automatiquement définie en fonction de l'URL de la page personnalisée. - L'option [`editUrl`](/fr/reference/frontmatter/#editurl) nécessite une URL pour afficher un lien d'édition. - La propriété [`sidebar`](/fr/reference/frontmatter/#sidebar) du frontmatter permettant de personnaliser l'affichage de la page dans les [groupes de liens autogénérés](/fr/reference/configuration/#sidebar) n'est pas disponible. Les pages utilisant le composant `` ne font pas partie d'une collection et ne peuvent pas être ajoutées à un groupe de liens autogénérés. +- L'option [`draft`](/fr/reference/frontmatter/#draft) affiche uniquement une [note](/fr/reference/overrides/#draftcontentnotice) indiquant que la page est une ébauche, mais ne l'exclut pas automatiquement des déploiements en production. ##### `sidebar` diff --git a/docs/src/content/docs/fr/reference/configuration.mdx b/docs/src/content/docs/fr/reference/configuration.mdx index 35e689c23b..25a4495276 100644 --- a/docs/src/content/docs/fr/reference/configuration.mdx +++ b/docs/src/content/docs/fr/reference/configuration.mdx @@ -25,10 +25,22 @@ Vous pouvez passer les options suivantes à l'intégration `starlight`. ### `title` (obligatoire) -**Type :** `string` +**Type :** `string | Record` Définissez le titre de votre site web. Il sera utilisé dans les métadonnées et dans le titre de l'onglet du navigateur. +La valeur peut être une chaîne de caractères, ou pour les sites multilingues, un objet avec des valeurs pour chacune des différentes locales. +Lorsque vous utilisez la forme objet, les clés doivent être des étiquettes d'identification BCP-47 (par exemple `fr`, `ar`, ou `zh-CN`) : + +```ts +starlight({ + title: { + fr: 'Mon délicieux site de docs', + de: 'Meine bezaubernde Dokumentationsseite', + }, +}); +``` + ### `description` **Type :** `string` diff --git a/docs/src/content/docs/fr/reference/frontmatter.md b/docs/src/content/docs/fr/reference/frontmatter.md index 5f8e55b0fa..be462d60d8 100644 --- a/docs/src/content/docs/fr/reference/frontmatter.md +++ b/docs/src/content/docs/fr/reference/frontmatter.md @@ -268,6 +268,21 @@ pagefind: false --- ``` +### `draft` + +**Type :** `boolean` +**Par défaut :** `false` + +Définit si cette page doit être considérée comme une ébauche et ne pas être incluse dans les [déploiements en production](https://docs.astro.build/fr/reference/cli-reference/#astro-build) et les [groupes de liens générés automatiquement](/fr/guides/sidebar/#groupes-générés-automatiquement). Définissez la valeur à `true` pour marquer une page comme une ébauche et la rendre visible uniquement pendant le développement. + +```md +--- +# src/content/docs/exemple.md +# Exclure cette page des déploiements en production +draft: true +--- +``` + ### `sidebar` **Type :** [`SidebarConfig`](#sidebarconfig) diff --git a/docs/src/content/docs/fr/reference/overrides.md b/docs/src/content/docs/fr/reference/overrides.md index 1f821b7fd7..99b8e20465 100644 --- a/docs/src/content/docs/fr/reference/overrides.md +++ b/docs/src/content/docs/fr/reference/overrides.md @@ -50,6 +50,12 @@ L’étiquette d’identification BCP-47 pour la langue de la page, par exemple Le chemin de base utilisé pour servir une langue. `undefined` pour les slugs de la locale racine. +#### `siteTitle` + +**Type :** `string` + +Le titre du site pour la langue de cette page. + #### `slug` **Type :** `string` @@ -218,7 +224,7 @@ Ces composants affichent la barre de navigation supérieure de Starlight. **Composant par défaut :** [`Header.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Header.astro) Composant d'en-tête affiché en haut de chaque page. -L'implémentation par défaut affiche [``](#sitetitle), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). +L'implémentation par défaut affiche [``](#sitetitle-1), [``](#search), [``](#socialicons), [``](#themeselect) et [``](#languageselect). #### `SiteTitle` @@ -332,6 +338,12 @@ Composant contenant l'élement `

` de la page courante. Les implémentations personnalisées doivent s'assurer qu'elles définissent `id="_top"` sur l'élément `

` comme dans l'implémentation par défaut. +#### `DraftContentNotice` + +**Composant par défaut :** [`DraftContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/DraftContentNotice.astro) + +Note affichée aux utilisateurs durant le développement lorsque la page actuelle est marquée comme une ébauche. + #### `FallbackContentNotice` **Composant par défaut :** [`FallbackContentNotice.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/FallbackContentNotice.astro)