Ajout : Savoir-faire : Installer_IkiWiki_sur_sa_propre_machine.
authorJulien Moutinho <julm@cyclocoop.org>
Mon, 31 Mar 2014 12:18:47 +0000 (14:18 +0200)
committerJulien Moutinho <julm@cyclocoop.org>
Mon, 31 Mar 2014 15:48:02 +0000 (17:48 +0200)
Savoir-faire/Informatique/CycloWiki/IkiWiki.mdwn
Savoir-faire/Informatique/CycloWiki/IkiWiki/Installer_IkiWiki_sur_sa_propre_machine.mdwn [new file with mode: 0644]
ikiwiki.setup

index b3f31f0..a35f576 100644 (file)
@@ -23,7 +23,7 @@ qui permet de faire ce CycloWiki.
   ce qui a permis que l´on se fasse des calendriers et des sondages dans [[/Agenda]].
 
 ## Installation
-Il est possible d'installer IkiWiki sur sa propre machine,
+Il est possible d’[[Installer_IkiWiki_sur_sa_propre_machine]],
 et d´y faire tourner une instance de ce CycloWiki en toute autonomie,
 puis de la synchroniser avec l'instance en ligne à <https://wiki.cyclocoop.org>,
 cependant cela demande un travail qui n’est pas forcément nécessaire pour nous,
diff --git a/Savoir-faire/Informatique/CycloWiki/IkiWiki/Installer_IkiWiki_sur_sa_propre_machine.mdwn b/Savoir-faire/Informatique/CycloWiki/IkiWiki/Installer_IkiWiki_sur_sa_propre_machine.mdwn
new file mode 100644 (file)
index 0000000..a80e1c8
--- /dev/null
@@ -0,0 +1,64 @@
+[[!sidebar var=TOC content="""**Sommaire** [[!toc levels=3]]"""]]
+
+# Procédure initiale
+
+## Installation des dépendences
+Sous [Debian](https://www.debian.org/)
+ [Wheezy](https://wiki.debian.org/fr/DebianWheezy) :
+
+       % sudo apt-get install \
+        ikiwiki \
+        libcgi-formbuilder-perl \
+        libcgi-perl \
+        libcgi-session-perl \
+        libdata-dumper-perl \
+        libdate-parse-perl \
+        libemail-folder-perl \
+        libemail-mime-perl \
+        libemail-thread-perl \
+        libfile-mimeinfo-magic-perl \
+        libhtml-parser-perl \
+        libhtml-scrubber-perl \
+        libhtml-template-perl \
+        libmail-sendmail-perl \
+        libsearch-xapian-perl \
+        libtext-markdown-perl \
+        libtext-multimarkdown-perl \
+        liburi-perl \
+        libxml-simple-perl \
+        thttpd \
+        xapian-omega
+
+# Construction du rendu du wiki
+       % ikiwiki --rebuild --verbose --no-rcs --wrappers \
+        --setup ~/SparkleShare/cyclowiki/ikiwiki.setup
+       # NOTE: le rendu se fait dans ~/SparkleShare/cyclowiki-www/
+
+# Création d'un compte
+       % www-browser 'http://localhost/cgi/ikiwiki.cgi?do=prefs'
+
+# Procédure d’utilisation
+
+## Lancer un serveur Web
+       % sudo thttpd -D -u $USER -h localhost -p 80 -T UTF-8 -l /dev/stderr -c '/cgi/*.cgi' \
+        -d ~/SparkleShare/cyclowiki-www
+       # NOTE: sudo est nécessaire pour acquérir le port 80 (< 1024)
+       #       lui même nécessaire car thttpd ne respecte pas la RFC 3875 :
+       #       http://ikiwiki.info/bugs/Running_on_an_alternative_port_fails/
+
+## Rafraîchir le rendu du wiki
+       % ikiwiki --refresh --verbose --no-rcs --wrappers \
+        --setup ~/SparkleShare/cyclowiki/ikiwiki.setup
+
+## Consulter ou modifier les sources du wiki
+
+### via le Web
+       % www-browser 'http://localhost'
+
+### via des éditeurs
+       % $EDITOR ~/SparkleShare/cyclowiki/$page.mdwn
+       # NOTE: $EDITOR étant votre éditeur de texte préféré,
+       #       par exemple [Gedit](https://en.wikipedia.org/wiki/Gedit)
+
+# Stopper le serveur Web
+       % sudo pkill thttpd
index 75ac86f..91dbeb1 100644 (file)
@@ -34,7 +34,7 @@ BEGIN {
                $account_creation_password = IkiWiki::readfile(catdir(dirname($srcdir), 'etc', 'account_creation_password'));
         }
        else {
-               $destdir   = catdir(dirname($srcdir).'/www');
+               $destdir   = $srcdir.'-www';
                $sslcookie = 0;
                $umask     = 002;
                $url       = '/';