Certaines modifications sont faites sur le wiki de MoinMoin pour nos besoins
Sommaire
Modification de fichiers du paquet de MoinMoin
On retrouve dans /usr/scripts/wiki les fichiers de moinmoins que nous avons modifiés nous-mêmes. Pour qu'ils soient utilisés ont surrpime les originaux dans /usr/share/python-support/python-moinmoin/MoinMoin et on les remplaces par des liens symboliques pointant vers les fichiers correspondant dans /usr/script/wiki. Pour différencier quels fichiers il faut mettre et ne pas mettre on créé un fichier portant l'extension .orig.py pour ceux qu'on utiliser.
Voir aussi la page de rouge.
Les fichiers qui s'y trouvent sont commités avec la source originale correspondant à la version du paquet debian installé. Les diffs suivants correspondent à nos modifications propres. Les lignes modifiées sont repérables avec les balises {{{#### HACK SAUVAGE et
}}}
Les patchs sont regroupés sur cette page
Ajout de macro/parser/formatter
Ces éléments sont stockées dans dans leur répertoire respectif dans /usr/scripts/wiki
Include: Rien n'a été trouvé sur « [[[TableOfContents]]] » !
Création de macros
Sommaire
Une macro est un fichier python MaMacro.py qui sera exécuté dans une page wiki lorsque le parseur rencontre <<MaMacro(args)>>
Toutes les macros ont une fonction principale execute(macro,arg).
arg est l'argument donné à la macro
En particulier (dans la nouvelle version de MoinMoin), quand on écrit <<MaMacro>>, args sera None (et non "")…
macro est une instance de la classe MoinMoin macro
macro.formatter est le formatter à utiliser, demandé par le client (html, texte…). Son utilisation est décrite plus bas.
macro.request est la requête MoinMoin, elle contient tout un tas d'informations sur l'utilisateur, le client…
Le parseur remplacera dans la page [[MaMacro(args)]] par ce que renvoie la commande execute.
Création de parseur
Création de formatter
Ajout de thème
La partie en python s'occupant de la mise en forme est stockée dans /usr/scripts/wiki/theme
Les éléments graphiques (css et images) sont eux stockés dans /usr/share/moin/htdocs/le_nom_du_theme
D'ailleurs on pourrait aussi les déplacer ailleurs et mettre des liens symboliques. Mais où ? Dans /usr/scripts/wiki/theme ou ailleurs ?
ils y sont déjà -- GregoireDetrez 2006-04-25 23:10:21
Comment dumper le wiki
Il est possible de publier des pages du wiki sous forme /statique/ comme on en trouve ici.
Lorsqu'une modification est faite sur les pages du wiki, il faut mettre à jour les pages statiques correspondantes.
Cette manipulation se fait à l'aide du script dump-wiki.py situé dans /usr/scripts/wiki.
Pour l'exécuter :
- On commence par se logguer sur rouge (c'est à peu près la seule machine sur laquelle il veut bien s'exécuter).
On crée un répertoire temporaire destiné à accueillir les futures pages statiques générées (par exemple dans son home ~/dump_temp).
- On peut ensuite lancer le script en lui passant comme arguments, le nom des pages sous forme d'expression régulière et le répertoire de destination des pages statiques. Ex :
sudo python /usr/scripts/dump-wiki.py --regex 'WiFi(/PositionnementDesBornes|/AvoirLeWifi.*)?' ~/dump_temp
Les pages générées seront dans le répertoire ~/dump_temp/wiki et les pièces jointes correspondantes seront dans le répertoire ~/dump_temp/attach. ![/!\](/wiki/memodump/img/alert.png "/!\"){kind=small}
Ne pas oublier de créer ces répertoires.
La dernière étape consiste à mettre les fichiers générés (donc les répertoires wiki et attach) sur ragnarok dans le répertoire : /var/www/wifi