Skip to content

Commit e79b335

Browse files
i18n(fr): update integrations-guide/mdx.mdx & markdown-content.mdx (#13957)
Co-authored-by: Thomas Bonnet <thomasbnt@protonmail.com>
1 parent 8a0e622 commit e79b335

2 files changed

Lines changed: 188 additions & 100 deletions

File tree

src/content/docs/fr/guides/integrations-guide/mdx.mdx

Lines changed: 45 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -255,16 +255,18 @@ Une fois l'intégration MDX installée, aucune configuration n'est nécessaire p
255255
Vous pouvez configurer le rendu de votre MDX à l'aide des options suivantes :
256256

257257
* [Options héritées de la configuration Markdown](#options-héritées-de-la-configuration-markdown)
258+
* [`processor`](#processor)
258259
* [`extendMarkdownConfig`](#extendmarkdownconfig)
259260
* [`recmaPlugins`](#recmaplugins)
260261
* [`optimize`](#optimize)
261262

262263
### Options héritées de la configuration Markdown
263264

264-
Toutes les [options de configuration `markdown`](/fr/reference/configuration-reference/#options-de-markdown) peuvent être configurées séparément dans l'intégration MDX. Cela inclut les modules d'extension remark et rehype, la coloration syntaxique, et plus encore. Les options seront par défaut celles de votre configuration Markdown ([voir l'option `extendMarkdownConfig`](#extendmarkdownconfig) pour les modifier).
265+
Toutes les [options de configuration `markdown`](/fr/reference/configuration-reference/#options-de-markdown) peuvent être configurées séparément dans l'intégration MDX, y compris le [processeur Markdown](#processor). Cela inclut les modules d'extension remark et rehype, la coloration syntaxique, et plus encore. Les options seront par défaut celles de votre configuration Markdown ([voir l'option `extendMarkdownConfig`](#extendmarkdownconfig) pour les modifier).
265266

266267
```js title="astro.config.mjs"
267268
import { defineConfig } from 'astro/config';
269+
import { unified } from '@astrojs/markdown-remark';
268270
import mdx from '@astrojs/mdx';
269271
import remarkToc from 'remark-toc';
270272
import rehypePresetMinify from 'rehype-preset-minify';
@@ -275,21 +277,44 @@ export default defineConfig({
275277
mdx({
276278
syntaxHighlight: 'shiki',
277279
shikiConfig: { theme: 'dracula' },
278-
remarkPlugins: [remarkToc],
279-
rehypePlugins: [rehypePresetMinify],
280-
remarkRehype: { footnoteLabel: 'Notes de bas de page' },
281-
gfm: false,
280+
processor: unified({
281+
remarkPlugins: [remarkToc],
282+
rehypePlugins: [rehypePresetMinify],
283+
remarkRehype: { footnoteLabel: 'Notes de bas de page' },
284+
gfm: false
285+
}),
282286
}),
283287
],
284288
});
285289
```
286290

287-
:::caution
288-
MDX ne prend pas en charge la transmission de modules d'extension remark et rehype sous la forme d'une chaîne de caractères. Vous devez installer, importer et appliquer la fonction du module d'extension à la place.
289-
:::
290-
291291
<ReadMore>Voir la [référence des options Markdown](/fr/reference/configuration-reference/#options-de-markdown) pour une liste complète des options.</ReadMore>
292292

293+
### `processor`
294+
295+
<p>
296+
297+
**Type :** `MarkdownProcessor`<br />
298+
**Par défaut :** hérité de [`markdown.processor`](/fr/reference/configuration-reference/#markdownprocessor)<br />
299+
<Since v="6.0.0" pkg="@astrojs/mdx" />
300+
</p>
301+
302+
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`.
303+
304+
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` :
305+
306+
```js title="astro.config.mjs"
307+
import { defineConfig } from 'astro/config';
308+
import { satteri } from '@astrojs/markdown-satteri';
309+
import mdx from '@astrojs/mdx';
310+
311+
export default defineConfig({
312+
integrations: [
313+
mdx({ processor: satteri() }),
314+
],
315+
});
316+
```
317+
293318
### `extendMarkdownConfig`
294319

295320
<p>
@@ -301,28 +326,27 @@ MDX ne prend pas en charge la transmission de modules d'extension remark et rehy
301326

302327
MDX étend par défaut [la configuration Markdown existante de votre projet](/fr/reference/configuration-reference/#options-de-markdown). Pour remplacer certaines options, vous pouvez spécifier leur équivalent dans votre configuration MDX.
303328

304-
Par exemple, supposons que vous avez besoin de désactiver GitHub-Flavored Markdown et d'appliquer un ensemble différent de modules d'extension remark pour les fichiers MDX. Vous pouvez appliquer ces options comme suit, avec `extendMarkdownConfig` activée par défaut :
329+
Par exemple, supposons que vous avez besoin d'une coloration syntaxique différente et d'un ensemble différent de modules d'extension pour les fichiers `.mdx`. Vous pouvez appliquer ces options comme suit, avec `extendMarkdownConfig` activée par défaut :
305330

306331
```js title="astro.config.mjs"
307332
import { defineConfig } from 'astro/config';
333+
import { unified } from '@astrojs/markdown-remark';
308334
import mdx from '@astrojs/mdx';
309335

310336
export default defineConfig({
311337
// ...
312338
markdown: {
313339
syntaxHighlight: 'prism',
314-
remarkPlugins: [remarkPlugin1],
315-
gfm: true,
340+
processor: unified({ remarkPlugins: [remarkPlugin1] }),
316341
},
317342
integrations: [
318343
mdx({
319-
// `syntaxHighlight` héritée de Markdown
344+
// `syntaxHighlight` de Markdown remplacée,
345+
// les fichiers `.mdx` utilisent Shiki à la place.
346+
syntaxHighlight: 'shiki',
320347

321-
// `remarkPlugins` de Markdown ignorés,
322-
// seulement `remarkPlugin2` est appliqué.
323-
remarkPlugins: [remarkPlugin2],
324-
// `gfm` remplacée par `false`
325-
gfm: false,
348+
// `markdown.processor` est remplacée pour les fichiers `.mdx` par cette option
349+
processor: unified({ remarkPlugins: [remarkPlugin2] }),
326350
}),
327351
],
328352
});
@@ -332,18 +356,19 @@ Vous pouvez également avoir besoin de désactiver l'extension de la configurati
332356

333357
```js title="astro.config.mjs"
334358
import { defineConfig } from 'astro/config';
359+
import { unified } from '@astrojs/markdown-remark';
335360
import mdx from '@astrojs/mdx';
336361

337362
export default defineConfig({
338363
// ...
339364
markdown: {
340-
remarkPlugins: [remarkPlugin1],
365+
processor: unified({ remarkPlugins: [remarkPlugin] }),
341366
},
342367
integrations: [
343368
mdx({
344369
// La configuration Markdown est désormais ignorée
345370
extendMarkdownConfig: false,
346-
// aucun `remarkPlugins` n'est appliqué
371+
// Processeur `unified()` par défaut utilisé
347372
}),
348373
],
349374
});

0 commit comments

Comments
 (0)