Skip to content

i18n(fr): update integrations-guide/mdx #14155

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ArmandPhilippot wants to merge 1 commit into
base: main
Choose a base branch
from
Open

i18n(fr): update integrations-guide/mdx #14155

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 16 additions & 17 deletions src/content/docs/fr/guides/integrations-guide/mdx.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -266,22 +266,19 @@

```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
import { unified } from '@astrojs/markdown-remark';
import { satteri } from '@astrojs/markdown-satteri';
import mdx from '@astrojs/mdx';
import remarkToc from 'remark-toc';
import rehypePresetMinify from 'rehype-preset-minify';
import { myMdastPlugin } from './my-satteri-plugin.mjs';

export default defineConfig({
// ...
integrations: [
mdx({
syntaxHighlight: 'shiki',
shikiConfig: { theme: 'dracula' },
processor: unified({
remarkPlugins: [remarkToc],
rehypePlugins: [rehypePresetMinify],
remarkRehype: { footnoteLabel: 'Notes de bas de page' },
gfm: false
processor: satteri({
mdastPlugins: [myMdastPlugin()],
features: { gfm: false },
}),
}),
],
Expand All @@ -301,16 +298,16 @@

Par défaut, les fichiers `.mdx` sont traités via le même [processeur Markdown](/fr/guides/markdown-content/#choisir-un-processeur-markdown) que vos fichiers `.md`. Définissez `processor` pour utiliser un processeur différent, ou le même processeur avec des options différentes, uniquement pour les fichiers `.mdx`.

Par exemple, pour conserver le processeur remark/rehype par défaut pour les fichiers `.md` tout en traitant les fichiers `.mdx` avec [Sätteri](https://satteri.bruits.org/) en utilisant `@astrojs/markdown-satteri` :
Par exemple, pour conserver [Sätteri](https://satteri.bruits.org/) comme processeur par défaut pour les fichiers `.md` tout en traitant les fichiers `.mdx` avec remark et rehype à l'aide de `@astrojs/markdown-remark` :

```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
import { satteri } from '@astrojs/markdown-satteri';
import { unified } from '@astrojs/markdown-remark';
import mdx from '@astrojs/mdx';

export default defineConfig({
integrations: [
mdx({ processor: satteri() }),
mdx({ processor: unified() }),
],
});
```
Expand All @@ -330,14 +327,14 @@

```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
import { unified } from '@astrojs/markdown-remark';
import { satteri } from '@astrojs/markdown-satteri';
import mdx from '@astrojs/mdx';

export default defineConfig({
// ...
markdown: {
syntaxHighlight: 'prism',
processor: unified({ remarkPlugins: [remarkPlugin1] }),
processor: satteri({ mdastPlugins: [mdastPlugin1] }),
},
integrations: [
mdx({
Expand All @@ -346,7 +343,7 @@
syntaxHighlight: 'shiki',

// `markdown.processor` est remplacée pour les fichiers `.mdx` par cette option
processor: unified({ remarkPlugins: [remarkPlugin2] }),
processor: satteri({ mdastPlugins: [mdastPlugin2] }),
}),
],
});
Expand All @@ -356,19 +353,19 @@

```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
import { unified } from '@astrojs/markdown-remark';
import { satteri } from '@astrojs/markdown-satteri';
import mdx from '@astrojs/mdx';

export default defineConfig({
// ...
markdown: {
processor: unified({ remarkPlugins: [remarkPlugin] }),
processor: satteri({ mdastPlugins: [mdastPlugin] }),
},
integrations: [
mdx({
// La configuration Markdown est désormais ignorée
extendMarkdownConfig: false,
// Processeur `unified()` par défaut utilisé
// Processeur `satteri()` par défaut utilisé
}),
],
});
Expand All @@ -385,6 +382,8 @@

Il s'agit de modules d'extension qui modifient directement la sortie [estree](https://github.com/estree/estree). Ceci est utile pour modifier ou injecter des variables JavaScript dans vos fichiers MDX.

Depuis Astro v7, le processeur Markdown par défaut ne prend pas en charge les modules d'extension Recma. Si votre projet en dépend, vous pouvez [utiliser le processeur `unified()`](/fr/guides/markdown-content/#basculer-vers-le-processeur-unified).

Check failure on line 385 in src/content/docs/fr/guides/integrations-guide/mdx.mdx

View workflow job for this annotation

GitHub Actions / Check Links 

Broken fragment link in src/content/docs/fr/guides/integrations-guide/mdx.mdx, line 385: The linked page does not contain a fragment with the name "#basculer-vers-le-processeur-unified". Available fragments: #theme-icons, #gradient, #starlight__sidebar, #__tab-tutoriel, #__tab-guide, #__tab-référence, #__tab-écosystème, #starlight__mobile-toc, #starlight__on-this-page--mobile, #starlight__on-this-page, #learn-astro-course-1, #_top, #organiser-les-fichiers-markdown, #importations-de-fichiers-vs-requêtes-de-collections-de-contenu, #expressions-dynamiques-de-type-jsx, #propriétés-disponibles, #markdown-à-partir-des-requêtes-de-collections-de-contenu, #importation-de-markdown, #le-composant-content-, #id-des-titres, #id-de-titres-et-modules-dextension, #tab-1269, #tab-1270, #tab-panel-1269, #tab-panel-1270, #modules-dextension-markdown, #choisir-un-processeur-markdown, #utilisation-des-modules-dextension-remark-et-rehype, #personnaliser-un-module-dextension-remark-ou-rehype, #basculer-vers-le-processeur-sätteri, #modification-programmatique-du-frontmatter, #étendre-la-configuration-markdown-à-partir-de-mdx, #pages-markdown-individuelles, #propriété-layout-du-frontmatter, #récupérer-du-markdown-à-distance, #docsearch-lvl0, #learn-astro-course-2

Nous vous suggérons [d'utiliser AST Explorer](https://astexplorer.net/) pour jouer avec les sorties d'estree, et d'essayer [`estree-util-visit`](https://unifiedjs.com/explore/package/estree-util-visit/) pour effectuer des recherches dans les nœuds JavaScript.

### `optimize`
Expand Down
Loading