> For the complete documentation index, see [llms.txt](https://smedai.aivd.ch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://smedai.aivd.ch/applications/gitbook/creer/structure-du-contenu/pages.md).
# Pages
Une **page** est l’unité de contenu que vous éditez. Les pages vivent toujours dans un [espace](/applications/gitbook/creer/structure-du-contenu/espaces.md).
### Table des matières
Dans un espace, les pages s’affichent dans la **table des matières** (barre latérale). Vous y verrez :
* des **pages**
* des **sous-pages** (pages imbriquées)
* des **groupes** (sections de navigation)
* parfois des **liens** (internes ou externes)
{% hint style="info" %}
La structure de navigation du **site publié** est gérée par l’équipe SIC. Vous, vous travaillez surtout sur le contenu et son organisation dans l’espace.
{% endhint %}
### Créer une nouvelle page
Le plus courant est de créer une page dans une **demande de changement**.
1. Ouvrez l’espace.
2. Sélectionnez **Modifier**. Vous passez dans une demande de changement.
3. Dans la table des matières, sélectionnez **Ajouter…** → **Page**.
4. Donnez un titre, puis écrivez votre contenu.
Une page vide dans GitBook. Vous pouvez la voir répertoriée dans la table des matières sur le côté gauche.
### Vous ne voyez pas le bouton « Ajouter… » ?
{% hint style="warning" %}
Vérifiez ces points :
* Vous êtes bien dans une demande de changement (bouton **Modifier**).
* Vous avez les permissions d’édition sur l’espace.
Si besoin, demandez l’accès à l’équipe SIC.
{% endhint %}
### Organisation de votre contenu
Vous organisez votre contenu via la table des matières.
#### Pages
Faites glisser une page sous une autre pour créer une **sous-page**.
{% hint style="info" %}
Évitez plus de **3 niveaux** de profondeur. La navigation devient vite illisible.
{% endhint %}
### Renommer une page
Renommer une page change son **titre** dans la navigation. Selon la configuration, cela peut aussi changer son « slug » (fin de l’URL).
{% hint style="warning" %}
Si des personnes partagent des liens externes vers une page, évitez de renommer “à répétition”. En cas de doute, demandez à l’équipe SIC.
{% endhint %}
#### Groupes de pages
Avec les groupes de pages, vous pouvez regrouper des pages en sections qui couvrent du contenu connexe.
Vous pouvez créer un nouveau groupe de pages en cliquant sur **Ajouter un nouveau...** > **Groupe** en bas de votre table des matières.
Les groupes de pages ne peuvent exister qu'au **niveau supérieur** de la table des matières. Vous ne pouvez pas imbriquer des groupes de pages à l'intérieur d'autres groupes.
#### Liens externes
Vous pouvez aussi ajouter des liens à votre table des matières. En cliquant dessus, les utilisateurs seront dirigés directement vers le contenu lié.
Créez un nouveau lien externe en cliquant sur **Ajouter un nouveau...** > **Lien externe** en bas de votre table des matières.
### Icônes et emojis de page
Pour améliorer la visibilité pour les lecteurs lorsqu'ils parcourent rapidement votre table des matières, vous pouvez ajouter une icône ou un emoji optionnel aux pages individuelles. L'icône ou l'emoji apparaîtra dans la table des matières et à côté du titre en haut de la page.
Pour ajouter une icône ou un emoji, cliquez sur le **Ajouter une icône** bouton en survolant le titre de la page, ou le bouton emoji à gauche du titre.
### Options utiles sur une page
Selon vos permissions, vous pouvez aussi :
* dupliquer ou supprimer une page
* masquer une page de la navigation (utile pour le site publié)
* ajuster la largeur de page
{% hint style="info" %}
Si vous ne voyez pas certaines options, c’est normal. Elles dépendent du rôle et des permissions sur l’espace.
{% endhint %}
### Couvertures de page
Vous pouvez également définir une couverture de page pour chaque page de votre documentation. Lorsque vous cliquez sur l' **Couverture de la page**  option, une couverture par défaut sera ajoutée immédiatement. À partir de là, vous pouvez :
* **Changer l'image de couverture**
Survolez la couverture de la page et cliquez sur **Changer la couverture**, puis sélectionnez ou téléversez une image. En fonction de la manière dont nous affichons actuellement les couvertures de page, 1990x480 pixels est la taille idéale.
* **Repositionner l'image de couverture**
Survolez la couverture de la page et ouvrez le **menu Actions** . Cliquez sur **Repositionner**, puis faites glisser l'image comme vous le souhaitez et cliquez sur **Enregistrer**.
* **Supprimer l'image de couverture**\
Survolez la couverture de la page et ouvrez le **menu Actions** , puis cliquez sur **Supprimer**.
* **Largeur complète et largeur héros**\
Vous pouvez changer le style de la couverture de votre page pour qu'elle s'étende sur toute la largeur de votre écran ou seulement sur la largeur de votre contenu. Survolez la couverture de la page et ouvrez le **menu Actions** , puis choisissez votre option préférée dans le menu.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://smedai.aivd.ch/applications/gitbook/creer/structure-du-contenu/pages.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
.png?alt=media)