Taille: 3380
Commentaire:
|
Taille: 3839
Commentaire: wiki-dumps
|
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. Cela 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 |
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 }}} |
Ligne 9: | Ligne 13: |
#### FIN DU HACK }}} |
{{{ #### FIN DU HACK }}} Les patchs sont regroupés sur [[/LesPatchs|cette page]] |
Ligne 13: | Ligne 19: |
Ces éléments sont stockées dans dans leur répertoire respectif dans {{{/usr/scripts/wiki}}} | 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}}} |
Ligne 15: | Ligne 21: |
== Création de macro == Toutes les macro ont une fonction principale execute(macro,arg). arg est l'argument donné à la macro. macro.formatter (f) permet de créer le code correspondant à ce que l'on veut afficher à l'aide de la méthode: |
## <<Include(/CréationDeMacro,"Création de macros", 2, from="[[[TableOfContents]]]", to="Exemple")>> |
Ligne 18: | Ligne 23: |
* {{{code=f.text(u"bonjour") }}} [[help(text(u"bonjour"))]] |
== Création de parseur == |
Ligne 22: | Ligne 25: |
Beaucoup de méthodes s'utilisent par paire: *{{{code=f.strong(1) code+=f.text(u"bonjour") code+=f.strong(0)}}} [[help(strong(1),text(u"bonjour"),strong(0))]] |
== Création de formatter == /CréationDeFormatter |
Ligne 29: | Ligne 28: |
*{{{code=f.underline(1) code+=f.text(u"bonjour") code+=f.underline(0)}}} [[help(underline(1),text(u"bonjour"),underline(0))]] |
= 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. |
Ligne 34: | Ligne 31: |
*{{{code=f.highlight(1) code+=f.text(u"bonjour") code+=f.highlight(0)}}} [[help(highlight(1),text(u"bonjour"),highlight(0))]] *{{{code=f.emphasis(1) code+=f.text(u"bonjour") code+=f.emphasis(0)}}} [[help(emphasis(1),text(u"bonjour"),emphasis(0))]] *{{{code=f.number_list(1) code+=f.listitem(1) code+=f.text(u"bonjour") code+=f.listitem(0) code+=f.listitem(1) code+=f.text(u"bonjour") code+=f.listitem(0) code+=f.number_list(0)}}} [[help(number_list(1),listitem(1),text(u"bonjour"),listitem(0),listitem(1),text(u"bonjour"),listitem(0),number_list(0))]] *{{{code=f.bullet_list(1) code+=f.listitem(1) code+=f.text(u"bonjour") code+=f.listitem(0) code+=f.listitem(1) code+=f.text(u"bonjour") code+=f.listitem(0) code+=f.bullet_list(0)}}} [[help(bullet_list(1),listitem(1),text(u"bonjour"),listitem(0),listitem(1),text(u"bonjour"),listitem(0),bullet_list(0))]] *{{{code=f.text(u"bon") code+=f.sup(1) code+=f.text(u"jour") code+=f.sup(0)}}} [[help(text(u"bon"),sup(1),text(u"jour"),sup(0))]] *{{{code=f.text(u"bon") code+=f.sub(1) code+=f.text(u"jour") code+=f.sub(0)}}} [[help(text(u"bon"),sub(1),text(u"jour"),sub(0))]] *{{{code = f.table(1) code += f.table_row(1) code += f.table_cell(1) code += f.text(u"bonjour") code += f.table_cell(0) code += f.table_row(0) code = f.table(0)}}} [[help(table(1),table_row(1),table_cell(1),text(u"bonjour"),table_cell(0),table_row(0),table(0))]] |
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}}} |
Ligne 86: | Ligne 34: |
= Ajout de thème = La partie en python s'occupant de la mise en forme est stockée dans {{{/usr/scripts/wiki/theme}}} |
= Comment dumper le wiki = |
Ligne 89: | Ligne 36: |
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 ? |
== La solution actuellement en place == 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}}} == Ce qu'il faudrait faire... == === ...maintenant qu'on a une version plus récente de moinmoin... === ==== ...et que le wiki n'est plus sur rouge: ==== {{{ sudo -u www-data moin \ --config-dir=/etc/moin --wiki-url=http://wiki.crans.org/ \ export dump \ --page "WiFi(/PositionnementDesBornes|/AvoirLeWifi.*)?" \ --target-dir=/home/myname/outputdir }}} Il suffit ensuite de coller les fichiers générés sur ragnarok dans {{{/var/www/wifi}}} (bon, il faut cronner ça) |
Ligne 92: | Ligne 66: |
["CatégorieCrans/PageNonTerminée"] : il serait bon de lui ajouter les patchs actuels et intégrer cette page à VieWiki pour la rendre accessible simplement | 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
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
La solution actuellement en place
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. 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
Ce qu'il faudrait faire...
...maintenant qu'on a une version plus récente de moinmoin...
...et que le wiki n'est plus sur rouge:
sudo -u www-data moin \ --config-dir=/etc/moin --wiki-url=http://wiki.crans.org/ \ export dump \ --page "WiFi(/PositionnementDesBornes|/AvoirLeWifi.*)?" \ --target-dir=/home/myname/outputdir
Il suffit ensuite de coller les fichiers générés sur ragnarok dans /var/www/wifi
(bon, il faut cronner ça)