Aller au contenu

Créer, dupliquer, modifier et supprimer un thème de site

Vous êtes auteur·ice sur Kirexo, les trois thèmes fournis ne vous conviennent pas, et vous voulez écrire votre propre habillage : en-tête, corps, pied de page et style. Ce guide couvre les quatre gestes de la bibliothèque de thèmes de votre compte : dupliquer, créer, modifier, supprimer.

Pour seulement appliquer un thème existant au site d'un carnet, voir Choisir l'apparence de son site — c'est un geste distinct, et plus court.

Prérequis

Écrire un thème ne demande aucun carnet ; l'appliquer, oui

Un thème appartient à votre compte : vous pouvez donc en écrire un avant même d'avoir un site à habiller. C'est l'étape 5 — appliquer le thème — qui exige un carnet dont le site existe, c'est-à-dire auquel un domaine est rattaché. Voir Configurer le site web d'un carnet.

Étape 1 — Ouvrir sa bibliothèque de thèmes

Deux chemins mènent à /u/web/themes :

  • Depuis le menu du compte — cliquez sur le bouton portant votre prénom, en haut à droite de n'importe quel écran de votre espace, puis sur « Mes thèmes ». C'est le chemin le plus court, et le seul qui ne demande aucun carnet configuré. Détail : Accéder à mes thèmes.
  • Depuis les réglages d'un carnet — menu ⋯ du carnet sur « Mon espace » › « Configurer Web » › onglet Apparence › bouton « Gérer mes thèmes » (le lien « Mes thèmes » du texte d'aide mène au même endroit).

Vous arrivez sur « Mes thèmes » (/u/web/themes), organisée en deux listes :

  • Thèmes fournis — Par défaut, Classique, Minimal, tous marqués « Fourni ». Seule action offerte : Dupliquer.
  • Mes thèmes — les vôtres, avec Modifier, Dupliquer et Supprimer.

Chaque ligne indique le nombre de vos sites qui utilisent ce thème (« 2 site(s) »). C'est ce compteur qui vous dit ce que vous touchez avant de modifier ou de supprimer.

Un thème appartient à votre compte, pas à un carnet

Même quand vous entrez dans la bibliothèque par un carnet, ce que vous y créez n'est rattaché à aucun carnet. Un thème écrit une fois est applicable au site de n'importe lequel de vos carnets, autant de fois que vous voulez.

Étape 2 — Partir d'un thème existant (dupliquer)

C'est le geste recommandé, et la seule opération possible sur un thème fourni.

Sur la ligne du thème à copier, cliquez sur « Dupliquer ». Kirexo :

  1. crée un thème à vous, nommé <nom d'origine> (copie) ;
  2. y recopie les quatre sources de l'original ;
  3. affiche « « Classique » dupliqué. » et vous ouvre directement l'écran de modification.

La copie rend exactement comme l'original : le langage dans lequel les thèmes fournis sont écrits est celui qui vous est offert, sans vocabulaire réservé. Vous pouvez donc partir de Classique et n'en changer que la typographie.

Étape 3 — Créer un thème (à partir de « Par défaut »)

Cliquez sur « Nouveau thème », en bas de la bibliothèque. Le formulaire ne demande qu'un nom (80 caractères maximum), puis « Créer et écrire le thème ».

Le thème est créé comme une copie de « Par défaut » — un site complet, stylé, avec sa navigation — et non comme quatre zones vides. Le message « Thème créé à partir de « Par défaut ». À vous de l'écrire. » confirme la création, et l'écran de modification s'ouvre.

Pour repartir réellement de zéro, videz les zones dans l'écran suivant : c'est un geste explicite, qui vous évite de vous retrouver par accident avec un site sans en-tête ni style.

Si le nom est refusé

Un nom vide donne « Donnez un nom à votre thème. », un nom trop long « Le nom d'un thème ne dépasse pas 80 caractères. ». Le formulaire de création est réaffiché avec le message ; ressaisissez le nom.

Étape 4 — Modifier un thème

L'écran de modification (Modifier depuis la bibliothèque) porte un seul formulaire avec cinq champs :

Champ Ce que vous y écrivez
Nom du thème Le libellé affiché dans la bibliothèque et dans l'onglet Apparence.
En-tête Le contenu de l'en-tête du site : marque, navigation des pages spéciales.
Corps La mise en page de la zone principale, contenant {{ content }}.
Pied de page Le contenu du pied de page.
CSS du thème Toute la feuille de style du site.

Si le thème est déjà en service, un message le rappelle en haut : « Ce thème est appliqué à N site(s) : enregistrer met à jour leur affichage immédiatement. »

Placer le contenu avec {{ content }}

Le corps décrit la mise en page, pas le contenu. L'endroit où vos articles, votre article ou votre page spéciale viennent s'insérer est marqué par {{ content }} :

<div class="ma-colonne">
    {{ content }}
</div>

Si vous l'oubliez, l'enregistrement réussit quand même et un message vous prévient : « Corps : le contenu n'est placé nulle part. Ajoutez {{ content }} à l'endroit où vos articles doivent apparaître — sans lui, ils sont ajoutés à la fin. » Votre site reste lisible ; seule sa mise en page est dégradée.

Vérifier le CSS avant d'enregistrer

