Polices
Personnalisez la typographie de votre documentation avec Google Fonts ou des polices auto-hébergées pour titres, corps de texte et blocs de code.
Définissez une police personnalisée pour l’ensemble de votre site, ou séparément pour les titres et le corps du texte. Utilisez Google Fonts, des fichiers de polices locaux ou des polices hébergées à l’externe. La police par défaut varie selon le thème.
Configurez les polices avec la propriété fonts dans votre docs.json.
Mintlify charge automatiquement Google Fonts lorsque vous indiquez une famille de polices dans votre docs.json.
"fonts": {
"family": "Inter"
}Pour utiliser des polices locales, placez vos fichiers de police dans le répertoire de votre projet et faites-y référence dans votre configuration docs.json.
Ajouter les fichiers de police à votre projet
Par exemple, créez un répertoire fonts et ajoutez-y vos fichiers de police :
your-project/
├── fonts/
│ ├── InterDisplay-Regular.woff2
│ └── InterDisplay-Bold.woff2
├── docs.json
└── ...Configurer les polices dans docs.json
Référencez vos polices locales en utilisant des chemins relatifs depuis la racine de votre projet :
{
"fonts": {
"family": "InterDisplay",
"source": "/fonts/InterDisplay-Regular.woff2",
"format": "woff2",
"weight": 400
}
}Configurez des polices locales distinctes pour les titres et le corps du texte dans votre docs.json :
{
"fonts": {
"heading": {
"family": "InterDisplay",
"source": "/fonts/InterDisplay-Bold.woff2",
"format": "woff2",
"weight": 700
},
"body": {
"family": "InterDisplay",
"source": "/fonts/InterDisplay-Regular.woff2",
"format": "woff2",
"weight": 400
}
}
}Utilisez des polices hébergées en externe en indiquant l’URL de la source de la police dans votre docs.json :
{
"fonts": {
"family": "Hubot Sans",
"source": "https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2",
"format": "woff2",
"weight": 400
}
}fontsobjectConfiguration des polices pour votre documentation.
Show Hide Polices
familystringrequiredNom de la famille de polices, comme « Inter » ou « Playfair Display ».
weightnumberGraisse (épaisseur) de la police, par exemple 400 ou 700. Les polices variables acceptent des valeurs précises comme 550.
sourcestring (uri)URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2, ou chemin vers votre fichier de police local, par exemple /assets/fonts/InterDisplay.woff2. Les polices Google se chargent automatiquement lorsque vous indiquez un nom de family Google, vous n’avez donc pas besoin d’URL de source.
format'woff' | 'woff2'Format du fichier de police. Requis lors de l’utilisation du champ source.
headingobjectRemplacer les paramètres de police spécifiquement pour les titres.
Show Hide Titres
familystringrequiredNom de la famille de polices pour les titres.
weightnumberGraisse de la police pour les titres.
sourcestring (uri)URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2, ou chemin vers votre fichier de police local pour les titres. Les polices Google se chargent automatiquement lorsque vous indiquez un nom de family Google, vous n’avez donc pas besoin d’URL de source.
format'woff' | 'woff2'Format du fichier de police pour les titres. Requis lors de l’utilisation du champ source.
bodyobjectRemplacer les paramètres de police spécifiquement pour le corps du texte.
Show Hide Corps du texte
familystringrequiredNom de la famille de polices pour le corps du texte.
weightnumberGraisse de la police pour le corps du texte.
sourcestring (uri)URL de la source de votre police, par exemple https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2, ou chemin vers votre fichier de police local pour le corps du texte. Les polices Google se chargent automatiquement lorsque vous indiquez un nom de family Google, vous n’avez donc pas besoin d’URL de source.
format'woff' | 'woff2'Format du fichier de police pour le corps du texte. Requis lors de l’utilisation du champ source.