Table des matières
Retour «
Service wiki.chapril.org
Introduction
Le serveur web sera Apache2, l'application sera Dokuwiki avec l'extension ferme de wikis. Il n'y pas de base de données pour l'installation de base. Cependant une extension peut en ajouter une (pour avoir des données structurées).
L'adresse du service wiki est : wiki.chapril.org
Préparation
Nouvelle VM
Création de la VM avec la procédure Création d'une machine virtuelle « bling ».
Pré-requis
Pré-requis sur la : Page de documentation d'installation sur le site dokuwiki.org
Apache
Commandes d'installation d'apache2 et des modules nécessaires:
apt install apache2 php libapache2-mod-php
apt install php-curl php-gd php-intl php-json php-mbstring php-xml php-zip
LVM
Création d'un volume logique avec LVM, le nom de ce volume sera donnees_utilisateurs, puis formatage en ext4
lvcreate -n donnees_utilisateurs -L 10g vgmain
mkfs -t ext4 /dev/vgmain/donnees_utilisateurs
Création du dossier de montage nommé wiki_utilisateurs et modification du fichier /etc/fstab pour le montage automatique du dossier, enfin, montage manuel :
mkdir /srv/wiki_utilisateurs
vim /etc/fstab
/dev/mapper/vgmain-donnees_utilisateurs /srv/wiki_utilisateurs ext4 defaults 0 2
mount -a
Vérification de ce qui a été fait précédemment :
# lvs
LV VG Attr LSize Pool Origin Data% Meta% Move Log Cpy%Sync Convert donnees_utilisateurs vgmain -wi-ao---- 10,00g rootfs vgmain -wi-ao---- <4,66g swap vgmain -wi-ao---- <1,86g tmp vgmain -wi-ao---- 284,00m var vgmain -wi-ao---- <1,86g
# mount |grep dev/mapper
/dev/mapper/vgmain-rootfs on / type ext4 (rw,relatime,errors=remount-ro) /dev/mapper/vgmain-donnees_utilisateurs on /srv/wiki_utilisateurs type ext4 (rw,relatime) /dev/mapper/vgmain-tmp on /tmp type ext4 (rw,relatime) /dev/mapper/vgmain-var on /var type ext4 (rw,relatime)
Installation de l'application
Récupération et extraction
Le dossier /srv à la racine du système contiendra tous les fichiers pour Dokuwiki (application, configuration et données)
Récupération et extraction des fichiers de l'application Dokuwiki sur le site officiel, extraction et copie des fichiers dans le dossier wiki_admin qui contient l'application (mais ne contiendra pas les données des utilisateurs) :
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
tar -xzvf dokuwiki-stable.tgz
'cp' -af dokuwiki-xxxx-xx-xx/* /srv/wiki_admin/
On créer un dossier pour les animaux /srv/wiki_utilisateurs
qui contiendra les données des utilisateurs
mkdir /srv/wiki_utilisateurs
plugin farmer
Pour l'installation de l'extension farmer, on peut utiliser l'interface d'administration, il suffit de rechercher l'extension, puis de l'installer : www.dokuwiki.org/plugin:farmer
A partir de maintenant, un nouveau menu permet la gestion des animaux.
Personnalisation
Favicon
Bannière Chapril
La mise en place de la bannière se fait dans l'application Dokuwiki, dans un thème nommé “chapril”.
Les fichiers à récupérer : header.html, chapril-banner-logo.png, chapril-banner.css, on les trouve ici ; banner.chapril.org
Création d'un nouveau thème à partir du thème starter. Ensuite, la mise en place de la bannière Chapril se fait en déposant les fichiers dans le dossier du thème “chapril” qui se trouve ici : /srv/wiki_admin/lib/tpl/
Pied de page
Texte d'accueil
Page d'accueil du service Wiki du Chapril
Demander la création d'un wiki :
Ecrire à (enveler les *): wiki-support *@* chapril.org et préciser :
- le nom du wiki, par exemple : “Mon wiki sur les logiciels libres”
- le nom court pour l'adresse, par exemple : monwiki
- le descriptif, par exemple : documentation de mon logiciel
- le wiki sera public ou privé
Configuration
Journaux
Cron
Utilisation et Modération
Créer un compte
Pour créer un compte, on peut le faire dans l'interface en ligne. Se connecter en tant qu'administrateur sur l'instance principale, puis
administrer > Extensions supplémentaires - Élevage > Ajouter un animal
Donner un nom et choisir le type de wiki : ouvert, public ou fermé.
Supprimer un compte
Pour supprimer un compte, on peut le faire dans l'interface en ligne. Se connecter en tant qu'administrateur sur l'instance principale, puis
administrer > Extensions supplémentaires - Élevage > Supprimer un animal
Choisir l'animal dans la liste, saisir le nom de l'animal manuellement pour confirmer. Cliquer sur le bouton “Détruire l'animal et toutes ses données”.
Rapport d'activité mensuelle automatique
Gestion des mises à jour
Page pour upgrade : www.dokuwiki.org/install:upgrade
Si nécessaire, mettre à jour le plugin farmer en utlisant l'interface administration
Retour «