Skip to content

Commit

Permalink
i18n(fr): Update mdx.mdx file from #8224
Browse files Browse the repository at this point in the history
Signed-off-by: Thomas Bonnet <thomasbnt@protonmail.com>
  • Loading branch information
thomasbnt committed May 11, 2024
1 parent e1e2584 commit 99a115f
Showing 1 changed file with 11 additions and 7 deletions.
18 changes: 11 additions & 7 deletions src/content/docs/fr/guides/integrations-guide/mdx.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ i18nReady: true
---
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
import ReadMore from '~/components/ReadMore.astro'
import Since from '~/components/Since.astro'

Cette **[intégration Astro][astro-integration]** permet d'utiliser les composants [MDX](https://mdxjs.com/) et de créer des pages sous forme de fichiers `.mdx`.

Expand Down Expand Up @@ -196,7 +197,7 @@ Nous vous suggérons [d'utiliser AST Explorer](https://astexplorer.net/) pour jo

### `optimize`

* **Type:** `boolean | { customComponentNames?: string[] }`
* **Type :** `boolean | { ignoreElementNames?: string[] }`

Il s'agit d'un paramètre de configuration facultatif qui permet d'optimiser la sortie MDX pour une construction et un rendu plus rapides grâce à un plugin rehype interne. Cela peut être utile si vous avez beaucoup de fichiers MDX et que vous constatez des lenteurs dans la construction. Cependant, cette option peut générer du HTML non échappé, assurez-vous donc que les parties interactives de votre site fonctionnent toujours correctement après l'avoir activée.

Expand All @@ -216,13 +217,16 @@ export default defineConfig({
});
```

#### `customComponentNames`
#### `ignoreElementNames`

* **Type:** `string[]`
* **Type :** `string[]`

Une propriété optionnelle de `optimize` pour empêcher l'optimisateur MDX de gérer tout [composant personnalisé passé au contenu MDX importé via la propriété components](/fr/guides/markdown-content/#composants-personnalisés-avec-du-mdx-importé).
<p><Since pkg="@astrojs/mdx" v="3.0.0" /></p>
Précédemment connu sous le nom de `customComponentNames`.

Vous devrez exclure ces composants de l'optimisation, car l'optimisateur convertit trop rapidement le contenu en une chaîne statique, ce qui brisera les composants personnalisés qui ont besoin d'être rendus dynamiquement.
Une propriété optionnelle de `optimize` pour empêcher l'optimiseur MDX de gérer certains noms d'éléments, comme [les composants personnalisés passés au contenu MDX importé via la propriété components](/fr/guides/markdown-content/#custom-components-with-imported-mdx).

Vous devrez exclure ces composants de l'optimisation, car l'optimiseur convertit trop rapidement le contenu en une chaîne statique, ce qui brisera les composants personnalisés qui ont besoin d'être rendus dynamiquement.

Par exemple, la sortie MDX prévue pour ce qui suit est `<Heading>...</Heading>` à la place de chaque `"<h1>...</h1>"` :

Expand All @@ -235,7 +239,7 @@ import Heading from '../Heading.astro';
<Content components={{ ...components, h1: Heading }} />
```

Pour configurer l'optimisation à l'aide de la propriété `customComponentNames`, spécifiez un tableau de noms d'éléments HTML qui doivent être traités comme des composants personnalisés :
Pour configurer l'optimisation à l'aide de la propriété `ignoreElementNames`, spécifiez un tableau de noms d'éléments HTML qui doivent être traités comme des composants personnalisés :

```js title="astro.config.mjs"
import { defineConfig } from 'astro/config';
Expand All @@ -248,7 +252,7 @@ export default defineConfig({
optimize: {
// Empêcher l'optimisateur de traiter les éléments `h1`.
// Ceux-ci seront traités comme des composants personnalisés
customComponentNames: ['h1'],
ignoreElementNames: ['h1'],
},
}),
],
Expand Down

0 comments on commit 99a115f

Please sign in to comment.