diff --git a/docs/src/content/docs/fr/guides/authoring-content.md b/docs/src/content/docs/fr/guides/authoring-content.mdx similarity index 83% rename from docs/src/content/docs/fr/guides/authoring-content.md rename to docs/src/content/docs/fr/guides/authoring-content.mdx index 34bf6d18ccb..e64af988f90 100644 --- a/docs/src/content/docs/fr/guides/authoring-content.md +++ b/docs/src/content/docs/fr/guides/authoring-content.mdx @@ -202,8 +202,8 @@ Un bloc de code est indiqué par un bloc avec trois accents graves ``` + + +```sh +npm create astro@latest -- --template starlight/markdoc +``` + + + + +```sh +pnpm create astro --template starlight/markdoc +``` + + + + +```sh +yarn create astro --template starlight/markdoc +``` + + + + +### Ajouter Markdoc à un projet existant + +Si vous disposez déjà d'un site Starlight et que vous souhaitez ajouter Markdoc, suivez ces étapes. + + + +1. Ajoutez l'intégration Markdoc d'Astro : + + + + + + ```sh + npx astro add markdoc + ``` + + + + + + ```sh + pnpm astro add markdoc + ``` + + + + + + ```sh + yarn astro add markdoc + ``` + + + + + +2. Installez la préconfiguration Markdoc de Starlight : + + + + + + ```sh + npm install @astrojs/starlight-markdoc + ``` + + + + + + ```sh + pnpm add @astrojs/starlight-markdoc + ``` + + + + + + ```sh + yarn add @astrojs/starlight-markdoc + ``` + + + + + +3. Créez une configuration Markdoc dans le fichier `markdoc.config.mjs` et utilisez la préconfiguration Markdoc de Starlight : + + ```js + import { defineMarkdocConfig } from '@astrojs/markdoc/config'; + import starlightMarkdoc from '@astrojs/starlight-markdoc'; + + export default defineMarkdocConfig({ + extends: [starlightMarkdoc()], + }); + ``` + + + +Pour en savoir plus sur la syntaxe et les fonctionnalités de Markdoc, consultez la [documentation Markdoc](https://markdoc.dev/docs/syntax) ou le [guide de l'intégration Astro Markdoc](https://docs.astro.build/fr/guides/integrations-guide/markdoc/). diff --git a/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts b/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts index f70e4f1babe..7206579a1a5 100644 --- a/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts +++ b/packages/starlight/__tests__/i18n-sidebar/i18n-sidebar.test.ts @@ -15,7 +15,7 @@ vi.mock('astro:content', async () => ['guides/pages.mdx', { title: 'Pages' }], ['fr/guides/pages.mdx', { title: 'Pages' }], ['guides/authoring-content.mdx', { title: 'Authoring Content in Markdown' }], - ['fr/guides/authoring-content.md', { title: 'Création de contenu en Markdown' }], + ['fr/guides/authoring-content.mdx', { title: 'Création de contenu en Markdown' }], ['resources/plugins.mdx', { title: 'Plugins and Integrations' }], ['fr/resources/plugins.mdx', { title: "Modules d'extension et outils" }], ], diff --git a/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts b/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts index 8fda76007cb..0b11992d499 100644 --- a/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts +++ b/packages/starlight/__tests__/i18n-sidebar/sidebar-internal-link-error.test.ts @@ -13,7 +13,7 @@ vi.mock('astro:content', async () => ['guides/pages.mdx', { title: 'Pages' }], ['fr/guides/pages.mdx', { title: 'Pages' }], ['guides/authoring-content.mdx', { title: 'Authoring Content in Markdown' }], - ['fr/guides/authoring-content.md', { title: 'Création de contenu en Markdown' }], + ['fr/guides/authoring-content.mdx', { title: 'Création de contenu en Markdown' }], ['resources/plugins.mdx', { title: 'Plugins and Integrations' }], ['fr/resources/plugins.mdx', { title: "Modules d'extension et outils" }], ],