Outils pour utilisateurs

Outils du site


admin:services:wiki.chapril.org

Différences

Ci-dessous, les différences entre deux révisions de la page.


Révision précédente
admin:services:wiki.chapril.org [2024/04/24 15:13] (Version actuelle) – [Bannière Chapril] claver
Ligne 1: Ligne 1:
 +[[admin:#documentation_des_services_utilisateurs|Retour]] <<
  
 +====== Service wiki.chapril.org ======
 +
 +{{ :wiki:dokuwiki.svg |}}
 +===== Introduction =====
 +
 +Ce service est basé sur Dokuwiki\\ 
 +Site principal : [[https://www.dokuwiki.org]]\\ 
 +Sources : [[https://download.dokuwiki.org/]]\\ 
 +Machine virtuelle Chapril pour ce service : **wiki.cluster.chapril.org**\\
 +Service wiki Chapril: [[https://wiki.chapril.org/|wiki.chapril.org]]\\
 +
 +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). \\
 +
 +===== Préparation =====
 +
 +==== Nouvelle VM ====
 +
 +Création de la VM avec la procédure [[admin:procedures:creation_machine_virtuelle|Création d'une machine virtuelle « bling »]].
 +
 +==== Pré-requis ====
 +
 +Pré-requis sur la : [[https://www.dokuwiki.org/install:php|Page de documentation d'installation sur le site dokuwiki.org]]
 +
 +==== Apache ====
 +
 +{{:admin:services:wiki:asf_logo.png?nolink&200|}}
 +
 +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ée un dossier pour les animaux ''/srv/wiki_utilisateurs'' qui contiendra les données des utilisateurs \\
 +''mkdir /srv/wiki_utilisateurs''
 +==== plugin farmer ====
 +
 +{{:admin:services:wiki:dwplugin.png?direct&80|}}
 +
 +Pour l'installation de l'extension //farmer//, on peut utiliser l'interface d'administration, il suffit de rechercher l'extension, puis de l'installer : [[https://www.dokuwiki.org/plugin:farmer|www.dokuwiki.org/plugin:farmer]] \\
 +A partir de maintenant, un nouveau menu permet la gestion des animaux.
 +
 +===== Personnalisation =====
 +
 +==== Favicon====
 +
 +{{ :admin:services:wiki:favicon.ico |}}
 +
 +A placer ici : ''/srv/wiki_admin/lib/tpl/chapril/images''
 +
 +==== 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 : [[https://banner.chapril.org/Chapril-banner/v2/index.html|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é.
 +
 +{{:admin:services:wiki:wiki_grefon_farmer.jpg?direct&400|}}
 +
 +==== 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 : [[https://www.dokuwiki.org/install:upgrade|www.dokuwiki.org/install:upgrade]] \\
 +Si nécessaire, mettre à jour le plugin farmer en utlisant l'interface administration
 +
 +[[admin:#documentation_des_services_utilisateurs|Retour]] <<