Voici quelques instructions rapides sur comment télécharger et installer PmWiki. Des améliorations à ces instructions seraient grandement appréciées. En cas de problèmes, retourner l'information (en anglais) sur la liste de diffusion ou sur le système de suivi d'erreur.

1. Téléchargez la dernière version de PmWiki depuis http://www.pmichaud.com/pub/pmwiki ou directement la version zip archive ou tgz tarball.

2. Décompressez l'archive. Un répertoire pmwiki-x.y.z contenant le logiciel PmWiki sera créé. Ce répertoire contient les fichiers suivants: 

    COPYING           La License publique Générale GNU
    README            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 modèles de mises en page
    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éfault de PmWiki
    cookbook/         Répertoire des compléments de configuration

3. 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.

4. 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 :

4a. Vous pouvez créer le répertoire manuellement, et ensuite lui donner tous les droits d'écriture (c.a.d. 777 ou rxwrxwrxw, sous Unix par "chmod 777 wiki.d")

4b. Sur d'autres systèmes vous pouvez laisser PmWiki créer le répertoire en changeant provisoirement les droits du répertoire principal en 2777. Sous Unix cela se fait en allant sur le répertoire contenant le fichier pmwiki.php et en faisant "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ées 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é).

5. 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.

6. Consultez la section Configuration initiale pour commencer la personnalisation de votre installation PmWiki. Lisez attentivement également les notes de versions pour des informations supplémentaires.

7. Pour une installation en Français, voir la page Internationalisation et l'exemple de fichier de configuration.

Notes

  • 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 002 sur la ligne de commande avant de décompacter l'archive tar.

<< Besoins système | Index doc admin | Configuration initiale >>

Traduction de PmWiki:Installation - page originale sur PmWiki:PmWikiFr.Installation - révisée en version 2