Ce que vous pouvez personnaliser sur votre site (et pourquoi ces limites)¶
Kirexo vous laisse habiller le site public de chacun de vos carnets. Mais cet habillage ne se saisit pas morceau par morceau : il se choisit, sous la forme d'un thème — que vous prenez dans le catalogue fourni ou que vous écrivez vous-même. Cette page explique la logique derrière ce modèle : ce qu'un thème décide, ce qu'il ne décide pas, pourquoi les thèmes fournis ne sont pas modifiables, et pourquoi le langage dans lequel vous écrivez le vôtre reste borné.
Elle s'adresse à vous, auteur·ice. Pour faire concrètement, voir le guide Choisir l'apparence de son site. Pour le détail technique côté développement, voir Modèle de thème et catalogue fourni et Sécurité du rendu personnalisé des sites.
L'apparence se choisit, elle ne s'écrit pas¶
Un thème décide de quatre choses, et elles suffisent à décrire un site : l'en-tête, le corps de page, le pied de page et le style. Choisir un thème, c'est donc décider de tout l'habillage d'un coup — pas d'un réglage par-ci, d'une surcharge par-là.
Ce n'était pas le modèle précédent, et le changement mérite d'être expliqué. Avant, le site portait trois zones de HTML libre et une feuille de style, plus un « thème » qui ne modifiait que quelques détails. Deux choses n'allaient pas.
On perdait son menu sans le vouloir. Dès que la zone d'en-tête recevait le moindre fragment — un logo, une phrase —, le titre du site et le menu des pages spéciales disparaissaient : la zone remplaçait l'en-tête standard au lieu de s'y ajouter. Autrement dit, tout le travail d'ordonnancement des pages devenait invisible, sans qu'aucun écran ne le signale.
Changer de thème ne changeait rien. Le sélecteur existait, on enregistrait, et le site restait identique. Impossible de savoir si le problème venait du choix, du cache ou d'un bug.
Ces deux symptômes avaient la même cause : l'apparence n'était le sujet d'aucun réglage unique. Elle était dispersée entre quatre champs et le gabarit du site. Avec le thème, la question « à quoi ressemble mon site ? » a une réponse en un mot : le nom de son thème.
Le corollaire est direct : le menu de vos pages spéciales fait partie du thème. Il est écrit dans son en-tête, il ne peut donc plus disparaître par omission. Un thème qui ne voudrait pas de menu devra le retirer explicitement — ce sera une décision, plus un effet de bord.
Pourquoi les thèmes fournis ne sont pas modifiables¶
Trois thèmes sont livrés avec la plateforme : Par défaut, Classique et Minimal. Ils portent tous le badge « Fourni », et aucun ne peut être modifié ni supprimé.
Ce n'est pas une restriction de compte, c'est ce qu'ils sont : des habillages maintenus par le projet, versionnés avec le code, revus comme du code. Ils jouent le rôle d'un point de départ stable — celui sur lequel on peut revenir, et qui ne se dégrade pas au fil des essais. Un thème que tout le monde peut retoucher ne peut pas jouer ce rôle.
C'est exactement pour cela que dupliquer est offert : copier Classique vous donne un thème à vous, celui-là modifiable et supprimable, sans jamais toucher à l'original — qui reste disponible, intact, si votre essai ne vous convainc pas.
Vos thèmes appartiennent à votre compte, pas à un carnet¶
Un thème que vous écrivez n'est rattaché à aucun carnet : il vit dans votre bibliothèque et s'applique au site de n'importe lequel d'entre eux. Si vous tenez trois carnets sous une même identité visuelle, vous écrivez le thème une fois et vous l'appliquez trois fois ; une correction se répercute partout.
C'est une exception assumée : le domaine, les pages spéciales et le thème appliqué sont propres à chaque carnet, mais l'habillage lui-même est une identité d'auteur, pas un réglage de carnet.
Créer un thème ne part d'ailleurs jamais d'une page blanche : un thème neuf est une copie de Par défaut, un site complet et stylé que vous modifiez ensuite. Pour repartir de rien, videz les zones — c'est alors un choix, pas un accident. Le geste complet est décrit dans Créer, dupliquer, modifier et supprimer un thème de site.
On ne vous refuse pas d'enregistrer¶
Écrire un thème est un travail par essais successifs. Kirexo n'oppose donc aucun refus de contenu : si une balise n'est pas autorisée, si vous oubliez l'emplacement où poser vos articles, si une règle CSS sort du cadre, votre thème est quand même enregistré, et un message vous dit ce qui a été retiré et pourquoi.
Le raisonnement est celui du moindre dégât. Un thème incomplet donne un site un peu bancal — les articles s'ajoutent en fin de zone, un style ne s'applique pas — mais lisible. Refuser l'enregistrement, à l'inverse, vous ferait perdre quatre zones de travail pour un oubli de trente secondes. Deux choses seulement sont réellement refusées : un thème sans nom, et un texte si long qu'une partie ne serait jamais affichée.
Une nuance à connaître : votre CSS est enregistré filtré — ce qui a été retiré ne revient pas dans le champ. Vos gabarits (en-tête, corps, pied de page), eux, sont enregistrés tels que vous les avez écrits et nettoyés seulement au moment d'afficher le site : vous pouvez donc les relire et les corriger. Le bouton « Vérifier le CSS » existe précisément pour voir les retraits avant d'enregistrer.
Pourquoi le langage d'un thème est borné¶
Vos sites sont publics. Le HTML et le CSS d'un thème s'exécutent dans le navigateur de chaque personne qui vous lit. C'est ce qui rend la personnalisation utile — et c'est aussi ce qui la rend sensible.
Du contenu écrit par une personne et exécuté dans le navigateur d'une autre, c'est la porte d'entrée classique d'une attaque appelée stored XSS (injection de script persistante) : un fragment malveillant, une fois stocké, ne frappe pas une fois, il frappe tout votre trafic en continu. La réponse de Kirexo n'est pas « tout ou rien », c'est une liste de ce qui est permis : ce qui y figure passe, tout le reste est retiré.
Cette approche a une conséquence directe : en cas de doute, Kirexo retire. Il ne cherche jamais à « réparer » un fragment douteux ni à le laisser passer par précaution. Le résultat peut être un peu plus pauvre que ce qui était écrit, mais il n'est jamais dangereux. C'est un compromis volontaire : mieux vaut un site légèrement moins stylé qu'un site vulnérable — pour vous comme pour vos lecteurs.
Les thèmes fournis sont écrits dans exactement ce même langage. Ce n'est pas un détail : c'est ce qui garantit que lorsque vous dupliquez Classique, votre copie ressemble vraiment à Classique. Il n'existe pas de vocabulaire réservé aux thèmes de la maison.
Deux limites de ce langage valent d'être connues, parce qu'elles surprennent :
- Aucune ressource externe. Pas de police téléchargée, pas d'image hébergée ailleurs. Un thème s'appuie sur des polices système ou sur celles de la plateforme. Charger une ressource distante renseignerait un tiers sur chacun de vos lecteurs, et ouvrirait une porte à des règles qu'on ne contrôle plus.
- Pas de « point de rupture » d'écran. Un thème s'adapte aux petits écrans par des tailles fluides et des colonnes élastiques, pas par des règles conditionnelles. C'est une contrainte de style assumée, qui garde le filtre simple — et donc relisible. Les trois thèmes fournis montrent que c'est largement suffisant.
Le catalogue exact des variables, classes et propriétés utilisables est rassemblé dans la Référence — Thèmes de site.
Ce qu'un thème ne décide pas¶
Un thème habille votre site ; il ne le gouverne pas. Trois choses lui échappent volontairement.
- La structure et l'accessibilité. Les repères de navigation de la page et le lien « Aller au contenu » sont posés par Kirexo, pas par le thème. Un thème mal écrit peut être laid ; il ne peut pas rendre votre site inutilisable au clavier.
- Le référencement. Titre de page, description, adresse canonique et aperçus de partage sont calculés à partir de vos contenus réels. Aucun thème ne peut les écraser.
- La navigation entre les pages de votre flux. Les liens « Précédent / Suivant » vivent dans le contenu, pas dans le pied de page : même un thème au pied vide les affiche.
Un thème ne touche pas non plus à vos articles, à leurs destinations ni à votre domaine. Vous pouvez en changer autant de fois que vous voulez : rien de ce que vous avez publié n'en dépend.
Vous ne pouvez pas casser votre site¶
Deux garde-fous méritent d'être connus, parce qu'ils vous autorisent à essayer sans crainte.
Un thème introuvable ne fait pas tomber le site. Si le thème appliqué à un site devient indisponible — parce que vous l'avez supprimé, par exemple —, le site est servi avec Par défaut, silencieusement. Vos lecteurs voient un habillage inattendu, jamais une page d'erreur. C'est pour cela que rien ne vous empêche de supprimer un thème en service : Kirexo vous dit simplement combien de sites viennent de repasser à Par défaut.
Un thème mal écrit dégrade la mise en page, il ne masque pas vos textes. Le corps d'un thème contient un emplacement où le site vient poser la page demandée. Si cet emplacement manque, le contenu est simplement ajouté à la fin de la zone : la mise en page est bancale, mais vos articles restent lisibles et vos liens restent cliquables.
Le mode clair/sombre appartient à vos lecteurs¶
Le thème du site décide de la mise en page et de la typographie. Le mode clair ou sombre, lui, est un réglage de chaque visiteur, dans son propre navigateur. Les deux se combinent : les trois thèmes fournis emploient les couleurs de la plateforme et restent donc lisibles dans les deux modes, sans que vous ayez à vous en occuper.
Voir aussi¶
- Choisir l'apparence de son site — la recette : ouvrir l'onglet Apparence, cocher un thème, appliquer.
- Créer, dupliquer, modifier et supprimer un thème de site — la recette pour écrire le vôtre.
- Référence — Thèmes de site — le catalogue fourni et le contrat exact d'un thème.
- Modèle de thème et catalogue fourni — la même bascule, racontée côté conception.
- Sécurité du rendu personnalisé des sites — le détail technique des barrières (sandbox, sanitizer, filtre CSS, CSP).
- Rendu public d'un site (plugin web) — comment votre site est servi à vos lecteurs.