mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
086a2640e8
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
71 lines
4.0 KiB
Plaintext
71 lines
4.0 KiB
Plaintext
---
|
||
title: "Vercel"
|
||
description: "Déployer la documentation dans un sous-chemin sur Vercel."
|
||
keywords: ["vercel.json", "déploiement Vercel", "configuration des rewrites", "routage par sous-chemin"]
|
||
---
|
||
|
||
import { VercelJsonGenerator } from "/snippets/fr/vercel-json-generator.mdx";
|
||
|
||
Configurez votre fichier `vercel.json` pour acheminer les requêtes de votre domaine principal vers votre documentation sur un sous-chemin.
|
||
|
||
|
||
<div id="verceljson-file">
|
||
## Fichier vercel.json
|
||
</div>
|
||
|
||
Le fichier `vercel.json` définit la façon dont votre projet est construit et déployé. Il se trouve à la racine de votre projet et contrôle divers aspects de votre déploiement, notamment le routage, les redirections, les en-têtes et les paramètres de build.
|
||
|
||
Nous utilisons la configuration `rewrites` dans votre fichier `vercel.json` pour faire transiter les requêtes de votre domaine principal vers votre documentation via un proxy.
|
||
|
||
Les réécritures (`rewrites`) font correspondre les requêtes entrantes à différentes destinations sans modifier l'URL dans le navigateur. Quand quelqu’un visite `yoursite.com/docs`, Vercel récupère en interne le contenu depuis `your-subdomain.mintlify.dev/docs`, mais l’utilisateur voit toujours `yoursite.com/docs` dans son navigateur. Cela diffère des redirections, qui envoient les utilisateurs vers une URL complètement différente.
|
||
|
||
<div id="configuration">
|
||
## Configuration
|
||
</div>
|
||
|
||
<div id="host-at-docs-subpath">
|
||
### Héberger sur le sous-chemin `/docs`
|
||
</div>
|
||
|
||
1. Accédez à la page [Custom domain setup](https://dashboard.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
|
||
2. Cliquez sur l’interrupteur **Host at `/docs`** pour l’activer.
|
||
<Frame>
|
||
<img alt="Capture d’écran de la page Custom domain setup. L’interrupteur Host at `/docs` est activé et mis en évidence par un rectangle orange." src="/images/subpath/toggle-light.png" className="block dark:hidden" />
|
||
<img alt="Capture d’écran de la page Custom domain setup. L’interrupteur Host at `/docs` est activé et mis en évidence par un rectangle orange." src="/images/subpath/toggle-dark.png" className="hidden dark:block" />
|
||
</Frame>
|
||
3. Saisissez votre domaine.
|
||
4. Sélectionnez **Add domain**.
|
||
5. Ajoutez les réécritures suivantes à votre fichier `vercel.json`. Remplacez `[subdomain]` par votre sous-domaine, que vous trouverez à la fin de l’URL de votre Dashboard. Par exemple, `dashboard.mintlify.com/your-organization/your-subdomain` possède un identifiant de domaine `your-subdomain`.
|
||
|
||
```json
|
||
{
|
||
"rewrites": [
|
||
{
|
||
"source": "/docs",
|
||
"destination": "https://[subdomain].mintlify.dev/docs"
|
||
},
|
||
{
|
||
"source": "/docs/:match*",
|
||
"destination": "https://[subdomain].mintlify.dev/docs/:match*"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
La configuration `rewrites` fait correspondre le sous-chemin `/docs` sur votre domaine au sous-chemin `/docs` sur votre documentation.
|
||
|
||
- **`source`** : Le modèle de chemin sur votre domaine qui déclenche la réécriture.
|
||
- **`destination`** : L’endroit où la requête doit être transmise en proxy.
|
||
- **`:match*`** : Un joker qui capture tous les segments de chemin après votre sous-chemin.
|
||
|
||
Pour plus d’informations, consultez [Configuring projects with vercel.json: Rewrites](https://vercel.com/docs/projects/project-configuration#rewrites) dans la documentation Vercel.
|
||
|
||
<div id="host-at-custom-subpath">
|
||
### Héberger sur un sous-chemin personnalisé
|
||
</div>
|
||
|
||
Pour utiliser un sous-chemin personnalisé (tout chemin autre que `/docs`), vous devez organiser vos fichiers de documentation dans votre référentiel pour qu'ils correspondent à la structure de votre sous-chemin. Par exemple, si votre documentation est hébergée à l'adresse `yoursite.com/help`, vos fichiers de documentation doivent se trouver dans un répertoire `help/`.
|
||
|
||
Utilisez le générateur ci-dessous pour créer votre configuration de réécritures. Ajoutez les réécritures à votre fichier `vercel.json`.
|
||
|
||
<VercelJsonGenerator /> |