471b28f4cc3275318752a14c2aebe82554cd9bb1
[cyclowiki.git] / Savoir-faire / Cyberautonomie / CycloWiki / IkiWiki / Installer_IkiWiki_sur_sa_propre_machine.mdwn
1 [[!sidebar var=TOC content="""**Sommaire** [[!toc levels=3]]"""]]
2
3 # [[Savoir-faire]] requis
4 * [[SparkleShare]]
5 ou [Git](http://git-scm.com/) directement.
6
7 # Procédure initiale
8
9 ## Installation des dépendances
10
11 **NOTE** : cette procédure est pour [Debian](https://www.debian.org/)
12 [Wheezy](https://wiki.debian.org/fr/DebianWheezy).
13
14 Installe le dépôt de [Squeeze](https://wiki.debian.org/fr/DebianSqueeze)
15 pour <code>thttpd</code> :
16
17 % sudo tee /etc/apt/sources.list.d/squeeze.list <<EOF
18 deb http://ftp.fr.debian.org/debian squeeze main
19 EOF
20 % sudo apt-get update
21
22 Installe [[IkiWiki]]
23 et les dépendances des modules que nous utilisons :
24
25 % sudo apt-get install \
26 ikiwiki \
27 gcc \
28 libcgi-formbuilder-perl \
29 libcgi-session-perl \
30 libdatetime-perl \
31 libemail-folder-perl \
32 libemail-mime-perl \
33 libemail-thread-perl \
34 libfile-mimeinfo-perl \
35 libhtml-parser-perl \
36 libhtml-scrubber-perl \
37 libhtml-template-perl \
38 libmail-sendmail-perl \
39 libsearch-xapian-perl \
40 libtext-markdown-perl \
41 libtext-multimarkdown-perl \
42 libtimedate-perl \
43 liburi-perl \
44 libxml-simple-perl \
45 thttpd \
46 xapian-omega
47
48 ## Mise-à-jour des sous-modules [Git](http://git-scm.com/) pour [[Savoir-faire/Cyberautonomie/CycloWiki/IkiWiki]]
49 % cd ~/SparkleShare/cyclowiki/
50 % git submodule update --init --recursive
51
52 ## Construction du rendu de l’[[IkiWiki]]
53 % ikiwiki --rebuild --verbose --wrappers \
54 --setup ~/SparkleShare/cyclowiki/ikiwiki.setup --no-rcs
55
56 **NOTE** : le rendu se fait dans <code>~/SparkleShare/cyclowiki-www/</code>
57
58 ## Création d'un compte
59 Se rendre sur <http://localhost/cgi/ikiwiki.cgi?do=prefs>
60 et se [[Savoir-faire/Cyberautonomie/CycloWiki/Créer_un_compte_de_camarade]].
61
62 **NOTE** : en local la phrase-de-passe de création de compte est vide.
63
64 # Procédure d’utilisation
65
66 ## Lancer un serveur Web
67 % sudo thttpd -D -u $USER -h localhost -p 80 -T UTF-8 -l /dev/stderr -c '/cgi/*.cgi' \
68 -d ~/SparkleShare/cyclowiki-www
69
70 **NOTE** : <code>sudo</code> est nécessaire pour acquérir le port <code>80</code> (< <code>1024</code>)
71 lui même nécessaire car <code>thttpd</code> ne respecte pas la [RFC 3875](http://ikiwiki.info/bugs/Running_on_an_alternative_port_fails/)
72
73 ## Rafraîchir le rendu du wiki
74 % ikiwiki --refresh --verbose --wrappers \
75 --setup ~/SparkleShare/cyclowiki/ikiwiki.setup --no-rcs
76
77 ## Consulter ou modifier les sources du wiki
78
79 ### Via le Web
80 Se rendre sur <http://localhost/>.
81
82 ### Via un éditeur
83 % $EDITOR ~/SparkleShare/cyclowiki/$page.mdwn
84
85 **NOTE** :
86
87 * <code>$EDITOR</code> étant votre éditeur de texte préféré
88 par exemple [Gedit](https://en.wikipedia.org/wiki/Gedit).
89 * <code>$page</code> étant le chemin vers une page du wiki.
90
91 # Stopper le serveur Web
92 % sudo pkill thttpd