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 [[wp>wiki/Bcrypt |Brcypt]]

==== Barre de menu gauche ====

Il est généré depuis [[:aside|]], puis placé dans la [[:aside?do=admin&page=config|configuration]] à la ligne sidebar puis réduit en marge depuis [[:aside?do=admin&page=styling|Paramètres de style du thème]] (template) à la valeur ''<nowiki>12em</nowiki>'' 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 :
<code>

**[[Le Biohackerspace|]]**
  * [[Accès|]]
  * [[Gouvernance|]]

------
**[[Les activités|]]**
  * Prototypes
  * Ateliers

------

**Hors les murs**

  * [[Hack2eaux|]]

<etc>

</code>

==== 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 [[https://www.dokuwiki.org/plugin:captcha|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 [[https://www.dokuwiki.org/plugin:blockquote|blockquote]] qui permte de mettre en forme les citations dans les pages de ce wiki.
<code>

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

</code>

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


<todo>Améliorer l'esthétique des citations</todo>

===== Indexation des pages =====

==== Étiquettes ====

  * Installation du Module [[https://www.dokuwiki.org/plugin:tag?s[]=tag#tag_plugin|Tag Plugin]]

pour s'en servir, exemple, ajouter en bas d'une page du wiki
<code>

{{tag>Prototype Eaux Rivières}}

</code>

//Ici 3 étiquettes ''Prototype''  ; ''Eaux''  ; ''Rivières''  sont appliquées à la page//

Ce qui fut fait le 22/11/2020 sur la page [[:hors_les_murs:hack2eaux:pieges_a_microplastiques|]], voir la [[https://wiki.kaouenn-noz.fr/hors_les_murs:hack2eaux:pieges_a_microplastiques?do=diff&rev2%5B0%5D=1603300834&rev2%5B1%5D=1606060761&difftype=sidebyside|vue comprative]]

ce qui donne un répertoire par étiquette, grace au module [[https://www.dokuwiki.org/plugin:pagelist|PageList Plugin]], accessible [[https://wiki.kaouenn-noz.fr/tag:prototype?do=showtag&tag=Prototype|ici]]

**À faire pour éviter le bordel et améliorer l'indexation**

<todo #>choisir un nombre limite d'étiquette par page</todo> ⇒ **4 max**

<todo>Établir une liste raisonnable des étiquettes utilisables</todo>

<todo>Appliquer les étiquettes sur les pages du wiki</todo>

<todo>Écrire une courte page dans le wiki pour expliquer la démarche et comment faire</todo>

<todo>Établir un page d'index qui liste les étiquettes (en cours sur [[liste_des_tags]]</todo>

<todo>Indiquer cette indexation en première page du wiki</todo>

<note> Les ToDo listes sont possibles grâce au module [[https://www.dokuwiki.org/plugin:todo?s[]=todo|ToDo]] installé sur notre wiki </note>

==== Typage des documentation ====

<note>

Cet effort provient d'un Essai réflexif — 2019/03/01 − « [[https://sens-public.org/articles/1375/|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//  </note>

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 ( ''<nowiki>{{mon_modèle}}</nowiki>''  avec wikimedia, [[https://movilab.org/wiki/Comment_contribuer_sur_ce_wiki_%3F#Indiquer_le_type_de_documentation_contenu_sur_une_page_movilab|exemple]]). Avec le module [[https://www.dokuwiki.org/plugin:include|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 [[https://wiki.kaouenn-noz.fr/modele:type_tutorielle|ici]], modèle avec le module [[https://www.dokuwiki.org/plugin:wrap|Wrap]], pour l'insérer en début d'une page : ''<nowiki>{{page>modele:type_tutorielle}}</nowiki>''

  * **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 [[:modele:type_guide_pratique|ici]], il s'insère en début page avec ''<nowiki>{{page>modele:type_guide_pratique}}</nowiki>''

  * **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 [[:modele:type_explication|ici]] et il s'insère en début de page tel que ''<nowiki>{{page>modele:type_explication}}</nowiki>''

  * **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 [[:modele:type_guide_reference|ici]], pour l'insérer en haut d'une page de ce wiki : ''<nowiki>{{page>modele:type_guide_reference}}</nowiki>''

<todo #>Finir les modèles de pages pour tous les types</todo>

<todo>Améliorer les modèles</todo>

<todo #>Insérer dans chaque modèle un lien vers le répertoire correspondant à son type</todo>

**Voir aussi**  :

<blockquote>« //Comment j'organise mes notes professionnelles avec Dokuwiki et ses plugins//  » <cite>Jln, sur son blog</cite></blockquote>

==== Création d'un répertoire par type de documentation ====

À l'aide du module [[https://www.dokuwiki.org/plugin:pagequery|PageQuery]]

le code ressemble à (pour exemple du répertoire [[:repertoire:type_tutorielle|Tutorielle]])
<code>

{{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
}}

</code>

Ce qui rend :

{{  :config:repertoire_type_tutorielle_kaouenn-noz_.png  }}

=== Les répertoires ===

  * Le répertoire de [[:repertoire:type_tutorielle|pages contenant de tutoriels]]
  * Le répertoire de [[:repertoire:guide_pratique|pages contenant des guides pratiques]]
  * Le répertoire de [[:repertoire:explication|pages contenant des explications]]
  * Le répertoire de [[:modele:type_guide_reference|pages étant des guides de référence]]

==== Liste des pages orphelines ====

[[:orphans|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 :

<code>

{{nom-de-fichier-image.png}}

</code>

Pour ajouter une légende aux images nous utilisons le greffons [[https://www.dokuwiki.org/plugin:imagereference|Imagereference]]. Il s'utilise ainsi : 

<code>
<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>.
</code>

===== Sous le moteur =====

Ce wiki tourne sur un serveur personnel ([[https://fr.wikipedia.org/wiki/Auto-hébergement_(Internet)|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 :
<file>

FROM php:7.3-apache
RUN a2enmod rewrite

</file>

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

<code>
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 600
max_input_time = 600

</code>

Et enfin la configuration de Apache2 (volume Docker : ''./data/apache2.conf:/etc/apache2/apache2.conf'')

<code>
Timeout 600

</code>