Nouveau ! Espace de site

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

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

GitBook est désormais réorganisé pour être spécifique à un site. Tout dans l’application est organisé autour des sites de documentation que vous publiez, de sorte que ce que vous voyez en modifiant correspond à ce que vos visiteurs voient en lisant.

Cette page explique ce qui a changé, ce que cela signifie pour votre contenu existant, et comment activer cette option.

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 des 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 se trouve dans un site en tant que section. La hiérarchie que vous modifiez est celle que vos lecteurs obtiennent.

Nouveautés

Tous les sites est votre nouvelle page d’accueil

Quand vous ouvrez GitBook, vous arrivez sur l’écran Tous les sites écran : tous les sites de documentation de votre organisation, au même endroit. Il remplace l’ancien écran d’accueil comme point de départ. 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 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 réside désormais dans 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 l’endroit où elles se trouvent 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 espace objets. Rien ne change pour les intégrations d’API ou 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 non visibles par les visiteurs. Lorsque 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 En ligne et En ligne + brouillons.

Les paramètres de l’organisation, dans leur contexte

Les paramètres de l’organisation n’occupent plus tout l’écran. Ils s’ouvrent dans leur contexte au niveau de l’organisation, à côté de l’écran Tous les sites, 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 a accès par plusieurs voies, c’est l’autorisation la plus permissive qui s’applique. Dans les formules Enterprise, les sections partagées entre plusieurs sites héritent de l’accès le plus large.

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

Que deviennent les 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.

Comment le déploiement fonctionne

L’espace de travail des sites est déployé par phases. Lorsqu’il sera disponible pour votre organisation, vous verrez une option pour activer la nouvelle expérience, ainsi qu’une courte visite intégrée à l’application indiquant ce qui a été déplacé où.