Tout le monde connaît wikipedia, la gratuité de certains étudiants remercie même wikipedia pour son diplôme. Dans cet article, je vais vous montrer comment installer le logiciel wikipedia, mediawiki, sur votre serveur FreeBSD avec Apache et MySQL.
Dans mon cas, j'ai installé notre propre mediawiki pour documenter mon travail. Quand j'ai commencé à travailler ici, mon patron de l'époque m'a confié ma première tâche :installer un serveur pour un service et me donner sa feuille de triche sur la façon de le faire. Cette feuille de triche était une véritable feuille de papier manuscrite; il avait également un bloc de papier avec différentes feuilles de triche pour différents services.
Moins d'un mois après cette première tâche, d'innombrables visites à son bureau à la recherche d'autres feuilles de triche et de quelques nouveaux systèmes (dont je n'ai pas documenté la façon de le faire), nous avons tous les deux réalisé que nous avions besoin d'un meilleur système. De plus, mon écriture est très difficile à lire et à l'avenir, de nouvelles personnes pourraient commencer à travailler avec nous et nous aurons besoin d'une meilleure documentation. C'est pourquoi j'ai suggéré d'installer mediawiki et mon patron était d'accord.
Prérequis
Mediawiki peut fonctionner sur n'importe quel serveur Web prenant en charge PHP (c'est-à-dire apache, nginx, etc.) et stocker son contenu dans une base de données qui peut être MySQL (ou MariaDB), PostgreSQL ou Sqlite. Si vous n'avez pas de serveur Web ou de base de données fonctionnel, vous pouvez consulter ce tutoriel :https://unixcop.com/install-lamp-on-freebsd-12-x/
Les extensions PHP suivantes sont nécessaires :Perl Compatible Regular Expressions (PCRE), session, spl, openssl, json, mbstring, fileinfo et intl.
Si vous souhaitez télécharger des images (c'est-à-dire des captures d'écran, des diagrammes, des photos ou d'autres types d'images), vous aurez besoin d'ImageMagick pour gérer les vignettes, ce n'est pas obligatoire mais recommandé.
Compilez les ports requis
Nous utiliserons le système de ports pour télécharger et installer le logiciel mediawiki et ses dépendances. Exécuter :
$ su -
cd /usr/ports/www/mediawiki135
make config install clean
L'écran suivant apparaîtra, où je choisis ImageMagick pour gérer les images et utiliser MySQL comme base de données :
Suivez les instructions à l'écran et quand c'est fini, vous verrez un écran comme celui-ci :
Au cas où il vous manquerait un module php, vous pouvez ajouter avec les extensions php73 :
# cd /usr/ports/lang/php73-extensions
# make config install clean
Base de données pour mediawiki
Si vous avez beaucoup de dépendances à installer comme moi, ouvrez une autre console et créez la base de données et l'utilisateur de la base de données pendant que le système compile les choses; sinon, attendez que le travail principal de compilation et d'installation soit terminé.
C'est toujours une bonne idée de ne pas utiliser le même utilisateur pour tout, alors créez un utilisateur pour mediawiki :
# mysql -p
Welcome to the MariaDB monitor. Commands end with ; or \g.
Your MariaDB connection id is 3
Server version: 10.5.10-MariaDB FreeBSD Ports
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
root@localhost [(none)]> CREATE USER 'mediawiki'@'localhost' IDENTIFIED BY 'wikimedia';
Query OK, 0 rows affected (0.003 sec)Nous avons maintenant un utilisateur mysql appelé mediawiki avec le mot de passe wikimedia. C'est aussi une bonne idée de choisir un meilleur mot de passe. Créons maintenant une base de données et faisons de cet utilisateur le propriétaire :
root@localhost [(none)]> CREATE DATABASE mediawiki;
Query OK, 1 row affected (0.001 sec)
root@localhost [(none)]> GRANT ALL PRIVILEGES ON mediawiki.* TO 'mediawiki'@'localhost';
Query OK, 0 rows affected (0.003 sec)Vous pouvez le faire avec d'autres outils comme PhpMyAdmin bien sûr.
Paramétrage d'Apache
Les fichiers Mediawiki sont installés dans /usr/local/www/mediawik i vous pouvez déplacer ce répertoire dans le répertoire apache24/data ou ajouter les lignes suivantes à /usr/local/etc/apache24/httpd.conf :
Alias /mediawiki "/usr/local/www/mediawiki/"
<Directory "/usr/local/www/roundcube/">
AllowOverride All
Require all granted
</Directory>Configurer le médiawiki
Rechargez apache et allez avec votre navigateur Web sur http://your-webserver/mediawiki, dans mon cas l'url est http://192.168.122.234/mediawiki et suivez les instructions à l'écran :
Choisissez la langue, mediawiki essaiera de détecter la langue du navigateur; comme je suis de langue maternelle espagnole, je choisis l'anglais :
Ensuite, le programme d'installation vérifiera les dépendances et l'environnement :
Faites attention aux avertissements, et aux avertissements de sécurité en particulier. Pour ce tutoriel, j'ignorerai celui du cache, mais l'avertissement concernant /usr/local/www/mediawiki/images vulnérable à l'exécution de scripts je le corrigerai en ajoutant ceci à httpd.conf :
<Directory "/usr/local/www/mediwWiki/images">
AllowOverride None
# Serve HTML as plaintext, don't execute SHTML
AddType text/plain .html .htm .shtml .phtml
# Don't run arbitrary PHP code.
php_admin_flag engine off
</Directory>La question suivante concerne la base de données :
Remplissez les données avec l'utilisateur que nous avons créé dans la section précédente :
- Hôte :localhost (ou 127.0.0.1 si vous obtenez une erreur)
- Nom :mediawiki
- Préfixe :facultatif, chaque nom de table commencera par ce préfixe
- Nom d'utilisateur :mediawiki
- Mot de passe :wikimedia
Remplissez ce formulaire avec vos propres informations de base de données.
Choisissez un nom pour votre wiki, j'irai avec "GonzWiki" et définirez les informations d'utilisateur et de mot de passe administrateur. Et je choisirai l'option "Je m'ennuie déjà, il suffit d'installer le wiki" pour finir.
Le programme d'installation créera les tables de la base de données, initialisera les choses et créera votre page principale :
Enfin, l'installateur vous permettra de télécharger le fichier de configuration que vous devez mettre sur votre répertoire wikimedia /usr/local/www/mediawiki .
Formatage de base du wiki
Cliquez sur "modifier" et voici le formatage de base du texte :
| Type | A voir |
| "italique" | italique |
| "'gras"' | gras |
| ""'italique et gras""' | italique et gras |
| =Rubrique = ==Sous-section == | plus '=' chante, plus le niveau de section est bas |
| Listes * élément de liste */ élément de liste * élément de liste | Changer les astérisques avec le signe dièse (#) pour les listes numérotées |
| [[Page]] | Lien interne vers la page wiki nommée Page |
| [http://some.host/url] | Lien vers un site externe |
Dans les liens suivants, vous pouvez trouver beaucoup plus d'informations :
- https://www.mediawiki.org/wiki/Help:Formatage
- https://www.mediawiki.org/wiki/Help:Links
Bonne édition !