Installation
administrateurs (basique) Cette page explique comment télécharger et installer PmWiki. Voici une liste des pages associées :
- Besoins système - Pré-requis techniques pour installer PmWiki.
- Mise à jour - Comment mettre à jour une installation existante.
- Fermes Wiki - Faire fonctionner plusieurs Wiki à partir d'une même installation.
- ChangeLog - Nouvelles fonctions et correction d'erreurs disponibles (en anglais).
Des améliorations à ces instructions sont toujours appréciées. En cas de problèmes, retourner l'information (en anglais ou sur la liste française) sur la liste de diffusion ou sur le système de suivi d'erreur.
1. Télécharger
Téléchargez la dernière version de PmWiki depuis http://www.pmwiki.org/pub/pmwiki ou directement la version zip archive ou tgz tarball.
2. Décompresser
Décompressez l'archive. Un répertoire pmwiki-x.y.z contenant le logiciel PmWiki sera créé. Ce répertoire contient les fichiers suivants:
README.txt Un court fichier d'introduction
local/ Répertoire des fichiers de configuration locale
pmwiki.php Code principal de PmWiki
pub/ Répertoire des fichiers à accès public
css/ Répertoire des fichiers .css génériques
skins/ Répertoire des Thèmes
guiedit/
sample-config.php Un exemple de fichier de configuration
scripts/ Scripts étendant les fonctionnalités de PmWiki
wikilib.d/ Répertoire des pages par défaut de PmWiki
cookbook/ Répertoire des compléments de configuration
Ces fichiers doivent être situés dans un endroit accessible par le serveur web (par exemple dans un répertoire du genre public_html). Peu importe comment les fichiers sont installés dans ce répertoire -- Directement par une commande système ou via un transfert FTP.
Note : c'est probablement une bonne idée de renommer le répertoire pmwiki-x.y.z en pmwiki.
3. Créer les répertoires
La plupart du temps, PmWiki fait cela pour vous.
Ouvrez le fichier pmwiki.php sur le serveur Internet avec un navigateur (ne l'ouvrez pas directement depuis le fichier local ou via un lien file://.. URL). PmWiki fera alors une analyse de la configuration de votre système et cherchera à créer le répertoire wiki.d/, en vous donnant des instructions pour cela. Ce répertoire contiendra les pages qui seront créées sur votre site. Couramment il y a deux manières de procéder :
"chmod 777 wiki.d")
"chmod 2777 ." (noter le point à la fin). La commande chmod fonctionne aussi dans nombre de programme FTP. Créer le répertoire de cette manière (1) rendra le répertoire accessible en écriture au serveur web qui pourra alors créer le répertoire dont il a besoin pour stocker les fichiers wiki, et (2) préservera la propriété de groupe du répertoire, permettant au compte "installateur" de manipuler les fichiers ainsi créés et (3) augmentera la difficulté pour d'autres comptes du serveur d'accéder aux fichiers du répertoire wiki.d/ (pour une question de sécurité).
Après avoir établi les droits du répertoire, essayer d'accéder à nouveau au fichier pmwiki.php. Si tout va bien, le répertoire wiki.d/ sera créé et vous pourrez accéder à la page par défaut. Si tout fonctionne, rétablir les priorités du répertoire contenant pmwiki.php (normalement 755), et vérifier à nouveau que tout fonctionne.
4. Initialiser
Consultez la section Configuration initiale pour commencer la personnalisation de votre installation PmWiki. Lisez attentivement également les Notes de versions pour avoir des informations supplémentaires.
5. Etablir la version Française
Si vous souhaitez utiliser une version de PmWiki dans une autre langue que l'anglais, téléchargez le module de langue archivé au format zip (i18n/i18n-fr.zip) depuis http://www.pmwiki.org/pub/pmwiki/. Ensuite copiez les fichiers de votre version nationale dans le répertoire wikilib.d/ comme décrit plus haut.
Il y a deux répertoires comprimés dans les archives 'i18n', scripts et wikilib.d. Copiez les fichiers dans leurs répertoires respectifs de votre installation. Par exemple, pour une localisation en Français, PmWikiFr.* and PmWiki.* doivent être contenus dans le même répertoire.
Ensuite, validez la localisation en ajoutant une instruction au fichier local/config.php pour charger la page de traduction. Par exemple, XLPage('fr','PmWikiFr.XLPage'); charge la page de langue du Français PmWikiFr.XLPage.
Si vous utilisez UTF-8 (conseillé dans les nouvelles installations), il faut placer l'instruction XLPage() après la ligne
include_once("scripts/xlpage-utf-8.php");
qu'il ne faudra pas oublier de décommenter si vous utilisez le fichier sample-config.php comme base pour le fichier de configuration.
En savoir plus avec Internationalisation et l'exemple de fichier de configuration.
Notes
- La distribution de PmWiki ne comprend volontairement pas de fichier index.php. Résistez à la tentation de renommer pmwiki.php en index.php parce que si vous renommez le fichier il ne sera pas modifié lors d'une mise à jour. A la place, ajoutez un script index.php qui comportera une seule ligne (sans la balise de cloture "
?>"):<?php include_once('pmwiki.php'); - Si vous utilisez la commande Unix tar pour décompacter l'archive lors de l'étape 2 ci-dessus, assurez vous que les fichiers sont créés avec des droits d'accès suffisants pour permettre l'accès du serveur Internet. Normalement vous pouvez le faire en tapant
umask 002sur la ligne de commande avant de décompacter l'archive tar. - Sur une installation système Windows, il faut aller voir la page Cookbook:SimultaneousEdits (en anglais) pour valider les Éditions simultanées sur ce système.
- On trouve des compléments d'informations (en anglais) à la page Troubleshooting.
<< Supprimer une page | Index de la documentation | Configuration initiale >>
Traduction de PmWiki.Installation
Page originale sur PmWikiFr.Installation - Backlinks
Dernières modifications:
PmWikiFr.Installation: September 15, 2013, at 05:36 AM MDT
PmWiki.Installation: January 21, 2020, at 09:53 PM MST