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

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 page4 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

Les ToDo listes sont possibles grâce au module ToDo installé sur notre wiki

Typage des documentation

Cet effort provient d'un Essai réflexif — 2019/03/01 − « De l’hypothèse de la documentation comme technique de résistance et du wiki comme objet de ces résistances » Nicolas Belett Vigneron Émilie Picton Sébastien Beyou Xavier Coadic

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

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

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