Table des matières
Page de documentation de la configuration de ce wiki
Config
Des usages du wiki
Mot de passe
La méthode de chiffrement des mots de passe lors de l'inscription est Brcypt
Barre de menu gauche
Il est généré depuis aside, puis placé dans la configuration à la ligne sidebar puis réduit en marge depuis Paramètres de style du thème (template) à la valeur 12em
dans Largeur de la barre latérale, si existante (dans une unité de longueur valide: %, px, em,…).
La page aside est ensuite écrite avec la même syntaxe que toute page sur ce wiki
Pour un confort de lecture elle est éditorialisée ainsi :
**[[Le Biohackerspace|]]** * [[Accès|]] * [[Gouvernance|]] ------ **[[Les activités|]]** * Prototypes * Ateliers ------ **Hors les murs** * [[Hack2eaux|]] <etc>
Bouton 'modifier' pour section de page
Ceci est permis par configuration en sélectionnant l'éditeur DokuWiki comme éditeur par défaut
Dispositif anti Spam
Le module Captacha plugin est installé et utilisé (octobre 2020) pour proposer de résoudre un formule mathématique relativement simple lors de la création de compte et d’enregistrement de modifications de pages.
Mise en forme du texte
Installation du module blockquote qui permte de mettre en forme les citations dans les pages de ce wiki.
<blockquote> Ne jamais croire un citation partagée sur Internet <cite>Apocryphe, "Dans les ZinternetS", Act 0 scene 2</cite> </blockquote> Qui disait aussi <q>C'est ça la vie!</q> et se carapata.
« Ne jamais croire un citation partagée sur Internet »
Apocryphe, “Dans les ZinternetS”, Act 0 scene 2
Qui disait aussi C'est ça la vie !
et se carapata.
Améliorer l'esthétique des citations
Indexation des pages
Étiquettes
- Installation du Module Tag Plugin
pour s'en servir, exemple, ajouter en bas d'une page du wiki
{{tag>Prototype Eaux Rivières}}
Ici 3 étiquettes Prototype
; Eaux
; Rivières
sont appliquées à la page
Ce qui fut fait le 22/11/2020 sur la page pieges_a_microplastiques, voir la vue comprative
ce qui donne un répertoire par étiquette, grace au module PageList Plugin, accessible ici
À faire pour éviter le bordel et améliorer l'indexation
choisir un nombre limite d'étiquette par page ⇒ 4 max
Établir une liste raisonnable des étiquettes utilisables
Appliquer les étiquettes sur les pages du wiki
Écrire une courte page dans le wiki pour expliquer la démarche et comment faire
Établir un page d'index qui liste les étiquettes (en cours sur [[liste_des_tags]]
Indiquer cette indexation en première page du wiki
Typage des documentation
Indiquer le type de documentation pour qu'une personne qui parcours la page puisse se figurer sur quel type de contenu elle arrive.
Créer un modèle insérable dans les pages d'un wiki ( {{mon_modèle}}
avec wikimedia, exemple). Avec le module Include
Puis ensuite avoir un répertoire contenant toute les pages dans lesquelles ce modèle est inséré : Un répertoire des documentation par leur types
4 Types de documentations ici choisie depuis leur forme
- La forme tutorielle, qui est axée sur l’apprentissage, permet au nouvel arrivant de commencer, telle une leçon. Elle est similaire à l’acte d’apprendre à planter des légumes ou d’apprendre à faire la cuisine à un individu. Le modèle est ici, modèle avec le module Wrap, pour l'insérer en début d'une page :
{{page>modele:type_tutorielle}}
- La forme de guide pratique, qui est axée sur les buts, montre comment résoudre un problème spécifique, tout comme une série d’étapes. Elle est semblable à l’acte de cultiver des légumes ou à une recette dans un livre de cuisine. Le modèle est ici, il s'insère en début page avec
{{page>modele:type_guide_pratique}}
- La forme d’explication, qui est axée sur la compréhension, explique, fournit des renseignements généraux et le contexte. Elle est comparable à un article sur l’histoire sociale de la tomate ou l’histoire sociale culinaire. Le modèle est ici et il s'insère en début de page tel que
{{page>modele:type_explication}}
- La forme d’un guide de référence, qui est axé sur l’information, décrit la conception réalisée. Elle vise l’exactitude, donc la vérification et l’ajout de sources, et recherche à être complète. Elle est semblable à un article d’encyclopédie de référence. Le modèle est ici, pour l'insérer en haut d'une page de ce wiki :
{{page>modele:type_guide_reference}}
Finir les modèles de pages pour tous les types
Améliorer les modèles
Insérer dans chaque modèle un lien vers le répertoire correspondant à son type
Voir aussi :
« Comment j'organise mes notes professionnelles avec Dokuwiki et ses plugins » Jln, sur son blog
Création d'un répertoire par type de documentation
À l'aide du module PageQuery
le code ressemble à (pour exemple du répertoire Tutorielle)
{{pagequery>type_tutorielle; fulltext; sort=key:direction,key2:direction; sort=a,name; group; limit=100; cols=2; spelldate; bullet=square; proper; border=inside; hidestart; case; natsort }}
Ce qui rend :
Les répertoires
- Le répertoire de pages contenant de tutoriels
- Le répertoire de pages contenant des guides pratiques
- Le répertoire de pages contenant des explications
- Le répertoire de pages étant des guides de référence
Liste des pages orphelines
Cette page wiki liste les pages dans lesquelles ou pour lesquelles un effort de contribution de contribution est nécessaire afin de rétablir les liens de redirection interne entre pages du wiki.
Légender les images
Les images, une fois téléversées dans le wiki, peuvent être affichées avec l'aide de l'éditeur de texte et/ou avec le wikicode directement dans la page :
{{nom-de-fichier-image.png}}
Pour ajouter une légende aux images nous utilisons le greffons Imagereference. Il s'utilise ainsi :
<imgcaption label|J'écris ici mon texte voulu pour légender l'image>{{nom-de-fichier-image.png}}</imgcaption> L'image ici est visible dans la référence <imgref label>.
Sous le moteur
Ce wiki tourne sur un serveur personnel (auto-hébergement) dans un conteneur Docker. Plusieurs petits changements ont été effectués pour être à même de faire fonctionner certains détails comme l'import/export de wikis.
Nous utilisons un fichier Dockerfile
assez simple :
FROM php:7.3-apache RUN a2enmod rewrite
Le fichier php.ini
a également été modifié comme suit. Dans le conteneur, le fichier est situé dans /usr/local/etc/php/php.ini
, nous avons donc créé un volume Docker : ./data/php.ini:/usr/local/etc/php/php.ini
upload_max_filesize = 100M post_max_size = 100M max_execution_time = 600 max_input_time = 600
Et enfin la configuration de Apache2 (volume Docker : ./data/apache2.conf:/etc/apache2/apache2.conf
)
Timeout 600