Polices

Configurer des polices personnalisées

Définissez une police personnalisée pour l’ensemble de votre site ou distinctement pour les titres et le corps de texte. Utilisez Google Fonts, des fichiers de polices locaux ou des polices hébergées en externe. La police par défaut varie selon le thème.

Les polices sont gérées via 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 · required

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 · required

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 · required

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.