Polices

Personnalisez la typographie de votre site de documentation avec Google Fonts ou des fichiers de polices auto-hébergées pour les titres, le corps du texte et les 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.

​

Google Fonts

Mintlify charge automatiquement Google Fonts lorsque vous indiquez une famille de polices dans votre docs.json.

docs.json

"fonts": {
  "family": "Inter"
}

​

Polices locales

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.

​

Configuration des polices locales

1. 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
   └── ...
   
2. Configurer les polices dans docs.json

   Référencez vos polices locales en utilisant des chemins relatifs depuis la racine de votre projet :

   docs.json

   {
     "fonts": {
       "family": "InterDisplay",
       "source": "/fonts/InterDisplay-Regular.woff2",
       "format": "woff2",
       "weight": 400
     }
   }
   

​

Polices locales pour les titres et le corps de texte

Configurez des polices locales distinctes pour les titres et le corps du texte dans votre docs.json :

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
    }
  }
}

​

Polices hébergées en externe

Utilisez des polices hébergées en externe en indiquant l’URL de la source de la police dans votre docs.json :

docs.json

{
  "fonts": {
    "family": "Hubot Sans",
    "source": "https://mintlify-assets.b-cdn.net/fonts/Hubot-Sans.woff2",
    "format": "woff2",
    "weight": 400
  }
}

​

Référence de configuration des polices

fonts · object

Configuration des polices pour votre documentation.

Afficher Polices

family · string · requis

Nom de la famille de polices, comme « Inter » ou « Playfair Display ».

weight · number

Graisse (épaisseur) de la police, par exemple 400 ou 700. Les polices variables acceptent des valeurs précises comme 550.

source · string (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 sont chargées automatiquement lorsque vous indiquez un nom de family Google, aucune URL de source n’est donc nécessaire.

format · 'woff' | 'woff2'

Format du fichier de police. Requis lors de l’utilisation du champ source.

heading · object

Remplacer les paramètres de police spécifiquement pour les titres.

Afficher Titres

family · string · requis

Nom de la famille de polices pour les titres.

weight · number

Graisse de la police pour les titres.

source · string (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 sont chargées automatiquement lorsque vous indiquez un nom de family Google, aucune URL de source n’est donc nécessaire.

format · 'woff' | 'woff2'

Format du fichier de police pour les titres. Requis lors de l’utilisation du champ source.

body · object

Remplacer les paramètres de police spécifiquement pour le corps du texte.

Afficher Corps du texte

family · string · requis

Nom de la famille de polices pour le corps du texte.

weight · number

Graisse de la police pour le corps du texte.

source · string (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 sont chargées automatiquement lorsque vous indiquez un nom de family Google, aucune URL de source n’est donc nécessaire.

format · 'woff' | 'woff2'

Format du fichier de police pour le corps du texte. Requis lors de l’utilisation du champ source.