Aller au contenu

Personnaliser son site

Vous êtes auteur·ice sur Kirexo, le plugin web est activé pour votre compte, et vous voulez façonner le site public d'un de vos carnets : son adresse, ses pages, son habillage. Cette page est une carte d'aiguillage — pour chaque besoin, elle vous envoie directement au bon endroit.

Tout se pilote depuis le hub des réglages du site du carnet, à l'adresse /u/web/reglages/site/{notebookId}, sans jamais toucher au code. Vous l'atteignez depuis « Mon espace » : menu ⋯ de la carte du carnet → « Configurer Web ».

La configuration est portée par le carnet, pas par le compte

Chaque carnet a son propre site : son domaine, ses pages spéciales, son apparence. Il n'y a donc pas de lien « Mon site » dans le menu du compte (aucune cible unique à proposer) ni d'adresse de réglages sans carnet — /u/web/reglages/site répond 404. Le seul chemin d'accès est le menu ⋯ du carnet. Voir Configurer le site web d'un carnet et, pour le pourquoi, Configuration par carnet et extensibilité des plugins.

Prérequis : le plugin web activé

Sans plugin web, pas de site à configurer : le lien « Configurer Web » n'apparaît pas dans le menu ⋯ de vos carnets et les adresses /u/web/… répondent 404. Activez d'abord le canal — voir Activer un plugin pour son compte. La gestion des plugins reste accessible sous « Plugins », dans le menu du compte.

Selon ce que vous voulez faire

Votre besoin Où aller
Ouvrir les réglages du site d'un carnet (et créer ce site) Guide — Configurer le site web d'un carnet
Rattacher un nom de domaine au site du carnet, comprendre l'état « En attente » → « Actif » Tutoriel — Étape « Rattacher un domaine »
Connaître les règles des domaines (un domaine par site, unicité, messages) Référence — Domaines de site
Rédiger une page spéciale (« À propos », « Contact »…) Tutoriel — Étape « Rédiger une page spéciale »
Réordonner les pages du menu de son site (glisser-déposer) Guide — Réordonner les pages du menu de son site
Changer l'apparence du site (choisir un thème) Guide — Choisir l'apparence de son site
Écrire son propre thème : dupliquer, créer, modifier, supprimer Guide — Créer, dupliquer, modifier et supprimer un thème de site
Savoir ce que contient un thème (variables, classes CSS, limites) Référence — Thèmes de site

La prévisualisation et le SEO (title, meta description, canonical, Open Graph) sont gérés automatiquement à partir du titre de votre site et de vos articles ; la prévisualisation passe par le même thème et le même pipeline de sécurité que le rendu réel.

L'apparence appartient au thème, pas au site

Il n'y a pas de HTML ni de feuille de style attachés au site : tout l'habillage — en-tête, corps, pied de page, style — appartient au thème que vous appliquez. Les trois thèmes fournis sont maintenus par le projet et ne sont ni modifiables ni supprimables ; en revanche, vous pouvez dupliquer l'un d'eux ou écrire vos propres thèmes, qui appartiennent à votre compte et servent sur tous vos carnets.

Le langage dans lequel un thème est écrit reste borné par sécurité : votre site est public, et Kirexo n'affiche que ce qui figure sur une liste blanche (pas de <script>, pas d'attribut on*, pas de javascript:, pas de règle @, aucune ressource externe). Pour le sens de ces limites, voir Ce que vous pouvez personnaliser sur votre site (et pourquoi ces limites) ; pour leur catalogue, Référence — Thèmes de site ; côté architecture, la frontière de sécurité du rendu personnalisé.

Voir aussi