Configuration d’un sous-répertoire avec Vercel

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

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 Gérer le site , puis Domaine et redirections. 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 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

Mettre à jour votre 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": "<INSÉREZ L’URL DE VOTRE PROXY DEPUIS GITBOOK>"
        },
        {
            "source": "/docs/:match*",
            "destination": "<INSÉREZ L’URL DE VOTRE PROXY DEPUIS GITBOOK>/:match*"
        }
    ]
}

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.

3

Redéployez votre application et essayez-la !

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