Passer au contenu principal
Configurez l’image de marque, l’apparence et les fonctionnalités de votre site de documentation à partir du panneau Configurations de l’éditeur web.
Paramètres de Configurations dans la barre latérale en mode clair.

​
Personnalisez l’identité de votre site

Définissez l’identité de votre site et la façon dont il se présente aux visiteurs.
  • Titre de la documentation : Le nom de votre documentation. Apparaît dans les onglets du navigateur et les résultats de recherche.
  • Description : Brève synthèse de votre documentation. Utilisée pour le SEO et les metadata du site.
  • Favicon : Petite icône qui apparaît dans les onglets du navigateur. Téléversez des fichiers ICO, PNG, GIF ou JPG.
  • Thème : Choisissez un thème pour l’apparence générale de votre documentation.

​
Personnaliser les couleurs et l’apparence

Contrôlez l’identité visuelle et la palette de couleurs de votre site.
  • Couleur principale : La couleur d’accent principale utilisée sur l’ensemble de votre site pour les liens, les boutons et les éléments mis en évidence.
  • Couleur en mode clair : Variation de la couleur d’accent pour le mode clair. Son application peut varier selon le thème.
  • Couleur en mode sombre : Variation de la couleur d’accent pour le mode sombre. Son application peut varier selon le thème.
  • Logo : Le logo de votre marque. Téléversez des fichiers SVG, PNG ou JPG. Vous pouvez définir des logos différents pour les modes clair et sombre.
  • Lien du logo : Page vers laquelle les utilisateurs sont redirigés lorsqu’ils cliquent sur votre logo. En général, votre page d’accueil ou votre site marketing.
  • Couleurs d’arrière-plan : Définissez des couleurs d’arrière-plan personnalisées séparément pour les modes clair et sombre.
  • Image d’arrière-plan : Ajoutez une image d’arrière-plan à votre site. Téléversez des fichiers PNG, GIF ou JPG.
  • Décoration d’arrière-plan : Appliquez des styles visuels à votre image d’arrière-plan.
  • Bascule de thème : Affichez ou masquez le sélecteur de mode clair/sombre pour les utilisateurs.
  • Thème par défaut : Définissez si votre site se charge par défaut en mode clair ou en mode sombre.

​
Configurer des polices personnalisées

Remplacez les polices par défaut par la typographie de votre marque.
  • Police par défaut : Famille et graisse de police de base pour tout le texte. Indiquez une URL source et un format (WOFF ou WOFF2).
  • Police des titres : Famille et graisse de police spécifiquement pour les titres (h1, h2, etc.). À configurer séparément du texte principal.
  • Police du texte principal : Famille et graisse de police pour le corps du texte et les paragraphes.
Pour chaque police, indiquez le nom de la famille, la graisse, l’URL source (comme Google Fonts) et le format.

​
Configurer l’en-tête

Ajoutez des éléments de navigation en haut de votre site.
  • Bouton de la barre de navigation : Ajoutez un bouton d’appel à l’action principal dans l’en-tête. Configurez le type de bouton, son label et l’URL de destination.
  • Liens de la barre de navigation : Ajoutez des liens de navigation supplémentaires dans l’en-tête. Chaque lien comporte un texte et une URL.
Ajoutez des liens et des comptes de réseaux sociaux au pied de page de votre site.
  • Liens vers les réseaux sociaux : Ajoutez vos profils sur des plateformes comme GitHub, X (Twitter), LinkedIn, Discord, YouTube, Slack et bien plus encore.
  • Colonnes de pied de page : Organisez les liens du pied de page en colonnes avec des titres personnalisés et des groupes de liens.

​
Améliorer le contenu

Personnalisez la façon dont le contenu apparaît sur votre site.
  • Arrière-plan de vignette : Définissez une image d’arrière-plan personnalisée pour les vignettes de page et les aperçus sur les réseaux sociaux.
  • Apparence des vignettes : Contrôlez la façon dont les vignettes s’affichent.
  • Police des vignettes : Définissez une police personnalisée pour le texte des vignettes.
  • Surtitre de page : Ajoutez de petits labels au-dessus des titres de page.
  • Thème des blocs de code : Choisissez le thème de coloration syntaxique pour les blocs de code.
  • Prise en charge de LaTeX : Activez le rendu des notations mathématiques avec LaTeX.
Personnalisez l’expérience de recherche.
  • Texte d’indication de recherche : Le texte qui apparaît dans le champ de recherche avant que les utilisateurs ne saisissent quoi que ce soit. La valeur par défaut est « Search or ask… ».

​
Ajouter des Analytics et des intégrations

Connectez des outils d’Analytics et des services tiers à votre documentation. Suivez le comportement des visiteurs avec :
  • Amplitude, Mixpanel, Heap : plateformes d’analytics produit
  • Google Analytics, Google Tag Manager : analytics web
  • PostHog, Plausible, Fathom : analytics axés sur la confidentialité
  • Segment, Hightouch : plateformes de données clients
  • Hotjar, LogRocket : relecture de sessions et cartes de chaleur
  • Microsoft Clarity : analytics de comportement utilisateur
  • Intercom : messagerie client
  • Clearbit, Koala : identification des visiteurs
Intégrations supplémentaires :
  • Telemetry : activer ou désactiver la télémétrie d’utilisation
  • Cookies : définir des paires clé/valeur de cookies personnalisées

​
Configurer la documentation d’API

Mettez en place des références d’API interactives.
  • Spécifications OpenAPI : Référencez vos fichiers de spécification OpenAPI.
  • Spécifications AsyncAPI : Référencez vos fichiers de spécification AsyncAPI pour les API asynchrones.
  • Affichage du bac à sable : Contrôlez l’apparence du bac à sable d’API.
  • Serveur proxy : Configurez un serveur proxy pour les requêtes d’API effectuées depuis le bac à sable.