MediaWiki chez Free
Un article de Wiki de Piblo, l'encyclopédie libre.
Version du 29 aoû 2005 à 00:21 Piblo (Discuter | contribs) Comment installer MediaWiki sur son site perso chez Free ? ← Go to previous diff |
Version actuelle Piblo (Discuter | contribs) |
||
Ligne 14: | Ligne 14: | ||
:* Téléchargement de la dernière version de [http://www.mediawiki.org/wiki/MediaWiki Mediawiki] (version 1.4.7 pour ma part). Décompression du fichier téléchargé. Les répertoires et fichiers qu'il contient doivent être placés dans le répertoire racine de votre site Web local (cf. plus haut). Renommez le répertoire principal qui y a été créé par un nom plus simple (''wiki'' par exemple). L'installation et la configuration de MediaWiki n'est pas encore commencée. | :* Téléchargement de la dernière version de [http://www.mediawiki.org/wiki/MediaWiki Mediawiki] (version 1.4.7 pour ma part). Décompression du fichier téléchargé. Les répertoires et fichiers qu'il contient doivent être placés dans le répertoire racine de votre site Web local (cf. plus haut). Renommez le répertoire principal qui y a été créé par un nom plus simple (''wiki'' par exemple). L'installation et la configuration de MediaWiki n'est pas encore commencée. | ||
- | :* Au moyen d'un navigateur (Explorer, Firefox...), placez-vous sur la racine du site Web local (''[http://127.0.0.1/ http://127.0.0.1/]''). La page d'accueil vous permet de visiter le répertoire ''wiki''. En cliquant sur l'icone correspondante, vous devez être invités à installer MediaWiki. Retenez les mots de passe que vous entrez dans le formulaire. Laissez wikidb et wikiuser comme noms de la base et d'utilisateur mais n'hésitez pas à donner un préfixe à vos tables (2-3 lettres). C'est utile si, comme moi, vous avez déjà des tables dans votre base MySQL chez Free... Cela vous permettra d'installer, par exemple, plusieurs wiki sur un même compte chez Free. | + | :* Au moyen d'un navigateur (Explorer, Firefox...), placez-vous sur la racine du site Web local (''[http://127.0.0.1/ http://127.0.0.1/]'' ou ''[http://localhost/ http://localhost/]''). La page d'accueil vous permet de visiter le répertoire ''wiki''. En cliquant sur l'icone correspondante, vous devez être invités à installer MediaWiki. Choisissez le Français comme langue si vous le souhaitez. Retenez les mots de passe que vous entrez dans le formulaire. Laissez wikidb et wikiuser comme noms de la base et d'utilisateur mais n'hésitez pas à donner un préfixe à vos tables (2-3 lettres). C'est utile si, comme moi, vous avez déjà des tables dans votre base MySQL chez Free... Cela vous permettra d'installer, par exemple, plusieurs wiki sur un même compte chez Free. |
:* Déplacez le fichier ''LocalSettings.php'' du répectoire ''config'' vers la racine de votre wiki (''wiki''). | :* Déplacez le fichier ''LocalSettings.php'' du répectoire ''config'' vers la racine de votre wiki (''wiki''). | ||
:* Modifiez le fichier de configuration ''LocalSettings.php'' si vous souhaitez, comme moi, pouvoir "uploader" des fichiers (images par exemple) à travers votre wiki. Vous devez rendre la ligne suivante active en supprimant le caractère "#" du début. | :* Modifiez le fichier de configuration ''LocalSettings.php'' si vous souhaitez, comme moi, pouvoir "uploader" des fichiers (images par exemple) à travers votre wiki. Vous devez rendre la ligne suivante active en supprimant le caractère "#" du début. | ||
- | wgDisableUploads = false; | + | $wgDisableUploads = false; |
+ | ::... ou, à partir de la version 1.5: | ||
+ | $wgEnableUploads = true; | ||
- | :* Ajouter la ligne suivante si vous souhaitez rendre obligatoire l'identification des utilisateurs qui modifient ou créent des pages. | + | :* Si vous souhaitez que vos images puissent être re-dimensionnées ou utiliser des imagettes (thumbnails), faites en sorte que... |
- | wgWhitelistEdit = true; | + | $wgUseImageResize = true; |
+ | ::mais ne dé-commentez surtout pas les 2 lignes concernant ImageMagick. Ce soft n'est pas disponible sur le serveur de Free. Je pense que par défaut, c'est GD - disponible sur le serveur - qui est utilisé. | ||
- | :* Si vous souhaitez rendre impossible l'inscription automatique des utilisateurs, ajoutez la ligne suivante. Lisez la page ''[http://meta.wikimedia.org/wiki/Preventing_Access Preventing Access]'' du site officiel de MediaWiki pour plus d'explications. | + | :* Ajoutez les lignes suivantes si vous souhaitez rendre obligatoire l'identification des utilisateurs qui modifient ou créent des pages et rendre impossible l'inscription automatique. |
+ | $wgWhitelistEdit = true; | ||
$wgWhitelistAccount = array ( "sysop" => 1, "developer" => 1 ); | $wgWhitelistAccount = array ( "sysop" => 1, "developer" => 1 ); | ||
+ | |||
+ | :* A partir de la version 1.5 ces lignes ne sont plus d'actualité. Lisez la page ''[http://meta.wikimedia.org/wiki/Preventing_Access Preventing Access]'' du site officiel de MediaWiki pour copier les lignes ''ad hoc'' et avoir plus d'explications. | ||
:* Testez MediaWiki en local. | :* Testez MediaWiki en local. | ||
- | :* Au moyen de PHPAdmin (fourni avec EasyPHP), exportez toutes les tables MySQL générées lors de l'installation de WikiMedia. Au moyen de [http://sql.free.fr/phpMyAdmin/ PHPAdmin de Free], importez-les dans votre base distante. Si votre base n'a pas encore été activée, commencez par le faire (cf. [http://support.free.fr/web/ ici]). | + | :* Au moyen de [http://localhost/mysql/ PHPAdmin] (fourni avec EasyPHP), exportez toutes les tables MySQL générées lors de l'installation de WikiMedia. Au moyen de [http://sql.free.fr/phpMyAdmin/ PHPAdmin de Free], importez-les dans votre base distante. Si votre base n'a pas encore été activée, commencez par le faire (cf. [http://support.free.fr/web/ ici]). |
:* Déposez les répertoires et fichiers créés sur votre serveur local sur votre espace personnel chez Free, au moyen d'un client FTP. Pour ma part, j'utilise [http://filezilla.sourceforge.net/ FileZilla]. Il est excellent ! Je pense qu'il contribue grandement au succès de l'entreprise car il gère les déconnexions intempestives qui peuvent se produire pendant le téléchargement des très nombreux fichiers. | :* Déposez les répertoires et fichiers créés sur votre serveur local sur votre espace personnel chez Free, au moyen d'un client FTP. Pour ma part, j'utilise [http://filezilla.sourceforge.net/ FileZilla]. Il est excellent ! Je pense qu'il contribue grandement au succès de l'entreprise car il gère les déconnexions intempestives qui peuvent se produire pendant le téléchargement des très nombreux fichiers. | ||
- | :* Faite une copie du fichier ''LocalSettings.php'' qui a été généré lors de l'installation de MediaWiki en local puis modifié pour permettre les uploads. Sur cette copie, faites les modifications recommandées par [http://j.portalier.free.fr/wiki/index.php?title=MediaWiki J. Portalier] puis, exportez le fichier le site de Free. La recommandation de Bionet pour ''$IP'' (cf. sa contribution à la suite de [http://www.framasoft.net/article2674.html l'article de Framasoft]) ne fonctionnait pas. Mettre "." dans la variable ''$IP''. | + | :* Faite une copie du fichier ''LocalSettings.php'' qui a été généré lors de l'installation de MediaWiki en local puis modifié pour permettre les uploads. Sur cette copie, faites les modifications recommandées par [http://j.portalier.free.fr/wiki/index.php?title=MediaWiki J. Portalier] puis, exportez le fichier le site de Free. La recommandation de Bionet pour ''$IP'' (cf. sa contribution à la suite de [http://www.framasoft.net/article2674.html l'article de Framasoft]) ne fonctionnait pas. Mettre "." dans la variable ''$IP''. En résumé... |
+ | |||
+ | ::Trouvez la ligne marquée, où "xxx" est quelque chose du style "/var/www/mediawiki" : | ||
+ | $IP = "xxx"; | ||
+ | |||
+ | :: et remplacez-là par : | ||
+ | $IP = "."; | ||
+ | |||
+ | ::Commentez, c'est à dire mettez un # devant, cette ligne : | ||
+ | #$wgArticlePath = "$wgScript/$1"; | ||
+ | |||
+ | :: et décommentez(enlever le #) la ligne : | ||
+ | $wgArticlePath = "$wgScript?title=$1"; | ||
+ | |||
+ | ::Modifiez enfin la configuration de votre base de donnée pour que MediaWiki puisse se connecter sur celle de votre compte Free : | ||
+ | $wgDBserver = "sql.free.fr"; | ||
+ | $wgDBname = "<nom de la base>"; | ||
+ | $wgDBuser = "<nom de l'utilisateur chez Free>"; | ||
+ | $wgDBpassword = "<mot de passe>"; | ||
+ | |||
+ | ::Notez que $wgDBname et $wgDBuser devraient être identiques (la base de données chez Free étant celle de l'utilisateur principal) et que le $wgDBpassword est simplement votre mot de passe chez Free. | ||
:* Déposez le fichier LocalSettings.php modifié sur votre sur votre espace personnel chez Free. | :* Déposez le fichier LocalSettings.php modifié sur votre sur votre espace personnel chez Free. | ||
Ligne 40: | Ligne 66: | ||
Voilà ! Ca doit marcher. | Voilà ! Ca doit marcher. | ||
+ | |||
==Astuces== | ==Astuces== | ||
- | '''Liens interwiki'''<br>Par défaut, les liens interwiki utilisant la syntaxe ''<nowiki>[[WikiPedia:fleur]]</nowiki>'' pointent sur la Wikipedia anglaise. Pour qu'ils pointent sur la Wikipedia française, il faut modifier remplacer l'URL ''<nowiki>"http://en.wikipedia.org/wiki/$1"</nowiki>'' par ''<nowiki>"http://fr.wikipedia.org/wiki/$1"</nowiki>'' dans la table interwiki de la base de données pour le préfixe ''"WikiPedia"''. On peut aussi créer un nouvel enregistrement avec un préfixe différent si l'on souhaite faire des liens vers la Wikipedia anglaise. | + | '''Utiliser les liens interwiki'''<br>Par défaut, les liens interwiki utilisant la syntaxe ''<nowiki>[[WikiPedia:fleur]]</nowiki>'' pointent sur la Wikipedia anglaise. Pour qu'ils pointent sur la Wikipedia française, il faut modifier remplacer l'URL ''<nowiki>"http://en.wikipedia.org/wiki/$1"</nowiki>'' par ''<nowiki>"http://fr.wikipedia.org/wiki/$1"</nowiki>'' dans la table interwiki de la base de données pour le préfixe ''"WikiPedia"''. On peut aussi créer un nouvel enregistrement avec un préfixe différent si l'on souhaite faire des liens vers la Wikipedia anglaise. |
+ | |||
+ | '''Changer le logo'''<br>Il suffit de remplacer le fichier wiki.png qui se trouve dans le répertoire ''skins/common/images/'' par votre propre logo. La gestion des fonds transparents - que je ne maîtrise pas encore - est souhaitable. | ||
+ | |||
+ | '''Modifier le menu de gauche'''<br>Il faut adapter/modifier le fichier ''includes/DefaultSattings.php'' en commentant les lignes du menu que l'on veut supprimer et en ajoutant d'autres dans le tableau ''$wgNavigationLinks'' puis en faisant les traductions qui vont bien dans le fichier ''langages/LangageFR.php'' | ||
+ | * A partir de la version 1.5, la gestion du menu de navigation a été grandement simplifiée. Elle peut désormais se faire au moyen de la page MediaWiki:Sidebar. Lisez la page [http://meta.wikimedia.org/wiki/Sidebar Sidebar] du site officiel de MediaWiki pour plus d'explications. | ||
- | '''Changement de logo'''<br>Il suffit de remplacer le fichier wiki.png qui se trouve dans le répertoire ''skins/common/images/'' par votre propre logo. La gestion des fonds transparents - que je ne maîtrise pas encore - est souhaitable. | ||
==Liens== | ==Liens== |
Version actuelle
Cette page est en cours d'élaboration. Elle sera complétée au fur et à mesure de mes disponibilités et découvertes. S'il vous plait, ne cherchez pas à me joindre pour me demander de vous aider plus que je ne le fais ci-après, je risque de ne pas être en mesure de vous répondre. |
Comment installer MediaWiki sur son site perso chez Free ?
En fait, ce n'est pas trop compliqué. Le principe consiste à installer d'abord MediaWiki sur un serveur local puis à exporter ses divers éléments chez Free (méthode préconisée et expliquée par J. Portalier sur son site wiki (http://j.portalier.free.fr/wiki/index.php?title=MediaWiki)). Voici comment j'ai procédé en utilisant mon PC fonctionnant sous Windows XP.
- Téléchargement et installation de la dernière version stable de EasyPHP (http://www.easyphp.org/) (1.8.0.1 pour ce qui me concerne). Par défaut, EasyPHP s'installe dans un répertoire du style c:\Program Files\EasyPHP1-8\. La racine de votre site Web local, http://127.0.0.1/, se trouve alors en c:\Program Files\EasyPHP1-8\www\. Notez que vous ne pouvez surfer sur votre site Web local que si EasyPHP est activé. Une icone en forme de "e" est alors visible en bas, à droite de votre écran.
- Téléchargement de la dernière version de Mediawiki (http://www.mediawiki.org/wiki/MediaWiki) (version 1.4.7 pour ma part). Décompression du fichier téléchargé. Les répertoires et fichiers qu'il contient doivent être placés dans le répertoire racine de votre site Web local (cf. plus haut). Renommez le répertoire principal qui y a été créé par un nom plus simple (wiki par exemple). L'installation et la configuration de MediaWiki n'est pas encore commencée.
- Au moyen d'un navigateur (Explorer, Firefox...), placez-vous sur la racine du site Web local (http://127.0.0.1/ ou http://localhost/). La page d'accueil vous permet de visiter le répertoire wiki. En cliquant sur l'icone correspondante, vous devez être invités à installer MediaWiki. Choisissez le Français comme langue si vous le souhaitez. Retenez les mots de passe que vous entrez dans le formulaire. Laissez wikidb et wikiuser comme noms de la base et d'utilisateur mais n'hésitez pas à donner un préfixe à vos tables (2-3 lettres). C'est utile si, comme moi, vous avez déjà des tables dans votre base MySQL chez Free... Cela vous permettra d'installer, par exemple, plusieurs wiki sur un même compte chez Free.
- Déplacez le fichier LocalSettings.php du répectoire config vers la racine de votre wiki (wiki).
- Modifiez le fichier de configuration LocalSettings.php si vous souhaitez, comme moi, pouvoir "uploader" des fichiers (images par exemple) à travers votre wiki. Vous devez rendre la ligne suivante active en supprimant le caractère "#" du début.
$wgDisableUploads = false;
- ... ou, à partir de la version 1.5:
$wgEnableUploads = true;
- Si vous souhaitez que vos images puissent être re-dimensionnées ou utiliser des imagettes (thumbnails), faites en sorte que...
$wgUseImageResize = true;
- mais ne dé-commentez surtout pas les 2 lignes concernant ImageMagick. Ce soft n'est pas disponible sur le serveur de Free. Je pense que par défaut, c'est GD - disponible sur le serveur - qui est utilisé.
- Ajoutez les lignes suivantes si vous souhaitez rendre obligatoire l'identification des utilisateurs qui modifient ou créent des pages et rendre impossible l'inscription automatique.
$wgWhitelistEdit = true; $wgWhitelistAccount = array ( "sysop" => 1, "developer" => 1 );
- A partir de la version 1.5 ces lignes ne sont plus d'actualité. Lisez la page Preventing Access (http://meta.wikimedia.org/wiki/Preventing_Access) du site officiel de MediaWiki pour copier les lignes ad hoc et avoir plus d'explications.
- Testez MediaWiki en local.
- Au moyen de PHPAdmin (http://localhost/mysql/) (fourni avec EasyPHP), exportez toutes les tables MySQL générées lors de l'installation de WikiMedia. Au moyen de PHPAdmin de Free (http://sql.free.fr/phpMyAdmin/), importez-les dans votre base distante. Si votre base n'a pas encore été activée, commencez par le faire (cf. ici (http://support.free.fr/web/)).
- Déposez les répertoires et fichiers créés sur votre serveur local sur votre espace personnel chez Free, au moyen d'un client FTP. Pour ma part, j'utilise FileZilla (http://filezilla.sourceforge.net/). Il est excellent ! Je pense qu'il contribue grandement au succès de l'entreprise car il gère les déconnexions intempestives qui peuvent se produire pendant le téléchargement des très nombreux fichiers.
- Faite une copie du fichier LocalSettings.php qui a été généré lors de l'installation de MediaWiki en local puis modifié pour permettre les uploads. Sur cette copie, faites les modifications recommandées par J. Portalier (http://j.portalier.free.fr/wiki/index.php?title=MediaWiki) puis, exportez le fichier le site de Free. La recommandation de Bionet pour $IP (cf. sa contribution à la suite de l'article de Framasoft (http://www.framasoft.net/article2674.html)) ne fonctionnait pas. Mettre "." dans la variable $IP. En résumé...
- Trouvez la ligne marquée, où "xxx" est quelque chose du style "/var/www/mediawiki" :
$IP = "xxx";
- et remplacez-là par :
$IP = ".";
- Commentez, c'est à dire mettez un # devant, cette ligne :
#$wgArticlePath = "$wgScript/$1";
- et décommentez(enlever le #) la ligne :
$wgArticlePath = "$wgScript?title=$1";
- Modifiez enfin la configuration de votre base de donnée pour que MediaWiki puisse se connecter sur celle de votre compte Free :
$wgDBserver = "sql.free.fr"; $wgDBname = "<nom de la base>"; $wgDBuser = "<nom de l'utilisateur chez Free>"; $wgDBpassword = "<mot de passe>";
- Notez que $wgDBname et $wgDBuser devraient être identiques (la base de données chez Free étant celle de l'utilisateur principal) et que le $wgDBpassword est simplement votre mot de passe chez Free.
- Déposez le fichier LocalSettings.php modifié sur votre sur votre espace personnel chez Free.
- Dernière chose importante : créez un répertoire vide nommé "sessions" sur la racine de votre site Web. Sans ça, les droits d'écriture et d'administration ne fonctionneront pas pour les utilisateurs identifiés et pour le WikiSysop.
Voilà ! Ca doit marcher.
Astuces
Utiliser les liens interwiki
Par défaut, les liens interwiki utilisant la syntaxe [[WikiPedia:fleur]] pointent sur la Wikipedia anglaise. Pour qu'ils pointent sur la Wikipedia française, il faut modifier remplacer l'URL "http://en.wikipedia.org/wiki/$1" par "http://fr.wikipedia.org/wiki/$1" dans la table interwiki de la base de données pour le préfixe "WikiPedia". On peut aussi créer un nouvel enregistrement avec un préfixe différent si l'on souhaite faire des liens vers la Wikipedia anglaise.
Changer le logo
Il suffit de remplacer le fichier wiki.png qui se trouve dans le répertoire skins/common/images/ par votre propre logo. La gestion des fonds transparents - que je ne maîtrise pas encore - est souhaitable.
Modifier le menu de gauche
Il faut adapter/modifier le fichier includes/DefaultSattings.php en commentant les lignes du menu que l'on veut supprimer et en ajoutant d'autres dans le tableau $wgNavigationLinks puis en faisant les traductions qui vont bien dans le fichier langages/LangageFR.php
- A partir de la version 1.5, la gestion du menu de navigation a été grandement simplifiée. Elle peut désormais se faire au moyen de la page MediaWiki:Sidebar. Lisez la page Sidebar (http://meta.wikimedia.org/wiki/Sidebar) du site officiel de MediaWiki pour plus d'explications.
Liens
- Un article chez Framasoft (http://www.framasoft.net/article2674.html)
- Les explications de J. Portalier (http://j.portalier.free.fr/wiki/index.php?title=MediaWiki)
- Le site officiel de EasyPHP (http://www.easyphp.org/)
- Une présentation de MediaWiki MediaWiki (http://fr.wikipedia.org/wiki/Mediawiki)
- Télécharger Mediawiki (http://www.mediawiki.org/wiki/MediaWiki/Versions_and_Download)
- Les FAQs de Mediawiki (http://meta.wikimedia.org/wiki/MediaWiki_FAQ)