> ## Documentation Index
> Fetch the complete documentation index at: https://adminroletesting-dmytro-mintlify-update-0nfoy34.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Créer et modifier des pages

> Créez, modifiez et organisez des pages de documentation dans l'éditeur web.

<div id="navigate-files">
  ## Parcourir les fichiers
</div>

Parcourez vos pages de documentation dans l'onglet **Navigation** du panneau latéral gauche.

* Cliquez sur les éléments de navigation pour les développer ou les réduire.
* Cliquez sur les pages pour les ouvrir dans l'éditeur.
* Cliquez sur l'icône de recherche ou appuyez sur <kbd>Cmd</kbd> + <kbd>K</kbd> (macOS) ou <kbd>Ctrl</kbd> + <kbd>K</kbd> (Windows) pour rechercher des fichiers et du contenu. La recherche trouve des correspondances à la fois dans les noms de fichiers et dans le contenu des pages.
* Cliquez sur le bouton Masquer la barre latérale dans la barre d'outils pour réduire la barre latérale et laisser plus d'espace à l'éditeur.

<Note>
  L'onglet de navigation liste les pages par titre. L'onglet des fichiers liste les pages par nom de fichier et extension.
</Note>

<div id="create-new-pages">
  ## Créer de nouvelles pages
</div>

1. Cliquez sur le bouton <Icon icon="plus" /> plus dans l'élément de navigation où vous souhaitez ajouter une page.
2. Cliquez sur **Ajouter une page**.
3. Saisissez un nom de fichier. L'éditeur ajoute automatiquement l'extension `.mdx`.

<div id="edit-content">
  ## Modifier le contenu
</div>

Basculez entre le mode visuel et le Markdown mode à l'aide du bouton de bascule dans la barre d'outils. L'éditeur web enregistre vos modifications lors du changement de mode.

<Note>
  Les fichiers de spécification d'API (OpenAPI et AsyncAPI) sont en lecture seule dans l'éditeur web. Vous pouvez consulter leur contenu, mais vous ne pouvez pas les modifier directement. Pour mettre à jour un fichier de spécification, modifiez-le avec votre éditeur de code préféré et poussez les modifications vers votre dépôt de documentation.
</Note>

<Frame>
  <img src="https://mintcdn.com/adminroletesting-dmytro-mintlify-update-0nfoy34/zqq4GrpqWTAZNPAr/images/editor/mode-toggle-light.png?fit=max&auto=format&n=zqq4GrpqWTAZNPAr&q=85&s=cfb759d5bad29be2a0e13c803307b02c" alt="Bouton de bascule de mode dans la barre d'outils." className="block dark:hidden" width="332" height="84" data-path="images/editor/mode-toggle-light.png" />

  <img src="https://mintcdn.com/adminroletesting-dmytro-mintlify-update-0nfoy34/zqq4GrpqWTAZNPAr/images/editor/mode-toggle-dark.png?fit=max&auto=format&n=zqq4GrpqWTAZNPAr&q=85&s=ade7ba596922c71f48633e7801cd431d" alt="Bouton de bascule de mode dans la barre d'outils." className="hidden dark:block" width="330" height="82" data-path="images/editor/mode-toggle-dark.png" />
</Frame>

<div id="visual-mode">
  ### Mode visuel
</div>

Modifiez le contenu avec des aperçus en temps réel qui montrent à quoi il ressemblera une fois publié. L'éditeur utilise le correcteur orthographique intégré à votre navigateur pour mettre en évidence les mots mal orthographiés pendant la saisie.

