Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
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
18 changes: 12 additions & 6 deletions src/content/docs/fr/guides/integrations-guide/mdx.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -262,20 +262,26 @@ Vous pouvez configurer le rendu de votre MDX à l'aide des options suivantes :

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

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).
Par défaut, toutes les [options de configuration `markdown`](/fr/reference/configuration-reference/#options-de-markdown) sont héritées par l'intégration MDX. Les options transmises à l'intégration MDX remplaceront la configuration `markdown` héritée. Pour ignorer complètement les options `markdown` héritées, utilisez l'option [`extendMarkdownConfig`](#extendmarkdownconfig).

```js title="astro.config.mjs"
L'exemple suivant configure l'intégration MDX pour utiliser un thème de [coloration syntaxique](/fr/guides/syntax-highlighting/) différent, ajouter un [module d'extension](/fr/guides/markdown-content/#modules-dextension-pour-les-processeurs-markdown), et désactiver [GitHub-flavored Markdown](/fr/guides/markdown-content/#github-flavored-markdown) :

```js title="astro.config.mjs" {12-20}
import { defineConfig } from 'astro/config';
import { satteri } from '@astrojs/markdown-satteri';
import mdx from '@astrojs/mdx';
import { myMdastPlugin } from './my-satteri-plugin.mjs';
import { myMdastPlugin } from './mon-module-extension-satteri.mjs';

export default defineConfig({
// ...
markdown: {
shikiConfig: { theme: 'rose-pine' },
},
integrations: [
mdx({
syntaxHighlight: 'shiki',
// Utiliser un thème de coloration syntaxique différent.
shikiConfig: { theme: 'dracula' },
// Ajouter un module d'extension et désactiver GitHub-flavored Markdown.
processor: satteri({
mdastPlugins: [myMdastPlugin()],
features: { gfm: false },
Expand All @@ -296,7 +302,7 @@ export default defineConfig({
<Since v="6.0.0" pkg="@astrojs/mdx" />
</p>

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 défaut, les fichiers `.mdx` sont traités via le même [processeur Markdown](/fr/guides/markdown-content/#processeurs-markdown) que vos fichiers `.md`. Vous pouvez configurer un processeur différent pour MDX ou utiliser le même processeur avec des options différentes.

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` :

Expand Down Expand Up @@ -382,7 +388,7 @@ export default defineConfig({

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).
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/#configurer-un-processeur-markdown).

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.

Expand Down
566 changes: 377 additions & 189 deletions src/content/docs/fr/guides/markdown-content.mdx

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion src/content/docs/fr/guides/migrate-to-astro/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ En fonction de votre projet existant, vous pourrez peut-être réutiliser :

- vos [feuilles de style ou bibliothèques CSS](/fr/guides/styling/), y compris Tailwind.

- vos [fichiers Markdown/MDX](/fr/guides/markdown-content/), avec un [processeur Markdown configurable](/fr/guides/markdown-content/#modules-dextension-markdown) qui prend en charge les modules d'extension.
- vos [fichiers Markdown/MDX](/fr/guides/markdown-content/), avec un [processeur Markdown configurable](/fr/guides/markdown-content/#processeurs-markdown) qui prend en charge les modules d'extension.

- votre [contenu depuis un CMS](/fr/guides/cms/) à travers une intégration ou une API.

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/guides/upgrade-to/v5.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -879,7 +879,7 @@ Les types de `imagePaths` ont également été mis à jour de `Set<string>` à `

Bien que nous ne considérions pas ces API comme publiques, elles sont accessibles aux modules d'extension remark et rehype qui souhaitent réutiliser les métadonnées d'Astro. Si vous utilisez ces API, assurez-vous d'y accéder dans les nouveaux emplacements.

<ReadMore>En savoir plus sur [l'utilisation des modules d'extension de Markdown dans Astro](/fr/guides/markdown-content/#modules-dextension-markdown).</ReadMore>
<ReadMore>En savoir plus sur l'[utilisation de modules d'extension pour les processeurs Markdown dans Astro](/fr/guides/markdown-content/#modules-dextension-pour-les-processeurs-markdown).</ReadMore>

### Modifié : configuration du point de terminaison de l'image

Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/fr/guides/upgrade-to/v7.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,7 @@ Astro traite désormais vos fichiers `.md` et `.mdx` avec [Sätteri](https://sat

Si vous n'utilisez pas de modules d'extension remark ou rehype, vous n'avez rien à faire. Vos fichiers Markdown et MDX seront désormais rendus par Sätteri, qui applique GitHub-Flavored Markdown et SmartyPants comme auparavant.

Si vous dépendez de modules d'extension remark et rehype, vous pouvez les convertir en [modules d'extension MDAST ou HAST pour Sätteri](https://satteri.bruits.org/docs/plugins/). Si vous dépendez de modules d'extension recma, ou si vous n'êtes pas encore prêt ou capable de convertir vos modules d'extension remark et rehype, vous pouvez [rester sur le pipeline `unified()`](/fr/guides/markdown-content/#basculer-vers-le-processeur-unified).
Si vous dépendez de modules d'extension remark et rehype, vous pouvez les convertir en [modules d'extension MDAST ou HAST pour Sätteri](https://satteri.bruits.org/docs/plugins/). Si vous dépendez de modules d'extension recma, ou si vous n'êtes pas encore prêt ou capable de convertir vos modules d'extension remark et rehype, vous pouvez [rester sur le pipeline `unified()`](/fr/guides/markdown-content/#configurer-un-processeur-markdown).

Pour continuer à utiliser les modules d'extension unified :

Expand All @@ -244,7 +244,7 @@ Pour continuer à utiliser les modules d'extension unified :
</Fragment>
</PackageManagerTabs>

2. Définissez [`unified()` en tant que processeur Markdown](/fr/guides/markdown-content/#basculer-vers-le-processeur-unified) :
2. Définissez [`unified()` en tant que processeur Markdown](/fr/guides/markdown-content/#configurer-un-processeur-markdown) :

```js title="astro.config.mjs" ins={2,6}
import { defineConfig } from 'astro/config';
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/recipes/external-links.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ En utilisant un module d'extension Rehype, vous pouvez identifier et modifier le

2. Configurez le module d'extension dans votre fichier `astro.config.mjs`.

Importez `unified()` et définissez-le en tant que processeur Markdown pour [prendre en charge les modules d'extension remark](/fr/guides/markdown-content/#utilisation-des-modules-dextension-remark-et-rehype). Ensuite, transmettez à `rehypePlugins` un tableau contenant votre module d'extension `rehypeExternalLinks` importé et un objet d'options avec une propriété `content`. Définissez le `type` de cette propriété sur `text` si vous souhaitez ajouter du texte brut à la fin du lien. Pour ajouter du HTML à la fin du lien, définissez la propriété `type` sur `raw`.
Importez `unified()` et définissez-le en tant que [processeur Markdown pour prendre en charge les modules d'extension remark](/fr/guides/markdown-content/#configurer-un-processeur-markdown). Ensuite, transmettez à `rehypePlugins` un tableau contenant votre module d'extension `rehypeExternalLinks` importé et un objet d'options avec une propriété `content`. Définissez le `type` de cette propriété sur `text` si vous souhaitez ajouter du texte brut à la fin du lien. Pour ajouter du HTML à la fin du lien, définissez la propriété `type` sur `raw`.

```js title="astro.config.mjs"
import { unified } from '@astrojs/markdown-remark';
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/recipes/modified-time.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ Cette recette calcule la date en fonction de l'historique Git de votre dépôt,
## Recette

<Steps>
1. Installez [`Day.js`](https://www.npmjs.com/package/dayjs) pour modifier et formater les heures, et [`@astrojs/markdown-remark`](https://www.npmjs.com/package/@astrojs/markdown-remark) pour utiliser le [processeur `unified()`](/fr/guides/markdown-content/#utilisation-des-modules-dextension-remark-et-rehype) :
1. Installez [`Day.js`](https://www.npmjs.com/package/dayjs) pour modifier et formater les heures, et [`@astrojs/markdown-remark`](https://www.npmjs.com/package/@astrojs/markdown-remark) pour utiliser le [processeur `unified()`](/fr/guides/markdown-content/#configurer-un-processeur-markdown) :

<PackageManagerTabs>
<Fragment slot="npm">
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/recipes/reading-time.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Créez un [module d'extension Remark](https://github.com/remarkjs/remark) qui aj
1. Installer les paquets suivants :
- [`reading-time`](https://www.npmjs.com/package/reading-time) pour calculer les minutes de lecture
- [`mdast-util-to-string`](https://www.npmjs.com/package/mdast-util-to-string) pour extraire tout le texte de votre markdown
- [`@astrojs/markdown-remark`](https://www.npmjs.com/package/@astrojs/markdown-remark) pour utiliser [le processeur `unified()`](/fr/guides/markdown-content/#utilisation-des-modules-dextension-remark-et-rehype)
- [`@astrojs/markdown-remark`](https://www.npmjs.com/package/@astrojs/markdown-remark) pour utiliser [le processeur `unified()`](/fr/guides/markdown-content/#configurer-un-processeur-markdown)

<PackageManagerTabs>
<Fragment slot="npm">
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/fr/reference/modules/astro-content.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -353,7 +353,7 @@ Une fonction permettant de compiler une entrée donnée pour le rendu. Elle renv

- `<Content />` - Un composant utilisé pour restituer le contenu du document dans un fichier Astro.
- `headings` - Une liste générée de titres, [reflétant l'utilitaire `getHeadings()` d'Astro](/fr/guides/markdown-content/#propriétés-disponibles) sur les importations Markdown et MDX.
- `remarkPluginFrontmatter ` - L'objet frontmatter modifié après que tous les [modules d'extension pour Markdown ont été appliqués](/fr/guides/markdown-content/#modification-programmatique-du-frontmatter). Définit sur le type `any`.
- `remarkPluginFrontmatter ` - L'objet frontmatter modifié après que tous les [modules d'extension pour processeur Markdown ont été appliqués](/fr/guides/markdown-content/#modification-programmatique-du-frontmatter). Définit sur le type `any`.

```astro title="src/pages/blog/article-1.astro"
---
Expand Down
Loading