Personnaliser son site¶
Vous êtes auteur·ice sur Kirexo, vous avez activé le plugin web pour votre compte, et vous voulez maintenant donner à l'un de vos carnets un site public : son adresse et ses pages d'accompagnement. À la fin de ce tutoriel, vous aurez rattaché un nom de domaine au carnet — ce qui crée son site — et rédigé une première page spéciale (par exemple « À propos »), publiée et rangée dans le menu du site.
Tout se passe depuis un espace unique, le hub des réglages du site du carnet, sans jamais toucher au code. Comptez une dizaine de minutes.
La configuration se fait carnet par carnet
Chaque carnet a son propre site, avec son propre domaine, ses propres pages spéciales et sa propre apparence. Ce tutoriel configure un carnet ; recommencez le parcours pour chacun des carnets que vous voulez équiper d'un site. Le pourquoi de ce découpage est expliqué dans Configuration par carnet et extensibilité des plugins.
Prérequis¶
Avant de commencer, assurez-vous d'avoir :
- Un compte Kirexo et d'être connecté·e à votre espace. Si ce n'est pas le cas, commencez par vous connecter.
- Activé le plugin web pour votre compte. Sans lui, aucun de vos carnets ne peut avoir de site. Si vous ne l'avez pas encore fait, suivez d'abord Activer un plugin pour son compte, puis revenez ici.
- Au moins un carnet. Pour en créer un, voir Créer et renommer un carnet.
Pas de plugin web, pas de site
Tant que vous n'avez pas activé le plugin web, il n'y a rien à configurer : le lien « Configurer Web » n'apparaît pas dans le menu de vos carnets, et les adresses de réglages du plugin répondent 404. Activez le plugin, et le lien apparaîtra.
Étape 1 — Ouvrir le hub des réglages du site du carnet¶
Une fois connecté·e et le plugin web activé :
- Depuis « Mon espace », repérez la carte du carnet à configurer.
- Ouvrez son menu ⋯ (le bouton « Actions du carnet », en haut à droite de la carte).
- Cliquez sur « Configurer Web ».
Le hub s'ouvre à l'adresse /u/web/reglages/site/{notebookId}, où {notebookId} est l'identifiant du carnet. Le fil d'Ariane affiche « Mon espace › \<votre carnet> › Réglages du site » et le titre reprend le nom du carnet — c'est votre repère pour savoir quel carnet vous êtes en train de configurer.
Il n'y a pas de lien « Mon site » dans le menu du compte
Comme chaque carnet a son propre site, l'entête n'a pas de cible unique à proposer : le menu du compte ne contient donc que l'entrée « Plugins » (l'activation de vos canaux). La configuration du site s'ouvre toujours depuis le carnet.
Cette page rassemble, sous forme d'onglets, tout ce qui touche au site de ce carnet :
- Domaine — l'adresse par laquelle le site est joignable.
- Pages spéciales — les pages d'accompagnement (« À propos », « Contact »…).
- Apparence — le thème et l'habillage du site (voir la dernière section).
Sur un carnet tout neuf, seul l'onglet Domaine s'affiche : le site n'existe pas encore. Les deux autres onglets apparaîtront à l'étape suivante, une fois le domaine rattaché.
Étape 2 — Rattacher un domaine¶
Un domaine est l'adresse web à laquelle vos visiteurs trouveront le site de ce carnet (par exemple mon-blog.fr). Un site est rattaché à un seul domaine à la fois.
Tant qu'aucun domaine n'est rattaché, l'onglet Domaine affiche un formulaire de rattachement :
- Saisissez le nom de domaine dans le champ prévu, sans
http://ni/— juste le nom, par exemplemon-blog.fr. - Validez.
C'est ce geste qui crée le site du carnet. Le domaine s'affiche alors avec son badge d'état et un lien « Voir mon site » (qui ouvre https://votre-domaine dans un nouvel onglet). Le formulaire de rattachement disparaît : le site ayant désormais son domaine, il n'y a plus rien à rattacher. Les onglets Pages spéciales et Apparence viennent de faire leur apparition à côté de Domaine.
Comprendre l'état « En attente » puis « Actif »¶
Un domaine fraîchement rattaché s'affiche avec le badge « En attente ». C'est normal : Kirexo ne considère un domaine comme « Actif » qu'à partir du moment où du trafic l'atteint réellement pour la première fois.
Juste après le rattachement, un message vous le rappelle :
Domaine rattaché. Il passera « actif » dès la première visite.
Autrement dit, une fois que vous aurez fait pointer ce domaine vers Kirexo (configuration DNS, côté hébergeur) et qu'une première requête arrivera dessus, son badge basculera tout seul sur « Actif ». Vous n'avez rien de plus à cliquer : c'est la première visite qui déclenche le changement d'état.
Le badge est lisible sans distinguer les couleurs
L'état n'est jamais indiqué par la seule couleur : le badge combine une pastille, la couleur et le texte (« En attente » / « Actif »). Vous savez toujours où en est un domaine, même sans percevoir les nuances de couleur.
Si le domaine est mal formé¶
Si vous saisissez quelque chose qui n'est pas un nom de domaine valide (par exemple exemple sans extension, ou une adresse avec des caractères interdits), le rattachement est refusé et un message d'erreur explicite s'affiche. Corrigez la saisie et validez à nouveau ; rien n'a été enregistré entre-temps.
Si le domaine est déjà utilisé¶
Un même domaine ne peut être rattaché qu'à un seul site sur toute la plateforme. Si le domaine que vous saisissez est déjà pris — par vous ou par quelqu'un d'autre — le rattachement est refusé avec le message :
Ce domaine est déjà rattaché à un site.
Choisissez un autre domaine.
Changer de domaine¶
Comme votre site ne porte qu'un seul domaine à la fois, il n'y a pas de formulaire de rattachement tant qu'un domaine est en place. Pour en changer, procédez en deux temps : utilisez le bouton Supprimer du domaine actuel — le formulaire de rattachement réapparaît alors — puis rattachez le nouveau domaine comme à l'étape précédente.
Un domaine par site
Le catalogue complet des règles (unicité, états, messages) est dans la Référence — Domaines de site.
Étape 3 — Rédiger une page spéciale¶
Une page spéciale est une page d'accompagnement de votre site — « À propos », « Contact », mentions légales… Vous la rédigez avec le même éditeur que vos articles, mais ce n'est pas un article : elle vit uniquement sur votre site et n'est diffusée sur aucun autre canal. Pour comprendre cette distinction, voir Pages spéciales du plugin web.
Créer la page¶
Dans l'onglet Pages spéciales, choisissez créer une nouvelle page. Le formulaire vous demande :
- Un titre — par exemple
À propos. Il est obligatoire. - Un identifiant d'URL (slug) — le morceau d'adresse qui désignera la page sur votre site, par exemple
a-propos. Il est obligatoire lui aussi.
Certains identifiants sont réservés
Quelques identifiants sont interdits parce qu'ils entreraient en conflit avec des adresses techniques de la plateforme — par exemple admin. Si vous en saisissez un, la page n'est pas créée et un message vous invite à en choisir un autre. De même, deux pages du même site ne peuvent pas partager le même identifiant : vous verrez alors « Une page utilise déjà ce slug. ». Choisissez simplement un autre identifiant.
Écrire le contenu¶
Rédigez le corps de la page dans l'éditeur, exactement comme pour un article : titres, listes, liens, mise en forme. C'est le même outil que celui décrit dans Écrire, enregistrer et publier un article.
Enregistrer la page¶
Le formulaire ne vous demande pas de choisir un état de publication : une page enregistrée est toujours un brouillon. Elle est bien conservée, mais reste invisible pour vos visiteurs — pratique pour préparer un texte tranquillement. Enregistrez : la page rejoint la liste de vos pages spéciales, où elle apparaît avec le badge « Brouillon ».
Rien n'est publié à votre place
Une page spéciale naît toujours en brouillon. Aucune action automatique ne publie une page pour vous : la mise en ligne est toujours un geste que vous accomplissez vous-même, depuis la liste.
Publier ou dépublier depuis la liste¶
La mise en ligne ne se fait pas dans le formulaire, mais depuis la liste des pages spéciales de l'onglet Pages spéciales. Chaque page y affiche son badge d'état et les actions disponibles :
- Sur une page en brouillon, cliquez sur « Publier ». La page apparaît alors dans le menu de votre site et devient consultable ; son badge passe à « Publié » et le bouton devient « Dépublier ».
- Sur une page publiée, cliquez sur « Dépublier » pour la retirer du site. Une confirmation vous est demandée, car la page ne sera plus visible publiquement. Une fois confirmée, elle repasse en « Brouillon » et le bouton redevient « Publier ».
Vous pouvez publier puis dépublier une page autant de fois que nécessaire : c'est toujours le même geste, depuis la liste.
Ranger les pages dans le menu¶
L'ordre des pages dans le menu de votre site se règle par glisser-déposer dans la liste, il n'y a pas de numéro à saisir. La liste s'affiche dans l'ordre du menu : la page tout en haut est la première du menu, celle tout en bas la dernière. Une page fraîchement créée arrive en dernier.
Pour déplacer une page, saisissez la poignée (l'icône ⠿) à gauche de sa ligne, glissez-la vers le haut ou le bas, puis relâchez. L'ordre est enregistré aussitôt et le menu de votre site public le reflète immédiatement. C'est ainsi que vous faites, par exemple, figurer « À propos » avant « Contact ».
Le glisser-déposer a besoin de JavaScript
Le réordonnancement est une commodité qui nécessite JavaScript. Sans JavaScript, la liste reste lisible et toutes les autres actions (publier, dépublier, modifier, supprimer) fonctionnent ; seul le glisser-déposer est indisponible. Détails dans le guide Réordonner les pages du menu de son site.
Modifier ou supprimer une page¶
Depuis la liste de vos pages spéciales :
- Modifier — rouvrez la page pour changer son titre, son identifiant ou son contenu. La modification ne touche jamais à l'état de publication : une page publiée que vous modifiez reste publiée, un brouillon reste brouillon. Pour changer l'état, utilisez les boutons Publier / Dépublier de la liste ; pour changer l'ordre, utilisez le glisser-déposer décrit ci-dessus.
- Supprimer — retirez définitivement la page. Elle disparaît de votre site et de la liste.
Personnaliser l'apparence¶
L'onglet Apparence ne contient qu'un seul réglage : le thème du site de ce carnet. Un thème décide de tout l'habillage à la fois — l'en-tête, le corps de page, le pied de page et le style. Il n'y a rien à écrire, rien à coder : vous choisissez, vous appliquez.
Ouvrez le hub des réglages du carnet (« Mon espace » → menu ⋯ du carnet → « Configurer Web », soit /u/web/reglages/site/{notebookId}) puis cliquez sur l'onglet Apparence.
Une apparence par carnet
Le thème que vous réglez ici ne concerne que le site de ce carnet. Vos autres carnets gardent le leur.
Étape 4 — Choisir un thème¶
Trois thèmes sont fournis avec la plateforme, présentés côte à côte avec le badge « Fourni » :
- Par défaut — la ligne éditoriale de Kirexo : colonne de lecture étroite, marque à gauche, menu à droite.
- Classique — la mise en page d'un quotidien : bandeau de titre centré entre deux filets, navigation en petites capitales, titres serif.
- Minimal — l'esprit du smolweb : police système, colonne étroite, liens soulignés, aucune fioriture.
Pour l'exercice, cochez Classique, puis cliquez sur « Appliquer ce thème ». Un message « Thème appliqué. » confirme l'enregistrement.
Ouvrez maintenant votre site public (le lien « Voir mon site » de l'onglet Domaine) : il a déjà changé d'allure. Vous n'avez rien à vider ni à attendre. Le titre de votre site et la page « À propos » que vous venez de créer sont là, présentés à la manière de Classique.
Revenez à l'onglet Apparence et essayez Minimal, puis Par défaut : à chaque fois, le site public suit immédiatement. Rien de ce que vous avez écrit n'est affecté — un thème ne touche ni à vos pages, ni à vos articles, ni à votre domaine.
Le thème et le mode clair/sombre se combinent
Le thème décide de la mise en page et de la typographie. Le mode clair ou sombre est réglé par chaque visiteur depuis son navigateur : les trois thèmes fournis restent lisibles dans les deux modes, vous n'avez rien à faire pour cela.
Les thèmes fournis ne se modifient pas — mais ils se dupliquent
Les trois thèmes livrés sont maintenus par le projet : ils ne sont ni modifiables ni supprimables. Pour partir de l'un d'eux, dupliquez-le : la copie vous appartient, elle rend à l'identique de l'original, et vous pouvez la modifier autant que vous voulez. Le bouton « Gérer mes thèmes », sous le sélecteur, ouvre votre bibliothèque — c'est le sujet du guide Créer, dupliquer, modifier et supprimer un thème de site, à lire après ce tutoriel. Le pourquoi de ce choix est expliqué dans Ce que vous pouvez personnaliser sur votre site (et pourquoi ces limites).
Et ensuite ?¶
Le site de ce carnet a désormais une adresse et une première page. Pour aller plus loin :
- Écrire, enregistrer et publier un article — remplir votre site de contenu. Attention : un site n'affiche que les articles de son carnet, écrivez donc dans le bon carnet.
- Choisir les destinations d'un article — diffuser vos articles vers vos canaux actifs, dont le web.
- Choisir l'apparence de son site — la version « recette » du changement de thème.
- Créer, dupliquer, modifier et supprimer un thème de site — écrire votre propre habillage quand les trois thèmes fournis ne suffisent plus.
- Configurer le site web d'un carnet — la version « recette » de ce parcours, à rejouer pour chaque carnet suivant.
Voir aussi¶
- Activer un plugin pour son compte — le préalable à ce tutoriel.
- Configuration par carnet et extensibilité des plugins — pourquoi la configuration est portée par le carnet et non par le compte.
- Pages spéciales du plugin web — pourquoi une page spéciale n'est pas un article.
- Ce que vous pouvez personnaliser sur votre site (et pourquoi ces limites) — pourquoi l'apparence se choisit plutôt qu'elle ne s'écrit.
- Référence — Thèmes de site — le catalogue fourni et le contrat exact d'un thème.
- Résolution multi-tenant : du domaine au site — comment Kirexo relie un domaine visité au bon site.