Modifier les feuilles de style par défaut de MoinMoin

Si vous souhaitez modifier les feuilles de style MoinMoin par défaut, il est recommandé de commencer par créer un nouveau thème. Copiez l'un des thèmes existants sous un nouveau nom (sans oublier de copier le fichier nom_du_theme.py). Utilisez la fonction @import pour importer la feuille de style CSS originale. Redéfinissez uniquement les attributs que vous souhaitez modifier. Ainsi, lors de la prochaine mise à jour de MoinMoin, toute modification apportée à la feuille de style CSS originale sera automatiquement reprise.

Par exemple : 

@import url("/wiki/classic/css/screen.css");

body {
    background-color: #FAEBD7;  
    font-family: Arial,Helvetica;  
}

Permettre aux utilisateurs de choisir une feuille de style

Afin de permettre aux utilisateurs de choisir d'autres feuilles de style, vous devrez d'abord préparer plusieurs choix. En partant de l'exemple ci-dessus, modifiez la couleur de fond (background-color) en lui donnant la valeur #E7FFE7 et enregistrez-la sous le nom vert.css dans htdocs/mytheme/css/.

Pour essayer cette possibilité, modifiez vos préférences utilisateur en indiquant dans la case « URL du style CSS personnel » la valeur /wiki/mytheme/css/vert.css.

Enfin vous devrez sans doute modifier la page AideDesPréférencesUtilisateur et modifier le texte accompagnant la définition de la préférence URL du style CSS personnel pour indiquer à vos utilisateurs les choix disponibles, y compris la disponibilité d'un style permettant d'avoir un fond vert.

Note : il est possible de revenir à la valeur par défaut en effaçant le contenu du champs URL du style CSS personnel des PréférencesUtilisateur et en cliquant sur le bouton 保存.

Comment faire pour utiliser mon ancien style .css dans le nouveau MoinMoin utilisant les thèmes ?

  1. Choisissez votre thème préféré ou celui qui ressemble le plus à votre ancien style.

  2. Réalisez une copie de ce thème dans le répertoire des modules d'extension de votre wiki (répertoire data/plugin). Par exemple, si vous partez du thème classic afin de créer le thème mon_theme, suivez les instructions suivantes :

    1. copiez le contenu du répertoire htdocs/classic (contenant les sous-répertoires css et img) dans le répertoire htdocs/mon_theme ;

    2. copiez le fichier python/site-packages/MoinMoin/theme/classic.py dans data/plugin/theme/mon_theme.py ;

    3. ajoutez la ligne ci-dessous à votre fichier wikiconfig.py : 

      theme_default = 'mon_theme'

  3. Modifiez les fichiers CSS du thème mon_theme (common.css, screen.css and print.css) afin de chnager le style et mon_theme.py afin de modifier l'ordre d'apparition des éléments dans le HTML produit. Assurez-vous au moins d'avoir donné à la variable name (en haut de la classe Theme) la valeur 'mon_theme', sans quoi les modfications apportées aux fichiers CSS de mon_theme resteraient sans effet.

De cette façon, vous disposerez déjà de votre thème personnel, ce qui simplifiera les mises à jour suivantes.