Configurer un sous-répertoire avec Vercel

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

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 Gérer le site, puis Domaine et redirections. Sous « Sous-répertoire », cliquez sur Configurer un sous-répertoire.

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

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

2

Mettez à jour votre fichier vercel.json

Dans votre application Vercel, ouvrez votre vercel.jsonfichier (ou créez-en un dans le répertoire racine si vous n’en avez pas déjà un). Ensuite, ajoutez ce qui suit :

{
    "rewrites": [
        {
            "source": "/docs",
            "destination": "<INSERT YOUR PROXY URL FROM GITBOOK>"
        },
        {
            "source": "/docs/:match*",
            "destination": "<INSERT YOUR PROXY URL FROM GITBOOK>/:match*"
        }
    ]
}

Veillez à mettre à jour l’URL à la ligne 5 avec l’URL proxy obtenue depuis GitBook à la première étape.

3

Redéployez votre application et essayez-la !

Redéployez votre application Vercel avec la configuration mise à jour. Cela peut prendre quelques instants. À présent, lorsque vous visiterez l’URL, vous devriez voir votre site de documentation !