# Configuration d’un sous-répertoire avec Cloudflare

{% stepper %}
{% step %}

### 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.
{% endstep %}

{% step %}

### 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**. 
{% endstep %}

{% step %}

## 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. 
{% endstep %}

{% step %}

### 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 :

{% code lineNumbers="true" %}

```javascript
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));
  }
};
```

{% endcode %}

{% hint style="info" %}
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.
{% endhint %}

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 !
{% endstep %}
{% endstepper %}