diff options
author | Paul Valladares | 2023-07-11 11:44:03 -0600 |
---|---|---|
committer | GitHub | 2023-07-11 19:44:03 +0200 |
commit | a893bea0c3c4c8bbb6657943bef63a5c06c45bb9 (patch) | |
tree | 7c1da92361cb429e7f39e869a35c0665f44a4a07 | |
parent | 8a1179a2353f28e57b3e22bbae5150574d2f0b31 (diff) | |
download | IT.starlight-a893bea0c3c4c8bbb6657943bef63a5c06c45bb9.tar.gz IT.starlight-a893bea0c3c4c8bbb6657943bef63a5c06c45bb9.tar.bz2 IT.starlight-a893bea0c3c4c8bbb6657943bef63a5c06c45bb9.zip |
i18n(fr): Update `components.mdx` (#327)
-rw-r--r-- | docs/src/content/docs/fr/guides/components.mdx | 41 |
1 files changed, 40 insertions, 1 deletions
diff --git a/docs/src/content/docs/fr/guides/components.mdx b/docs/src/content/docs/fr/guides/components.mdx index 5e1000cf..ec6c21d5 100644 --- a/docs/src/content/docs/fr/guides/components.mdx +++ b/docs/src/content/docs/fr/guides/components.mdx @@ -33,6 +33,20 @@ import AnotherComponent from '../../components/AnotherComponent.astro'; Starlight étant alimenté par Astro, vous pouvez ajouter la prise en charge des composants construits avec n'importe quel [cadre d'interface utilisateur pris en charge (React, Preact, Svelte, Vue, Solid, Lit et Alpine)](https://docs.astro.build/fr/core-concepts/framework-components/) dans vos fichiers MDX. Pour en savoir plus sur [l'utilisation de composants dans MDX](https://docs.astro.build/fr/guides/markdown-content/#using-components-in-mdx), consultez la documentation Astro. +### Compatibilité avec les styles de Starlight + +Starlight applique des styles par défaut à votre contenu Markdown, par exemple en ajoutant une marge entre les éléments. +Si ces styles entrent en conflit avec l'apparence de votre composant, définissez la classe `not-content` sur votre composant pour les désactiver. + +```astro +--- +// src/components/Example.astro +--- +<div class="not-content"> + <p>Contenu non affecté par les styles par défaut de Starlight.</p> +</div> +``` + ## Composants intégrés Starlight fournit quelques composants intégrés pour les cas d'utilisation courants de la documentation. @@ -68,7 +82,7 @@ import { Card, CardGrid } from '@astrojs/starlight/components'; Vous pouvez afficher du contenu dans une boîte correspondant aux styles de Starlight en utilisant le composant `<Card>`. Enveloppez plusieurs cartes dans le composant `<CardGrid>` pour afficher les cartes côte à côte lorsqu'il y a suffisamment d'espace. -Une `<Card>` nécessite un `titre` et peut éventuellement inclure un attribut `icon` fixé au nom de [l'une des icônes intégrées de Starlight](https://github.com/withastro/starlight/blob/main/packages/starlight/components/Icons.ts). +Une `<Card>` nécessite un `title` et peut optionellement inclure un attribut `icon` fixé au nom de [l'une des icônes intégrées de Starlight](#toutes-les-icônes). ```mdx import { Card, CardGrid } from '@astrojs/starlight/components'; @@ -109,3 +123,28 @@ Ajoutez l'attribut `stagger` pour décaler verticalement la deuxième colonne de ``` ::: + +### Icônes + +import { Icon } from '@astrojs/starlight/components'; +import IconsList from '../../../../components/icons-list.astro'; + +Starlight fournit un ensemble d'icônes courantes que vous pouvez afficher dans votre contenu à l'aide du composant `<Icon>`. + +Chaque `<Icon>` nécessite un [`name`](#toutes-les-icônes) et peut optionellement inclure un attribut `label`, `size` et `color`. + +```mdx +import { Icon } from '@astrojs/starlight/components'; + +<Icon name="star" color="goldenrod" size="2rem" /> +``` + +Le code ci-dessus génère ce qui suit sur la page : + +<Icon name="star" color="goldenrod" size="2rem" /> + +#### Toutes les icônes + +Une liste de toutes les icônes disponibles est affichée ci-dessous avec leurs noms associés. + +<IconsList />
\ No newline at end of file |