Configuration d’un sous-répertoire avec Cloudflare

Hébergez votre documentation avec un sous-répertoire /docs à l’aide de Cloudflare

Cette fonctionnalité est disponible sur le Forfait de site Ultimate.

1

Configuration de votre site GitBook

Dans votre organisation GitBook, cliquez sur le nom de votre site de documentation dans la barre latérale, puis cliquez Gérer le site ou ouvrez l’onglet Paramètres . Ouvrez la section Domaine et redirections et, sous « Sous-répertoire », cliquez sur Configurer un sous-répertoire.

Entrez l’URL où vous souhaitez héberger votre documentation. Indiquez ensuite le sous-répertoire pour l’accès à la documentation, par ex. tomatopy.pizza/docs , puis cliquez sur Configurer.

Sous Configuration supplémentaire, vous verrez désormais une URL de proxy. Vous l’utiliserez à l’étape suivante lors de la configuration de votre worker Cloudflare. Copiez-la dans votre presse-papiers.

2

Créez votre worker Cloudflare

Connectez-vous à votre compte Cloudflare et accédez à Workers & Pages

Cliquez sur le Créer des .

Sur l’écran « Créer une application », cliquez sur le bouton Hello world dans la carte « Partir d’un modèle ».

Donnez au worker un nom plus descriptif, comme mydocs-subpath-proxy. Une fois le renommage du worker terminé, cliquez sur Déployez.

3

Configurez votre domaine personnalisé

Votre worker obtiendra une URL par défaut que vous pouvez utiliser. Pour configurer à la place votre domaine personnalisé (par exemple tomatopy.pizza), cliquez sur Paramètres. Ensuite, dans la section « Domaines et routes », cliquez sur + Ajouter.

Dans le panneau « Domaines et routes » qui s’ouvre, cliquez sur Domaine personnalisé, puis saisissez votre domaine personnalisé dans la zone de texte qui suit. Lorsque vous spécifiez le domaine personnalisé, n’incluez pas le sous-répertoire. Par exemple, tomatopy.pizza est correct, tandis que tomatopy.pizza/docs ne l’est pas.

4

Mettez à jour le code du worker

Lorsque le déploiement du worker est terminé, cliquez sur Modifier le code, ou cliquez sur Continuer vers le projet, puis sur le bouton Modifier le code en haut à droite.

Dans l’éditeur de code qui s’ouvre, remplacez l’exemple de code par l’extrait suivant :

export default {
  fetch(request) { 
    const SUBDIRECTORY = '/docs';
    const url = new URL(request.url);
    const target = "<INSERT YOUR PROXY URL FROM GITBOOK>" + url.pathname.slice(SUBDIRECTORY.length);
    const proxy = new URL(
      target.endsWith('/') ? target.slice(0, -1) : target 
    )
    proxy.search = url.search;
    return fetch(new Request(proxy, request));
  }
};

Assurez-vous de mettre à jour l’URL à la ligne 5 avec l’URL de proxy que vous avez obtenue de GitBook à la première étape.

Une fois cela fait, cliquez sur Déployez. Ce processus peut prendre quelques instants. Une fois terminé, lorsque vous visiterez l’URL, vous devriez voir votre site de documentation !