Sections du site

Ajoutez plusieurs produits à votre site en tant que sections et créez un hub de contenu avec des onglets pour accéder à tout votre contenu

Exemple d’un site GitBook avec des sections du site

Avec les sections du site, vous pouvez centraliser toute votre documentation et créer une expérience fluide pour vos utilisateurs.

Les sections du site sont parfaites pour organiser votre documentation — que vous gériez des produits distincts ou que vous vous adressiez à la fois aux utilisateurs finaux et aux développeurs avec du contenu adapté à chacun.

Vous pouvez aussi regrouper les sections du site. Cela créera un menu déroulant dans votre barre de navigation — idéal pour ajouter une hiérarchie à vos sections du site.

Sections ou variantes ?

Chaque section du site est un espace dans GitBook. Vous pouvez créer des sections du site à partir de n’importe quel espace, mais nous vous recommandons d’utiliser les sections comme des parties sémantiquement différentes de votre documentation.

Si vous souhaitez ajouter des variations du même contenu — telles que des localisations ou des versions historiques d’un même produit — envisagez d’utiliser des variantes de contenu à la place.

Ajouter une section à votre site de documentation

Depuis le tableau de bord de votre site de documentation, ouvrez le Paramètres onglet dans l'en-tête du site, puis cliquez sur Structure. Ici vous pouvez voir tout le contenu de votre site.

Pour ajouter une section du site, cliquez sur le Nouvelle section bouton sous le tableau et choisissez un espace à lier en tant que section. La nouvelle section est alors ajoutée au tableau et sera disponible pour les visiteurs en tant qu'onglet en haut de votre site.

Ajoutez de la structure à votre documentation avec des sections du site.

Créer un groupe de sections du site

Vous pouvez regrouper des sections du site sous un seul intitulé. Les groupes de sections du site apparaîtront comme un menu déroulant dans la navigation de votre site. Les sections d’un groupe peuvent également inclure une description optionnelle, qui s’affiche sous le titre de la section dans le menu déroulant.

Pour créer un groupe, cliquez sur la flèche à côté du Nouvelle section bouton et choisissez Nouveau groupe de sections. Donnez un nom à votre nouveau groupe, puis cliquez Ajouter une section dans la fenêtre modale pour ajouter des sections à votre groupe. Vous pouvez ajouter des sections existantes de votre site au nouveau groupe, ou sélectionner un autre espace que vous souhaitez ajouter à l’aide du menu.

Modifier une section

Vous pouvez changer le nom, l’icône et le slug de chacune de vos sections en appuyant sur le Modifier bouton dans la ligne du tableau de la section que vous souhaitez modifier. Cela ouvrira une fenêtre modale. Modifiez le(s) champ(s) que vous souhaitez changer, puis cliquez sur le Enregistrer bouton. Vous pouvez également supprimer la variante en cliquant sur le Supprimer la variante bouton en bas à gauche.

Modifier le slug d’une section changera son URL canonique. GitBook créera une redirection automatique de l’ancienne URL vers la nouvelle. Vous pouvez aussi créer des redirections manuellement.

Les sections du site au sein d’un groupe peuvent également afficher facultativement une description, qui apparaîtra dans le menu déroulant de la barre de navigation de votre site lorsque le groupe de sections est survolé. Voyez l’image en haut de cette page pour voir un exemple de l’apparence dans votre documentation publiée.

Réordonner les sections

Votre site affiche les sections dans l’ordre où elles apparaissent dans votre tableau Structure du site. Les sections peuvent être réordonnées en saisissant le Poignée de déplacement et en le déplaçant vers le haut ou vers le bas. Tous les espaces contenus dans cette section seront déplacés avec elle. L’ordre modifié sera reflété immédiatement sur votre site.

Vous pouvez également utiliser le clavier pour sélectionner et déplacer le contenu : sélectionnez une section avec la barre d’espace, puis utilisez les touches fléchées pour la déplacer vers le haut ou vers le bas. Appuyez de nouveau sur la barre d’espace pour confirmer la nouvelle position.

Définir une section par défaut

Si vous avez plusieurs sections sur votre site, une section sera marquée comme section par défaut. Cette section est affichée lorsque les visiteurs arrivent sur votre site, et elle est servie depuis l’URL racine de votre site. Les autres sections ont chacune un slug qui est ajouté à l’URL racine.

Pour définir une section comme par défaut, cliquez sur le menu Actions dans la ligne du tableau de la section, puis cliquez Définir par défaut.

Supprimer une section

Pour supprimer une section d’un site, cliquez sur le Paramètres bouton depuis le tableau de bord de votre site de documentation, puis cliquez Structure pour trouver le contenu que vous souhaitez supprimer. Cliquez sur le Modifier bouton à côté de la section que vous souhaitez supprimer, puis cliquez sur le Supprimer bouton en bas à gauche de la fenêtre modale. Cela supprimera la section, ainsi que toutes les variantes qu’elle contient, du site publié. Cela ne supprimera pas les espaces eux-mêmes, ni le contenu qu’ils contiennent.

Pour supprimer une section d’un site, ouvrez le Paramètres depuis le tableau de bord de votre site de documentation, puis cliquez sur Structure pour trouver le contenu que vous souhaitez supprimer.

Ouvrez le menu Actions pour l'espace que vous souhaitez supprimer et choisissez Supprimer.

La suppression d’une section de votre site la supprimera — ainsi que toutes les variantes qu’elle contient — du site publié, mais ne supprimera aucun des espaces ni le contenu qu’ils contiennent.