* **Ajouter du texte** : Saisissez du texte dans l'éditeur pour voir comment il apparaîtra une fois publié.
* **Mettre le texte en forme** : Utilisez la barre d'outils pour mettre le texte en gras, en italique ou appliquer d'autres styles de mise en forme.
* **Ajouter des composants** : Appuyez sur <kbd>/</kbd> pour ouvrir le menu des composants et sélectionner des composants.
* **Ajouter des images** : Utilisez le composant d'image depuis le menu <kbd>/</kbd> ou tapez <kbd>/image</kbd>.
* **Ajouter des vidéos** : Tapez <kbd>/video</kbd> pour téléverser ou sélectionner une vidéo.
* **Ajouter du contenu intégré** : Tapez <kbd>/embed</kbd> et collez une URL YouTube, Loom ou Vimeo pour intégrer la vidéo, ou passez à **Intégration manuelle** pour du HTML personnalisé. Voir [Ajouter des médias](/fr/editor/media) pour plus de détails.
* **Ajouter des diagrammes Mermaid** : Tapez <kbd>/mermaid</kbd> pour insérer un diagramme Mermaid avec un aperçu interactif, des contrôles de zoom et de déplacement, un mode plein écran et un éditeur de code.
* **Ajouter des snippets** : Tapez <kbd>/snippet</kbd> pour rechercher et insérer un snippet réutilisable. L'éditeur ajoute automatiquement l'instruction d'importation requise.
* **Ajouter des équations mathématiques** : Tapez <kbd>/inline-math</kbd> pour une équation LaTeX en ligne ou <kbd>/block-math</kbd> pour une équation centrée en bloc. [Activez LaTeX](/fr/editor/configurations) dans les paramètres de votre site au préalable.
* **Ajouter des blocs de prompt** : Tapez <kbd>/prompt</kbd> pour insérer un modèle de prompt IA avec des actions de copie.
* **Modifier des tableaux** : Lorsque votre curseur se trouve à l'intérieur d'un tableau, utilisez la barre d'outils flottante pour ajouter ou supprimer des lignes et des colonnes, ou fusionner des cellules.
* **Insérer des emojis** : Tapez <kbd>:</kbd> suivi d'un mot-clé pour ouvrir le sélecteur d'emojis. Utilisez les touches fléchées pour naviguer dans la grille et appuyez sur <kbd>Enter</kbd> pour insérer l'emoji sélectionné. Le sélecteur recherche parmi les noms d'emojis, les tags et les shortcodes.
* **Insérer des liens** : Sélectionnez du texte et appuyez sur <kbd>Cmd</kbd> + <kbd>K</kbd>, ou faites glisser une page depuis l'arborescence de navigation dans l'éditeur pour créer un lien avec le titre de la page.
* **Lier vers une autre page** : Faites un clic droit sur une page dans l'arborescence de navigation et sélectionnez **Copy link**, puis collez le lien dans votre contenu. L'éditeur reconnaît les liens vers d'autres pages de la même documentation et les convertit automatiquement en liens internes. Les liens collés continuent de fonctionner même si vous déplacez ou renommez ensuite la page cible.

Voir [Composants](/fr/components) pour la liste complète des composants disponibles.

<div id="markdown-mode">
  ### Mode Markdown
</div>

Modifiez le code source MDX.

* **Édition directe en MDX** : Écrivez en syntaxe MDX et Markdown pour un contrôle précis du contenu.
* **Propriétés des composants** : Définissez les propriétés et configurations des composants.
* **Frontmatter** : Modifiez les métadonnées de la page en haut du fichier.

Consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code) pour plus d'informations sur la syntaxe MDX.

<div id="configure-pages">
  ## Configurer les pages
</div>

Configurez les paramètres des pages pour contrôler la façon dont elles apparaissent dans la navigation, les résultats de recherche et la mise en page de votre site.

Survolez une page, puis cliquez sur l'icône d'engrenage. Vous pouvez aussi cliquer avec le bouton droit sur un fichier et sélectionner **Settings**.

<Frame>
  <img src="https://mintcdn.com/adminroletesting-dmytro-mintlify-update-0nfoy34/zqq4GrpqWTAZNPAr/images/editor/page-settings-light.png?fit=max&auto=format&n=zqq4GrpqWTAZNPAr&q=85&s=e000b10aab52a91ccac12843bbeadd6e" alt="Une page mise en évidence dans la barre latérale afin que l'icône d'engrenage des paramètres soit visible." className="block dark:hidden" width="506" height="384" data-path="images/editor/page-settings-light.png" />

  <img src="https://mintcdn.com/adminroletesting-dmytro-mintlify-update-0nfoy34/zqq4GrpqWTAZNPAr/images/editor/page-settings-dark.png?fit=max&auto=format&n=zqq4GrpqWTAZNPAr&q=85&s=18f5284531e4f6b7b5a363afb74e74a3" alt="Une page mise en évidence dans la barre latérale afin que l'icône d'engrenage des paramètres soit visible." className="hidden dark:block" width="508" height="384" data-path="images/editor/page-settings-dark.png" />
