PmWiki est un système de type wiki pour la création et l'entretien collectif de sites Internet.
Les pages PmWiki ont le même aspect et fonctionnent comme des pages Internet ordinaires, sauf qu'elles possèdent un lien pour « Éditer » ce qui permet de modifier ou d'ajouter facilement des pages à un site, en utilisant les règles d'édition de base (tout comme le fait le site http://fr.wikipedia.org)
Basé sur PmWiki, ce système contient quelques-unes des extensions les plus pratiques et une syntaxe simplifiée.
La page d'accueil et le code mis à jour sont à cette adresse :
http://pmwiki-efo.googlecode.com
On this page... (hide)
L'édition des pages peut être réalisée par plusieurs auteurs. Pour éditer une page, cliquez simplement sur « Éditer » qui existe quelque part dans la page, habituellement dans l'en-tête ou le pied de page. Quelques pages peuvent être protégées par mot de passe, en fonction de la politique de sécurité, mais beaucoup de sites permettent la libre édition de pages.
Le mot de passe par défaut de cette version du wiki est « pmwiki ». Il est conseillé de le modifier par la suite, après installation (voir plus bas).
Lorsque vous éditez une page, vous voyez les balises qui décrivent le contenu de la page. Le rendu final, avec le formatage choisi, ne s'affiche que lorsque la page en enregistrée.
Les règles de base pour le balisage de la page sont très simples :
- pour une liste avec des puces ou + pour une liste numérotée.
== titre d'importance principale == ou === titre d'importance secondaire == .
//texte// pour la mise en italique ou **texte** pour la mise en gras.
[[nouvelle page]] crée un lien vers cette page. Un lien vers une page inexistante? est affiché de façon différente, pour inviter d'autres à créer la page.
[description du site http://www.site.com]
[fichier pdf local://../../docs/pmwiki-efo.pdf]
Ce qui donne :
Il faut rajouter le ../../ pour remonter de 2 niveaux dans l'arborescence si dans local/config.php on a $EnablePathInfo = 1;
Sinon c'est [fichier pdf local://docs/pmwiki-efo.pdf]
Mais le plus simple, est d'utiliser la fonction d'attachement de fichiers (voir plus bas)
De façon générale, vous pouvez également sélectionner votre texte à formater, et utiliser la barre d'outil pour vous aider dans la rédaction.
(:*toc:)
Attach:fichier.ext lors de l'édition de la page (si besoin avec l'icône du trombone dans la barre d'outils), et cliquer sur le lien qui apparaît, et conduit vers la page d'ajout de fichier. L'extension doit être présente pour que le fichier soit correctement utilisable ensuite.
?action=upload à la fin de la page actuelle (par exemple HelpFr?action=upload).
rajouter Mini:liste de fichiers image.jpg etc
par exemple :
Mini:image_sample01.jpg,image_sample02.png
les images peuvent être mises en place soit en les copiant dans le dossier uploads, soit en les téléchargeant individuellement avec la méthode du dessus.
|
| table | cellule 2 | cellule 3 |
| table | cellule 2 | cellule 3 |
| table | cellule 2 | cellule 3 | cellule 4 |
| table | cellule 2 | cellule 3 | cellule 4 |
(inclus depuis HelpFrQuickReference)
Cette extension, optionnelle, permet de rajouter des effets de texte non disponibles dans la version de base de txt2tags.
voir http://code.google.com/p/textallion/ pour le site de textallion
{//..} : Saut de ligne. Si vous préférez, vous pouvez également utiliser la syntaxe propre à pmwiki : \\ ou sauter 2 lignes pour passer une ligne à l'affichage.
Par exemple pour séparer ce paragraphe
Et celui-ci.
{ ~~ } texte ou image à centrer {/~~ } . Si vous préférez, vous pouvez également utiliser la syntaxe propre à pmwiki : %center%
pour des images :
pour du texte :
texte centré
%lfloat% dans pmwiki) :
Attach:image.png{~~~~}
Paragraphe incluant l'image
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam viverra nec consectetur ante hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue.
et le reste ici...
%rfloat% dans pmwiki) :
{~~~~}Attach:image.png
Paragraphe incluant l'image
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec a diam lectus. Sed sit amet ipsum mauris. Maecenas congue ligula ac quam viverra nec consectetur ante hendrerit. Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue.
et le reste ici...
Vous pouvez ainsi retrouver cette documentation dans ce fichier pdf, ou sur le wiki google code du projet.
Cela a été réalisé avec le convertisseur textallion
Il est facilement extensible via un système de modules externes ("cookbooks"). Il utilise sa propre syntaxe wiki, mais il est possible d'utiliser la syntaxe de txt2tags à l'intérieur de PmWiki !
La syntaxe txt2tags est simple et facile à retenir : http://www.pmwiki.org/wiki/Cookbook/Txt2tags
En outre, des icônes spécifiques permettent d'aider à la mise en page.
BlogIt est une recette pour rajouter un moteur de blog à pmwiki. Vous pouvez le désactiver, si vous ne l'utilisez pas, dans le fichier local/config.php.
Le seul petit problème par rapport à l'original, est du fait de la syntaxe txt2tags, ça provoque une erreur dans le lien pour éditer les entrées de blog depuis le récapitulatif. Aussi il faut éditer les entrées de blog dans le menu sur le côté (sidebar).
Par défaut, l'encodage de la version francophone de PmWiki est ISO-8859-1. Cette présente version propose l'encodage UTF-8, plus adapté aux serveurs sous Unix.
Il suffit d'ajouter (:redirect Main/NewPage quiet=0:) pour rediriger une page vers une autre, comme sur cet exemple : HelpSampleRedirect.
Attention si vous indiquez quiet=1, vous ne pourrez plus éditer la page en cliquant dessus (le lien de redirection disparaîtra), il faudrait entrer l'URL à éditer à la main, dans la barre d'URL du navigateur, par exemple HelpSampleRedirect?action=edit
Pour en savoir plus, se référer à l'aide officielle : PageDirectives
Pour inclure une page dans une autre, il suffit d'écrire (:include Main/PageAInclure:) pour fusionner la seconde page dans la première.
C'est pratique pour inclure par exemple une page de nouvelles, comme ici :
Pour en savoir plus, se référer à l'aide officielle : IncludeOtherPages
Pour modifier les droits en lecture / écriture sur une page spécifique, outrepassant les droits définis dans le fichier local/config.php, il suffit de rajouter ?action=attr à la fin de l'adresse de la page à modifier. Par exemple HelpFr?action=attr.
Pour en savoir plus, se référer à l'aide officielle : Passwords
Voir cet exemple (visible uniquement sur le wiki) : HelpFormSample
Voir cet exemple (visible uniquement sur le wiki) : HelpSocialNetworks.
Utilise HTML5Audio et HTML5Video Voir ces sites pour la notice d'utilisation.
Rajoutez dans le .htaccess à la racine de votre site :
AddType audio/ogg .ogg AddType video/ogg .ogv AddType video/mp4 .mp4 AddType video/webm .webm
Le thème par défaut utilise des webfonts, c'est à dire une police de caractère embarquée (incluse dans le thème).
Pour modifier le thème utilisé, il suffit de le signaler dans le fichier local/config.php : décommentez le thème choisi, ou éditez le thème existant.
Notez bien : pour éviter de charger de trop nombreux fichiers sur le serveur, certains thèmes, qui se trouvent dans le dossier pub/skins, ont été compressés, veuillez les dézipper avant utilisant.
Il est possible de changer de thème grâce à la recette SkinChange :
Veuillez ajouter où vous le souhaitez (par exemple dans le pied de page) [[{$Name}?setskin=themename|New theme]]
La recette http://www.pmwiki.org/wiki/Cookbook/PageTopStore permet de stocker les fichiers pmwiki dans un format textuel lisible et éditable depuis n'importe quel éditeur de texte. Il sera donc possible d'administrer un wiki depuis un gestionnaire de versions tel quel SVN ou Mercurial, ou depuis une connexion ssh.
Les archives se trouveront dans wiki.d et le répertoire « courant » sera maintenant wikitop.d, les fichiers à éditer seront donc dans ce dossier. La synchronisation se fera au moment de l'édition des pages depuis l'interface web (wikitop.d => wiki.d => wikitop.d). Si vous n'éditez rien depuis l'interface web, le site sera lu depuis wikitop.d de toute façon.
Pour convertir vers ce système un wiki existant, veuillez :
pmwiki-efo sur votre serveur, via ftp. Assurez-vous que le dossier wiki.d est en mode de lecture / écriture complet (chmod 777).
Nous vous renvoyons à la page d'accueil générale de l'installation de PmWiki par rapport à ce processus.
local/config.php pour modifier les mots de passe par défaut et pour adapter pmwiki à vos besoins (rajout de cookbooks, comportement etc.)
Si possible, au lieu de php4, veuillez utiliser php5, PmWiki fonctionne mieux avec ce dernier