Espace de travail du site

Découvrez comment l’espace de travail du site modifie la navigation, la structure du contenu et les autorisations dans GitBook

L’espace de travail centré sur les sites dans GitBook

GitBook est désormais organisé autour de vos sites de documentation. Tout dans l’application est structuré autour des sites que vous publiez, de sorte que ce que vous voyez pendant l’édition correspond à ce que vos visiteurs voient lorsqu’ils lisent.

Cette page explique l’espace de travail et ce que cela signifie pour votre contenu existant.

Pourquoi l’espace de travail des sites

Auparavant, GitBook organisait votre travail autour des espaces et des collections, et les sites étaient construits par-dessus en reliant les espaces entre eux. Cela signifiait que la structure que vous parcouriez dans l’application ne correspondait jamais tout à fait à la structure de votre site publié.

L’espace de travail des sites comble cet écart. Votre organisation contient des sites, et chaque contenu vit dans un site sous forme de section. La hiérarchie que vous modifiez est celle que vos lecteurs obtiennent.

Nouveautés

L’accueil affiche tous vos sites

Lorsque vous ouvrez GitBook, vous arrivez sur votre organisation Accueil: vos sites de documentation, vos changements récents et les outils à l’échelle de l’organisation, au même endroit. Pour y revenir depuis n’importe où, utilisez le sélecteur en haut de la barre latérale.

La barre latérale affiche votre site, pas votre organisation

L’ouverture d’un site remplace la barre latérale par l’arborescence du contenu de ce site, la même structure que celle que voient les visiteurs sur votre site publié. Accédez directement à n’importe quelle section et commencez à modifier sans changer de contexte.

L’arborescence du contenu dans la barre latérale est en lecture seule. Pour réorganiser votre site, ouvrez l’éditeur de structure, un écran dédié qui remplace l’ancien onglet Structure dans les paramètres du site. Les modifications que vous y apportez se reflètent immédiatement dans la barre latérale.

Les sections remplacent les espaces

Le contenu d’un site vit désormais dans des sections. Si vous avez déjà utilisé GitBook, une section correspond à ce que vous connaissiez comme un espace lié à un site. Les sections fonctionnent de la même manière dans l’éditeur. Ce qui change, c’est leur emplacement et la façon dont elles héritent des paramètres de leur site.

Dans l’API GitBook, les sections sont toujours représentées comme des espaces objets. Rien ne change pour les intégrations API ni pour Git Sync.

Les outils du site, à un clic

Insights, Analytics, Personnalisation et Paramètres du site sont désormais des éléments de la barre latérale du site et s’ouvrent dans la vue principale. Vous n’avez plus besoin de fouiller dans des paramètres imbriqués pour les trouver. Les écrans eux-mêmes fonctionnent exactement comme avant.

Sections en brouillon

Les nouvelles sections commencent comme brouillons: liées à votre site, modifiables par votre équipe, mais invisibles pour les visiteurs. Quand vous êtes prêt, publiez un brouillon individuellement, ou publiez-en plusieurs à la fois depuis l’éditeur de structure.

Pour voir à quoi ressembleront les brouillons sur votre site, basculez l’aperçu du site entre Publié et Publié + brouillons.

Paramètres de l’organisation, dans leur contexte

Les paramètres de l’organisation ne prennent plus le contrôle de tout l’écran. Ils s’ouvrent dans leur contexte au niveau de l’organisation, à côté de l’accueil de votre organisation, afin que vous puissiez ajuster les options à l’échelle de l’organisation sans perdre votre place.

Autorisations héritées du site

Les sections peuvent hériter des autorisations de leur site plutôt que des collections. Lorsqu’un membre dispose d’un accès par plusieurs chemins, l’autorisation la plus permissive s’applique. Dans les offres Enterprise, les sections partagées entre plusieurs sites héritent de l’accès le plus large.

Cette option est activée espace par espace. Le contenu que vous n’activez pas conserve les autorisations existantes basées sur les collections.

Ce qu’il advient des espaces et collections existants

Rien n’est supprimé ni retiré de la publication.

• Les espaces déjà liés à un site deviennent des sections de ce site.
• Les espaces non liés à un site apparaissent dans une nouvelle Tout le contenu section, à côté de vos sites, dans la vue arborescente familière. Les collections y sont conservées sous forme de dossiers.
• Si chaque espace de votre organisation appartient à un site, la section Tout le contenu n’apparaît pas du tout.