Configuration d'un sous-répertoire avec Cloudflare

Hébergez votre documentation avec un sous-répertoire /docs en utilisant Cloudflare

Cette fonctionnalité est disponible sur le Plan du site ultime.

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 le Paramètres onglet. Ouvrez le Domaine et redirections section et sous « Sous-répertoire », cliquez Configurer un sous-répertoire.

Saisissez l’URL où vous souhaitez héberger votre documentation. Puis spécifiez le sous-répertoire pour l’accès à la documentation, par ex. tomatopy.pizza/docs, et cliquez Configurer.

Sous Configuration supplémentaire, vous verrez maintenant 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 rendez-vous sur Workers & Pages

Cliquez sur le Créer bouton.

Sur l'écran « Créer une application », cliquez sur le Hello world bouton dans la carte « Démarrer à partir d'un modèle ».

Donnez au worker un nom plus descriptif, comme mydocs-subpath-proxy. Une fois que vous avez renommé le worker, cliquez Déployer.

3

Configurez votre domaine personnalisé

Votre worker disposera d'une URL par défaut que vous pouvez utiliser. Pour configurer plutôt votre domaine personnalisé (par exemple tomatopy.pizza), cliquez Paramètres. Ensuite, dans la section « Domaines & Routes », cliquez + Ajouter.

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

4

Mettre à jour le code du worker

Lorsque le worker a fini de se déployer, cliquez Modifier le code, ou cliquez Continuer vers le projet, puis le Modifier le code bouton en haut à droite.

Dans l'éditeur de code qui s'ouvre, remplacez le code d'exemple 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));
  }
};

Veillez à mettre à jour l'URL à la ligne 5 avec l'URL du proxy que vous avez obtenue depuis GitBook à la première étape.

Une fois cela fait, cliquez Déployer. Ce processus peut prendre quelques instants. Une fois terminé, en visitant l'URL, vous devriez voir votre site de documentation !