Aller au contenu principal
FONCTIONNALITÉ 07 / 11

Des thèmes pour votre doc d’API, sans étape de build.

Les 35 thèmes daisyUI standard sont dans le CSS livré — en offrir un à vos lecteurs coûte une ligne de config. Votre thème de marque tient en une poignée de tokens dans la même config, généré au démarrage : pas de pipeline CSS, pas de rebuild, pas de fork.

demo.apiglow.dev/#/overview · petstore.yaml
Le sélecteur de thème ouvert sur la documentation : Daisybrand actif, puis Light, Dark, Abyss, Acid et d’autres, chacun avec ses pastilles de couleurs. Le sélecteur de thème ouvert sur la documentation : Daisybrand actif, puis Light, Dark, Abyss, Acid et d’autres, chacun avec ses pastilles de couleurs.

CAPTURE RÉELLE, AFFICHÉE À 1:1

35 thèmes, une liste.

theme.default choisit le thème du premier chargement, theme.available ceux offerts dans le sélecteur — la liste s’édite, rien à recompiler. Le choix du lecteur persiste dans son navigateur et prime ensuite.
Le menu des thèmes, chaque entrée prévisualisée par ses trois couleurs. Le menu des thèmes, chaque entrée prévisualisée par ses trois couleurs.
[01]LE MENU DES THÈMES, 35 ENTRÉES

Votre thème de marque, collé tel quel.

theme.custom déclare vos propres thèmes : un name, un extends optionnel vers n’importe quel thème intégré — « dark, mais à nos couleurs » — et des tokens daisyUI 5 sous leurs noms exacts, si bien que la sortie du générateur de thèmes daisyUI se colle telle quelle. Un token inconnu ou une valeur invalide est ignoré avec un avertissement en console ; un thème cassé ne casse jamais la page.

Zéro config, sinon : déclarez un bloc CSS [data-theme="acme"] dans votre page hôte et listez acme dans available — même résultat, votre feuille de style.

Un thème de marque, sorti du générateur
{
  "theme": {
    "default": "acme",
    "available": ["acme", "dark", "corporate"],
    "custom": [
      {
        "name": "acme",
        "extends": "dark",
        "tokens": {
          "--color-primary": "#6d28d9",
          "--color-primary-content": "#f5f3ff",
          "--radius-box": "0.5rem"
        }
      }
    ]
  }
}

Nom, logo, liens.

branding.productName et branding.logoUrl mettent votre identité dans l’en-tête ; branding.footerLinks ajoute mentions légales, contact ou page de statut à la barre de pied de page. Dans un portail multi-spec, chaque spec peut se rebrander et rethémer individuellement — sauf theme.custom, qui reste à la racine, les thèmes étant injectés une fois au démarrage. Vos lecteurs gardent leur thème jusque dans la console d’essai ; extraits et formulaires le suivent comme tout le reste.

La boîte « À propos » reste.

La petite ligne « Powered by » et la boîte « À propos » ne se retirent pas — délibérément. Une installation CDN n’embarque ni README, ni LICENSE, ni NOTICE : cette boîte est le seul endroit où les mentions des composants open source embarqués atteignent vos utilisateurs. C’est la garantie de notice qui rend l’installation MIT propre ; tout le reste se rebrande.