Démarrage rapide : publier un site de documentation avec Docsbook

1. Ouvrez docsbook.io/start.
2. Collez votre source dans le champ unique : l’URL d’un site web, le lien d’un dépôt GitHub ou une phrase sur votre produit. Docsbook détermine de quoi il s’agit — aucun type n’est à sélectionner.
3. Attendez pendant que Docsbook lit la source. Chaque étape indique ce qui a été lu et ce qui a été trouvé.

Résultat attendu : un site brouillon s’ouvre directement dans son panneau d’administration, avec le nombre de pages, la source dont il provient et chaque section consacrée à l’image de marque, à la mise en page et au SEO. Aucun compte n’a encore été créé.

1. Cliquez sur Ouvrir dans le panneau d’administration ou cliquez sur l’aperçu lui-même.
2. Parcourez les pages générées comme un véritable site de documentation — l’en-tête, l’arborescence de la barre latérale, le plan, le fil d’Ariane et les boutons précédent/suivant fonctionnent tous.
3. Utilisez Assistant dans le panneau pour modifier le texte ou poser des questions sur le site. Dans la zone de message, le mode interactif ouvre le site avec la conversation à côté et chaque bloc cliquable.

Résultat attendu : vous avez lu le brouillon et savez s’il décrit correctement votre produit. Un brouillon provenant d’un site web ou d’une idée reste uniquement dans votre navigateur jusqu’à sa publication.

1. Cliquez sur Publier ce site sur la page d’accueil du panneau ou sur le bouton bleu de la barre d’outils de la documentation elle-même. Le bouton indique Publier si vous n’avez encore rien modifié, Enregistrer les modifications si vous avez effectué des changements et Revendiquer la propriété si vous êtes arrivé via un lien de revendication — les trois actions font la même chose.
2. Choisissez une méthode de connexion : GitHub, Google, Apple ou l’e-mail avec un code à usage unique.
3. Terminez le processus de connexion.

Résultat attendu : le brouillon devient un projet Docsbook en ligne avec une adresse publique, un index de recherche et des statistiques. Rien de ce que vous avez écrit n’est recréé.

Si votre site provient d’un dépôt GitHub et que vous vous êtes connecté avec Google, Apple ou votre adresse e-mail, Docsbook vous demande également d’autoriser l’accès à GitHub — il lit les fichiers du dépôt grâce à cette autorisation.

1. Ouvrez l’adresse que Docsbook vous indique. Elle suit le modèle ci-dessous.

docsbook.io/{owner}/{repo}

2. Utilisez la zone de recherche dans l’en-tête ou appuyez sur Cmd+K (Ctrl+K sous Windows et Linux), puis recherchez une expression figurant sur l’une de vos pages.

Résultat attendu : la page se charge à une URL publique, la recherche renvoie votre expression et le site est consultable sans se connecter.