WikiTech | GSSA / PmWiki

Vous êtes dans un espace restreint en écriture. << | PmWiki | PmWiki - Modèles >>

PmWiki est un système de type wiki, comme tant d'autre [1]., ayant les caractéristiques intéressantes pour nous comme pouvoir gérer une Ferme de wikis, pas de base de données, ACL avec un LDAP possible.

URL: http://www.pmwiki.org
Langage: PHP
Type: wiki, Ferme de wiki, sans BDD, simple

Pages WikiTrail

(:numbered-sections format=0.A.1.a.1.1.1:)

Présentation générale

Groupe, ou espace

L'adresse d'une page est de la forme Group.Name.

Où Group est son groupe wiki et Name est le nom de la page de ce groupe.

Par défaut, il existe plusieurs groupes : Main (le groupe par défaut), PmWiki (la documentation) et Site (l'espace de configuration du wiki).

Chaque groupe a des pages spéciales :

GroupHeader: entête du groupe
GroupFooter: pied de page
GroupAttributes: les droits (read, edit …) du groupe

Prérequis

Il faut un serveur web (apache, nginx) et php5

Serveur nginx avec PHP5

Pour le PHP5 j'utilise php-fpm. D'autres possibilités nginx - PHP via FastCGI [2] sont possibles.

installer les services (Ici Debian):

(:source lang=bash:) apt-get install nginx php5-fpm

Le fichier /etc/nginx/nginx.conf minimun pour activer le PHP5 est

(:source:) http { server { [...] location ~ .php$ { fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include /etc/nginx/fastcgi_params; }

et prise en compte de $DocumentRoot:

(:source:) http { server { [...] root /var/www/wiki

lancer le service php5-fpm

Installation de PmWiki

Note: On suppose dans la suite que $DocumentRoot, le répertoire des pages webs, est /var/www/wiki et que le wiki est accessible à l'URL http://srv/pmwiki

télécharger la derniere version dans $DocumentRoot (la 2.2.65 en juin 2014):

(:source lang=bash:) cd $DocumentRoot wget http://www.pmwiki.org/pub/pmwiki/pmwiki-2.2.65.tgz wget http://www.pmwiki.org/pub/pmwiki/pmwiki-2.2.65.md5 md5sum -c pmwiki-2.2.65.md5 tar xfz pmwiki-2.2.65.tgz ln -s pmwiki-2.2.65 pmwiki

créer le repertoire des pages du wiki:

(:source lang=bash:) cd pmwiki mkdir wiki.d chmod 777 wiki.d

lancer un navigateur sur la page http://srv/pmwiki/pmwiki.php et suivez il devrait faire le nécessaire. Suivre également la Configuration initiale.

version française

Pour ajouter le français, il faut:

prendre la version dans http://www.pmwiki.org/pub/pmwiki/:

(:source lang=bash:) wget http://www.pmwiki.org/pub/pmwiki/i18n/i18n-fr.zip mkdir i18n-fr unzip -d i18n-fr i18n-fr.zip

et installer la version UTF-8 (fichier PmWikiFr.*):

(:source lang=bash:) cd i18n-fr/wikilib.d cp -i * ../../../wikilib.d/

activer la langue dans local/config.php, après include_once("scripts/xlpage-utf-8.php");:

(:source lang=bash:) include_once("scripts/xlpage-utf-8.php"); XLPage('fr','PmWikiFr.XLPage');

FIXME : Pour la version française le lien Changements récents, en haut des pages, ne fonctionne pas.

Configuration de PmWiki

Configuration locale

Liste d'options utiles à activer dans local/config.php:

titre et logo:

(:source lang=php:) $WikiTitle = "My New Wiki"; $PageLogoUrl = "http://example.com/mylogo.gif";

mot de passe admin (et autres) : cf #Mot de passes
upload images:

(:source lang=php:) $EnableUpload = 1; $UploadMaxSize = 2000000; $DefaultPasswords['upload'] = crypt('secrettwo');

rendre obligatoire le champs auteur lors d'une édition:

(:source lang=php:) $EnablePostAuthorRequired = 1;

changer le groupe par défaut (Main), par exemple pour Wikitech:

(:source lang=php:) $DefaultGroup = 'Wikitech';

Mot de passes

Par défaut, PmWiki est un système à mot de passe.

Un mot de passe peut être appliqué à un objet tel que:

une page
un groupe wiki
ou tout le site.

Un mot de passe peut être appliqué sur différents droits:

read pour lire une page, un groupe wiki ou tout le site
edit pour modifier un objet
attr pour changer les mots de passes d'un objet
upload pour attacher un fichier

Changer les mots de passes

Les mots de passe d'une page se changent en allant à l'URL: <url de la page>?action=attr
Les mots de passe d'un groupe : <url du groupe>.GroupAttributes?action=attr
Les mots de passe du site se changent dans le fichier local/config.php:

(:source lang=php:) $DefaultPasswords['read'] = array(crypt('alpha'), crypt('beta')); $DefaultPasswords['edit'] = crypt('edit_password'); $DefaultPasswords['attr'] = crypt('anotherpwd'); $DefaultPasswords['upload'] = crypt('givememore');

Les mot de passe admin est défini dans local/config.php:

(:source lang=php:) $DefaultPasswords['admin'] = crypt('secret_password');

Priorité des mots de passe

Dans PmWiki, les mots de passe de page ont priorité sur les mots de passe de groupe, les mots de passe de groupe ont priorité sur les mots de passe par défaut, et les mots de passe de type admin ont priorité sur tous les autres:

 admin > page > group > default

LDAP

voir PmWiki - Configuration locale [2]

Exemples de configuration

Un exemple de configuration de base: (:source lang=php:) <?php $WikiTitle = "My New Wiki"; $PageLogoUrl = "http://example.com/mylogo.gif"; // upload $EnableUpload = 1; $UploadMaxSize = 2000000; $DefaultPasswords['upload'] = crypt('secrettwo'); ?>

<< | PmWiki | PmWiki - Modèles >>