Skip to main content

Cette version de GitHub Enterprise Server n'est plus disponible depuis le 2024-09-25. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Organisation des informations avec des sections réduites

Vous pouvez simplifier votre Markdown en créant une section réduite avec la balise <details>.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Création d’une section réduite

Vous pouvez masquer temporairement des sections de votre Markdown en créant une section réduite que le lecteur peut choisir de développer. Par exemple, quand vous voulez inclure des détails techniques dans un commentaire de problème qui sont susceptibles de ne pas être pertinents ou de ne pas intéresser tous les lecteurs, vous pouvez les placer dans une section réduite.

Tout Markdown au sein du bloc <details> est réduit jusqu’à ce que le lecteur clique sur pour développer les détails.

Dans le bloc <details>, utilisez la balise <summary> pour informer les lecteurs de ce qui se trouve à l’intérieur. L’étiquette apparaît à droite de .

<details>

<summary>Tips for collapsed sections</summary>

### You can add a header

You can add text within a collapsed section. 

You can add an image or a code block, too.

```ruby
   puts "Hello World"
```

</details>

Le Markdown à l’intérieur de la balise <summary> est réduit par défaut :

Capture d’écran du Markdown ci-dessus sur cette page, tel qu’il est affiché sur GitHub, montrant une flèche vers la droite et l’en-tête « Conseils pour les sections réduites ».

Une fois qu’un lecteur clique sur , les détails sont développés :

Capture d’écran du Markdown ci-dessus sur cette page, tel qu’il est affiché sur GitHub, indiquant qu’une section réduite peut contenir des en-têtes, des phrases de texte, des images et des blocs de code.

Si vous le souhaitez, pour que la section s'affiche ouverte par défaut, ajoutez l'attribut open à la balise <details> :

<details open>

Pour aller plus loin