Outils pour utilisateurs

Outils du site


config:doc

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

  • 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

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
Vous pourriez laisser un commentaire si vous étiez connecté.
config/doc.txt · Dernière modification : 2022/11/17 08:15 de xavcc