mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
3bebd828f6
* docs: sync es/fr/zh translations with recent English updates * docs: tighten translated SEO metadata and fix register consistency --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
75 lines
3.7 KiB
Plaintext
75 lines
3.7 KiB
Plaintext
---
|
||
title: "Déployer sur un sous-chemin avec Vercel"
|
||
sidebarTitle: "Vercel"
|
||
description: "Servez votre site Mintlify sur un sous-chemin de votre domaine principal grâce aux rewrites Vercel, avec un guide pas à pas de la configuration vercel.json."
|
||
keywords: ["vercel.json", "déploiement Vercel", "configuration des rewrites", "routage par sous-chemin"]
|
||
boost: 3
|
||
---
|
||
|
||
import { VercelJsonGenerator } from "/snippets/fr/vercel-json-generator.mdx";
|
||
import SubpathSetupSteps from "/snippets/fr/subpath-setup-steps.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">
|
||
## Le 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.site/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 à [Configuration du domaine personnalisé](https://app.mintlify.com/settings/deployment/custom-domain) dans votre Dashboard.
|
||
2. Activez le bouton **Host at**.
|
||
3. Saisissez votre domaine.
|
||
4. Saisissez `docs` comme chemin de base.
|
||
5. Cliquez sur **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, `app.mintlify.com/your-organization/your-subdomain` possède un identifiant de domaine `your-subdomain`.
|
||
|
||
```json
|
||
{
|
||
"rewrites": [
|
||
{
|
||
"source": "/docs",
|
||
"destination": "https://[subdomain].mintlify.site/docs"
|
||
},
|
||
{
|
||
"source": "/docs/:match*",
|
||
"destination": "https://[subdomain].mintlify.site/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`) :
|
||
|
||
<SubpathSetupSteps />
|
||
|
||
Utilisez ensuite le générateur ci-dessous pour créer votre configuration de réécritures et ajoutez-les à votre fichier `vercel.json`.
|
||
|
||
Mintlify reconstruit votre documentation pour la servir sur votre chemin de base, vos fichiers de documentation n’ont donc pas besoin de se trouver dans un répertoire correspondant à votre sous-chemin.
|
||
|
||
<VercelJsonGenerator /> |