|
Taille: 698
Commentaire:
|
Taille: 3300
Commentaire: \begin{doc}
|
| Texte supprimé. | Texte ajouté. |
| Ligne 1: | Ligne 1: |
| ## page was renamed from CransNousnous/DocumentationWikiCrans | |
| Ligne 3: | Ligne 4: |
| <<TableOfContents>> |
|
| Ligne 4: | Ligne 7: |
| On retrouve dans /usr/scripts/wiki des liens symboliques vers des fichiers de MoinMoin. Celà nous permet d'identifier les fichiers modifiés et de les ajouter au CVS. | On retrouve dans {{{/usr/scripts/wiki-lenny/share}}} les fichiers de moinmoins que nous avons modifiés nous-mêmes. Pour qu'ils soient utilisés on supprime 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-lenny/share}}}. 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. |
| Ligne 6: | Ligne 9: |
| Les fichiers qui s'y trouvent sont commités en version 1.1 avec la source originale correspondant à la version {{{1.3.4-3}}} . Les diffs suivants correspondent à nos modifications propres. Les lignes modifiées sont repérables avec les balises {{{#### HACK SAUVAGE}}} et {{{#### FIN DU HACK}}} | 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 {{{ #### FIN DU HACK }}} |
| Ligne 8: | Ligne 16: |
| = Ajout de macro = Elles sont stockées dans /usr/scripts/wiki/macro |
Les patchs sont regroupés sur [[/LesPatchs|cette page]] = Ajout de macro/parser/formatter = Parce qu'on aime pimper le wiki, on a rajouter quelques autres formatters et des macros, qui sont stockés dans {{{/usr/scripts/wiki-lenny/local}}} et qu'il faut installer dans {{{/var/local/wiki/data/plugins}}} <<Include(/CréationDeMacro,"Création de macros", 2, from="[[[TableOfContents]]]", to="Exemple")>> == Création de parseur == == Création de formatter == /CréationDeFormatter |
| Ligne 12: | Ligne 29: |
| La partie en python s'occupant de la mise en forme est stockée dans {{{/usr/scripts/wiki-lenny/plugins/theme}}}, en effet nos themes persos sont bien des plugins du wiki. Les éléments graphiques (css et images) sont eux stockés (enfin, c'est vite dit vu le bordel que c'est) dans {{{/usr/scripts/wiki-lenny/static}}} = Comment dumper le wiki = Il est possible de publier des pages du wiki sous forme /statique/ comme on en trouve [[https://wifi.crans.org/wiki/WiFi.html|ici]].<<BR>> Lorsqu'une modification est faite sur les pages du wiki, il faut mettre à jour les pages statiques correspondantes.<<BR>> Cette manipulation se fait à l'aide du script {{{dump-wiki.py}}} situé dans {{{/usr/scripts/wiki}}}.<<BR>> 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}}}. /!\ Ne pas oublier de créer ces répertoires.<<BR>> 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}}} ---- CatégoriePagePublique |
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-lenny/share les fichiers de moinmoins que nous avons modifiés nous-mêmes. Pour qu'ils soient utilisés on supprime 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-lenny/share. 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.
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
#### FIN DU HACK
Les patchs sont regroupés sur cette page
Ajout de macro/parser/formatter
Parce qu'on aime pimper le wiki, on a rajouter quelques autres formatters et des macros, qui sont stockés dans /usr/scripts/wiki-lenny/local et qu'il faut installer dans /var/local/wiki/data/plugins
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-lenny/plugins/theme, en effet nos themes persos sont bien des plugins du wiki.
Les éléments graphiques (css et images) sont eux stockés (enfin, c'est vite dit vu le bordel que c'est) dans /usr/scripts/wiki-lenny/static
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