## Please edit system and help pages ONLY in the moinmaster wiki! For more
## information, please see MoinMaster:MoinPagesEditorGroup.
## Please edit system and help pages ONLY in the moinmaster wiki!
## Merci de n'éditer les pages systèmes et d'aide QUE sur MoinMaster !
## Pour plus d'information, consultez MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnConfiguration/CascadingStyleSheets
##master-date:2006-02-01 00:18:56
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language fr

== Modifier les feuilles de style par défaut de MoinMoin ==

Si vous souhaitez modifier les feuilles de style Moin``Moin 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 Moin``Moin, 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érences``Utilisateur et en cliquant sur le bouton '''<<GetText( Save )>>'''.

== 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.
 1. 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` ;
  1. copiez le fichier python/site-packages/MoinMoin/theme/classic.py dans data/plugin/theme/mon_theme.py ;
  1. ajoutez la ligne ci-dessous à votre fichier `wikiconfig.py` :
  {{{
theme_default = 'mon_theme'}}}
 1. 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.