</Frame>

<div id="customize-navigation-appearance">
  ### Personnaliser l'apparence de la navigation
</div>

Contrôlez l'apparence de la page dans la barre latérale de navigation de votre site.

* **Titre** : Définissez le titre principal. Apparaît dans la navigation, les onglets du navigateur et les résultats de recherche.
* **Slug** : Définissez le chemin URL de la page. Par défaut, le slug correspond au chemin relatif à la racine de votre référentiel, sans l'extension du fichier. Par exemple, `guides/getting-started.mdx` devient `guides/getting-started`. Modifier le slug renomme et déplace le fichier pour qu'il corresponde au nouveau chemin.
* **Titre de la barre latérale** : Affichez un texte plus court dans la navigation lorsque le titre complet est trop long pour la barre latérale.
* **Icône** : Ajoutez un repère visuel à côté de la page pour aider les utilisateurs à l'identifier rapidement.
* **URL externe** : Créez un lien vers un site externe au lieu d'une page. Utilisez cette option pour ajouter des ressources externes à votre navigation.

<div id="optimize-for-search-and-sharing">
  ### Optimiser pour la recherche et le partage
</div>

Aidez les utilisateurs à trouver votre page et améliorez son apparence lorsqu'elle est partagée.

* **Description**: Rédigez un court résumé. Apparaît dans les résultats de recherche et les balises méta SEO.
* **Keywords**: Ajoutez des termes de recherche pertinents pour aider les utilisateurs à découvrir cette page.
* **OG Image URL**: Définissez une image d'aperçu personnalisée pour les partages sur les réseaux sociaux et les aperçus de liens.

<div id="control-page-layout">
  ### Contrôler la mise en page
</div>

Choisissez comment la page s'affiche en fonction de vos besoins de contenu.

* **Mise en page standard** (`default`) : Page par défaut avec barre latérale de navigation et table des matières.
* **Mise en page pleine largeur** (`wide`) : Masque la table des matières pour permettre des mises en page plus larges pour les tableaux, diagrammes ou d'autres contenus.
* **Mise en page centrée** (`center`) : Masque la barre latérale et la table des matières pour une meilleure lisibilité des pages très textuelles, comme les journaux des modifications.
* **Largeur personnalisée** (`custom`) : Mise en page minimaliste avec uniquement la barre de navigation supérieure. La barre latérale, la table des matières et le pied de page sont masqués. Idéal pour les pages de destination ou d'autres mises en page spécifiques.

<div id="manage-pages">
  ## Gérer les pages
</div>

<div id="move-pages">
  ### Déplacer des pages
</div>

Faites glisser-déposer des pages pour les réorganiser dans votre navigation ou déplacer des fichiers entre dossiers dans l'arborescence des fichiers.

<div id="rename-pages">
  ### Renommer des pages
</div>

Dans l'explorateur de fichiers, faites un clic droit sur un fichier puis cliquez sur **Rename**. L'éditeur conserve automatiquement l'extension du fichier. Il vous suffit de saisir le nom de la page.

<div id="duplicate-pages">
  ### Dupliquer des pages
</div>

Cliquez avec le bouton droit sur une page, puis choisissez **Duplicate**.

<div id="delete-pages">
  ### Supprimer des pages
</div>

Cliquez avec le bouton droit sur une page et sélectionnez **Delete**. La suppression d'une page la retire automatiquement de la navigation.

<div id="hide-pages">
  ### Masquer des pages
</div>

Pour retirer une page de la navigation sans supprimer le fichier, activez l’option **Hidden** dans les paramètres de la page. Une page masquée reste dans votre référentiel, et les utilisateurs peuvent toujours y accéder en se rendant directement à l’URL de la page. Vous pouvez réafficher une page dans les paramètres de la page ou l’ajouter à la navigation de votre `docs.json`.