Le CSS d'un thème est enregistré filtré, jamais tel quel : ce qui sort de ce que le filtre autorise est retiré à l'écriture (voir les limites du CSS d'un thème).

Le bouton « Vérifier le CSS » montre ces retraits avant d'enregistrer, sans rien modifier :

  • si rien n'est en cause : « Aucun fragment ne sera retiré. » ;
  • sinon, la liste des fragments concernés, chacun avec sa raison — par exemple « Propriété « position » non autorisée. » ou « Les règles @ à blocs (media, supports, font-face…) ne sont pas prises en charge. ».

Le champ CSS bénéficie aussi de la coloration syntaxique et d'une autocomplétion restreinte aux propriétés réellement autorisées : ce qu'elle propose est ce qui passera.

Enregistrer

Cliquez sur « Enregistrer le thème ». Le message « Thème enregistré. » confirme, et l'écran de modification se recharge en affichant, le cas échéant :

  • ce que le filtre CSS a retiré, fragment par fragment, avec la raison ;
  • ce que l'assainissement HTML retirerait dans chaque zone : « En-tête : Des balises HTML non autorisées ont été retirées par le filtre de sécurité. », ou un refus de la sandbox comme « Corps : Le tag « include » n'est pas autorisé. » ;
  • le rappel sur {{ content }} si le corps n'en contient pas.

Ces messages sont informatifs, jamais bloquants : rien n'est refusé, votre travail est enregistré dans tous les cas.

Deux traitements différents, et c'est voulu

Le CSS est filtré à l'enregistrement : ce qui est stocké est déjà propre. Les gabarits (en-tête, corps, pied) sont stockés tels que vous les avez écrits et assainis au moment d'afficher le site — exactement comme les thèmes fournis. Vous pouvez donc relire et corriger votre HTML à l'identique après enregistrement, alors qu'un fragment de CSS retiré ne revient pas. Le pourquoi est détaillé dans Écrire ses propres thèmes : les arbitrages.

Un gabarit refusé par la sandbox fait retomber le site sur « Par défaut »

Si l'une des trois zones est refusée au rendu (un tag Twig interdit, par exemple), le site public est servi entièrement avec « Par défaut », et non avec un mélange. Le message affiché à l'enregistrement est votre seul avertissement — corrigez la zone signalée.

En cas d'erreur de validation

Une saisie refusée (nom vide, zone dépassant 500 000 caractères) ne fait pas perdre votre travail : le formulaire est réaffiché avec ce que vous veniez d'écrire, message d'erreur en tête. Corrigez et réenregistrez.

Étape 5 — Appliquer le thème à un carnet

Un thème n'est pas appliqué du seul fait d'exister. Retournez dans l'onglet Apparence du carnet visé : vos thèmes y sont listés sous les trois fournis, sans badge. Cochez le vôtre, puis « Appliquer ce thème ». Voir Choisir l'apparence de son site.

Répétez pour chaque carnet à habiller : le même thème peut servir sur tous.

Étape 6 — Supprimer un thème

Sur la ligne du thème, cliquez sur « Supprimer ». Le navigateur demande confirmation (« Supprimer « Mon thème » ? Les sites qui l'utilisent repasseront au thème « Par défaut ». ») ; sans JavaScript, la suppression part directement.

La suppression est autorisée même si le thème est en service. Les sites concernés repassent alors silencieusement à « Par défaut », et le message vous dit combien : « « Mon thème » supprimé. 2 site(s) sont repassés au thème « Par défaut ». » Vos lecteurs voient un habillage inattendu, jamais une page d'erreur.

Il n'y a pas de corbeille pour les thèmes : la suppression est définitive. Dupliquez avant, si vous voulez garder une version de côté.

Ce qui se met à jour, et quand

Enregistrer ou supprimer un thème met à jour les sites concernés immédiatement : leur cache est invalidé et la feuille de style est servie sous une nouvelle adresse (l'URL de site.css porte une empreinte du style). Rechargez votre site public, il est déjà à jour — rien à vider, rien à attendre.

Points d'attention

  • Sans JavaScript, tout fonctionne. Le CSS part avec le reste du formulaire, la suppression est un vrai formulaire. Seule l'assistance disparaît : coloration, autocomplétion et bouton « Vérifier le CSS ». Le filtrage, lui, a lieu de toute façon à l'enregistrement, avec les mêmes messages.
  • Pas de règle @media. Un thème s'adapte aux petits écrans avec clamp(), max-width, flex-wrap et minmax(). C'est une contrainte assumée, que les trois thèmes fournis respectent.
  • Aucune ressource externe. Ni police distante, ni image hébergée ailleurs : seules les data-URI d'image sont acceptées dans une url().
  • Certaines propriétés sont refusées — position, z-index, content, transform, filter, animation, transition, entre autres.
  • Attention à order et flex-direction: row-reverse / column-reverse. Ils sont autorisés, mais font diverger l'ordre visuel de l'ordre de lecture réel : la navigation au clavier et les lecteurs d'écran ne suivent plus ce que l'œil voit.
  • Le thème d'un autre compte est inaccessible. Ouvrir l'adresse de modification d'un thème qui n'est pas le vôtre répond 403, et il n'apparaît nulle part dans votre bibliothèque.

Les liens externes d'un thème sortent en nofollow

Un lien de thème est présent sur toutes les pages du site, contrairement à un lien posé dans un article : sans précaution, un thème devient une link farm. Au rendu, chaque <a> de vos gabarits reçoit donc noopener noreferrer, plus nofollow si son hôte n'est pas un domaine du site courant (src/Plugin/Web/src/Security/ExternalLinkRelSanitizer.php). Les tokens rel que vous écrivez vous-même (sponsored, ugc…) sont conservés, et les liens internes — relatifs, ancres, mailto: — ne reçoivent jamais de nofollow.

Voir aussi