====== DokuWiki ======

===== Installation - 2012 =====

En quête d'un blog documentaire, je suis interessé d'essayer: [[http://www.dokuwiki.org/plugin:blogtng|BlogTNG Plugin]]

Donc, d'abord vérifier qu'on va installer une version de DokuWiki compatible...
  2012-01-25 "Angua" yes
  ...

==== download et untar ====

(as root)
  cd /var/www
  wget http://www.splitbrain.org/_media/projects/dokuwiki/dokuwiki-2012-01-25.tgz
  tar -xvzf dokuwiki-2012-01-25.tgz
Répertoire "dokuwiki-2012-01-25" créé avec un curieux propiétaire:
  mv dokuwiki-2012-01-25 dokuwiki

==== permissions ====
Avant d'être plus précis:
  chown -R www-data: dokuwiki
  chmod -R a-w dokuwiki
 
  chmod -R ug+w dokuwiki/data/
  chmod -R ug+w dokuwiki/lib/plugins/
  chmod ug+w dokuwiki/conf/


==== VirtualHost Apache2 ====

  <VirtualHost *:80>
        ServerAdmin <YOUR_EMAIL>
        ServerName <YOUR_SERVER_NAME>
  
        DocumentRoot /var/www/dokuwiki
  
        <Directory />
                Options FollowSymLinks
                AllowOverride None
                Order deny,allow
                deny from all
        </Directory>
  
        ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
        <Directory "/usr/lib/cgi-bin">
                AllowOverride None
                Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
                Order allow,deny
                Allow from all
        </Directory>
  
        <Directory /var/www/dokuwiki/>
                #DirectoryIndex index.php
                Options +FollowSymLinks -Indexes
                AllowOverride FileInfo
  
                Order allow,deny
                allow from all
  
                AddHandler cgi-php5 .php
                Action cgi-php5 /cgi-bin/php5
        </Directory>
  
        # Ceinture et bretelles: car normalement, les ".htaccess" font leur travail
        # mais je suis paranoïaque:
        <LocationMatch "/(data|conf|bin|inc)/">
          Order allow,deny
          Deny from all
          Satisfy All
        </LocationMatch>
          
        ErrorLog ${APACHE_LOG_DIR}/error.log
  
        # Possible values include: debug, info, notice, warn, error, crit,
        # alert, emerg.
        LogLevel warn
  
        CustomLog ${APACHE_LOG_DIR}/access.log combined
  
  </VirtualHost>
  
==== Sécurité ====

Ceci ne devrait pas fonctionné: http://YOUR_WIKI_LINK/data/pages/wiki/dokuwiki.txt

Sinon, il y a un problème de droit a corrigé comme indiqué ici: http://www.dokuwiki.org/security#web_access_security

FIXME : http://www.dokuwiki.org/tips:httpslogin

==== installer ====

Par là, donc: http://YOUR_WIKI_LINK/install.php

Pour ma part: 
  Initial ACL policy: Public Wiki


==== dokuwiki as blog ====


Installer le template qui va bien: http://www.dokuwiki.org/template:mnml-blog

Installer quelques plugins recommandé:
  *captch: http://www.dokuwiki.org/plugin%3Acaptcha
  *video share: http://www.dokuwiki.org/plugin%3Avshare
  *gallery http://www.dokuwiki.org/plugin%3Agallery

==== Misc ====

=== Permalink ===

FIXME

=== https ===

Lien: http://www.dokuwiki.org/tips:httpslogin

FIXME

===== plugin ditaa =====

Lien: http://www.dokuwiki.org/plugin:ditaa

Pour dessiner des graphs dans dokuwiki...

===== Rechercher =====
Lien: http://www.dokuwiki.org/cli

Aprés un déménagement, et un coup de "rsync", la fonction "Rechercher" renvoit trop de peu de résultat...

Il faut mettre a jour l'index pardi! (ce n'est pas nécessaire en temps normal)

Donc, j'ai fait:\\
Devenir le user "www-data" (?)
  $ su
  # su www-data
Et puis dans: **''/usr/share/dokuwiki/bin''** \\
Executer:
  /usr/bin/php indexer.php -c
Le "-c" force a effacer d'abord l'index existant... (sinon, ca sert pas a grand chose)

===== Restrictions =====

==== Interdire l'accès aux dernières modifications ====
Il faut éditer le code php pour restreindre l'accès d'une façon qui n'est pas prévu initialement...\\
== Editer ==
<code>
# cd /usr/share/dokuwiki/inc
# vi actions.php
</code>
Trouver la fonction **act_permcheck** qui me semble definir les droits en fonctions de l'action... Nous allons restreindre les actions **diff** et **revisions** aux utilisateurs ayant le droit d'ecrire.
== Inserer le code ==
<code>
...
  }elseif(in_array($act,array('login','search','recent','profile'))){
    $permneed = AUTH_NONE;
  /* ==TJ== ===================================== debut insertion*/
  }elseif(in_array($act,array('diff','revisions'))){
    $permneed = AUTH_WRITE;
  /* ==TJ== ===================================== fin insertion */
  }elseif($act == 'register'){
...
</code>
En clair: on force le droit minimum **WRITE** pour utiliser les actions sus-nommées.\\
Sinon, par défaut, le code réclame simplement le droit **READ** ... :-| !

===== Conversions PmWiki vers DokuWiki =====
Rien de plus simple !

On va sur ce site, et on copy, paste, click, copy, paste: http://diberri.dyndns.org/html2wiki.html