Configurer un sous-répertoire avec Vercel

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

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

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

Sous Configuration supplémentaire, vous verrez maintenant une URL de 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 vercel.json

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

{
    "rewrites": [
        {
            "source": "/docs",
            "destination": "<INSÉREZ L'URL DE VOTRE PROXY DEPUIS GITBOOK>"
        },
        {
            "source": "/docs/:match*",
            "destination": "<INSÉREZ L'URL DE VOTRE PROXY DEPUIS GITBOOK>/:match*"
        }
    ]
}

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

3

Redéployez votre application et essayez !

Redéployez votre application Vercel avec la configuration mise à jour. Cela peut prendre quelques instants. Désormais, en visitant l’URL, vous devriez voir votre site de documentation !