Kaouenn-noz

Outils pour utilisateurs

Outils du site

Piste :
config:doc

Différences

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

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
config:doc [2021/01/20 18:06] – [Étiquettes] de 3 à 4 étiquettes xavccconfig:doc [2022/11/17 08:15] (Version actuelle) – ajout de nouvel espace d'explication xavcc
Ligne 11: Ligne 11:
 ==== Barre de menu gauche ==== ==== 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 ''%%12em%%'' dans Largeur de la barre latérale, si existante (dans une unité de longueur valide: %, px, em,...).+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+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 : Pour un confort de lecture elle est éditorialisée ainsi :
- 
 <code> <code>
-**[[Le Biohackerspace]]** + 
-  * [[Accès]] +**[[Le Biohackerspace|]]** 
-  * [[Gouvernance]]+  * [[Accès|]] 
 +  * [[Gouvernance|]]
  
 ------ ------
- +**[[Les activités|]]**
-**[[Les activités]]**+
   * Prototypes   * Prototypes
   * Ateliers   * Ateliers
Ligne 32: Ligne 31:
 **Hors les murs** **Hors les murs**
  
-  * [[Hack2eaux]]+  * [[Hack2eaux|]]
  
 <etc> <etc>
 +
 </code> </code>
  
Ligne 43: Ligne 43:
 ==== Dispositif anti Spam ==== ==== 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. +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 ===== ===== Indexation des pages =====
Ligne 52: Ligne 78:
  
 pour s'en servir, exemple, ajouter en bas d'une page du wiki pour s'en servir, exemple, ajouter en bas d'une page du wiki
- 
 <code> <code>
 +
 {{tag>Prototype Eaux Rivières}} {{tag>Prototype Eaux Rivières}}
 +
 </code> </code>
  
-//Ici 3 étiquettes ''Prototype'' ; ''Eaux'' ; ''Rivières'' sont appliquées à la page//+//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 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]] 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]]
Ligne 65: Ligne 92:
 **À faire pour éviter le bordel et améliorer l'indexation** **À faire pour éviter le bordel et améliorer l'indexation**
  
-<todo #>choisir un nombre limite d'étiquette par page</todo> => **4 max**+<todo #>choisir un nombre limite d'étiquette par page</todo> ⇒ **4 max**
  
-<todo>Établir une liste raisonnable des étiquettes</todo>+<todo>Établir une liste raisonnable des étiquettes utilisables</todo>
  
 <todo>Appliquer les étiquettes sur les pages du wiki</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>É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> <todo>Indiquer cette indexation en première page du wiki</todo>
  
-<note> +<note> Les ToDo listes sont possibles grâce au module [[https://www.dokuwiki.org/plugin:todo?s[]=todo|ToDo]] installé sur notre wiki </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 ==== ==== Typage des documentation ====
Ligne 83: Ligne 110:
 <note> <note>
  
-Cet effort provient d'un Essai réflexif — 2019/03/01 − +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>
-« [[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. 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]]+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** 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**
Ligne 97: Ligne 122:
   * **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 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 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’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>''+  * **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 #>Finir les modèles de pages pour tous les types</todo>
- 
  
 <todo>Améliorer les modèles</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>+<todo #>Insérer dans chaque modèle un lien vers le répertoire correspondant à son type</todo>
  
-**Voir aussi** :+**Voir aussi**  :
  
-<blockquote>« //Comment j'organise mes notes professionnelles avec Dokuwiki et ses plugins// » +<blockquote>« //Comment j'organise mes notes professionnelles avec Dokuwiki et ses plugins//  » <cite>Jln, sur son blog</cite></blockquote>
-<cite>Jln, sur [[https://blog.chezjln.xyz/comment-jorganise-mes-notes-professionnelles-avec-dokuwiki-et-ses-plugins|son blog]]</cite> +
-</blockquote>+
  
 +==== Création d'un répertoire par type de documentation ====
  
-===== Mise en forme du texte =====+À l'aide du module [[https://www.dokuwiki.org/plugin:pagequery|PageQuery]]
  
-Installation du module [[https://www.dokuwiki.org/plugin:blockquote|blockquote]] qui permte de mettre en forme les citations dans les pages de ce wiki.+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> <code>
-<blockquote> 
-Ne jamais croire un citation partagée sur Internet 
  
-<cite>Apocryphe, "Dans les ZinternetS", Act 0 scene 2</cite> +{{nom-de-fichier-image.png}}
-</blockquote>+
  
-Qui disait aussi <q>C'est ça la vie!</q> et se carapata. 
 </code> </code>
  
-<blockquote> +Pour ajouter une légende aux images nous utilisons le greffons [[https://www.dokuwiki.org/plugin:imagereference|Imagereference]]. Il s'utilise ainsi :  
-« //Ne jamais croire un citation partagée sur Internet// »+ 
 +<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>
  
-<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> 
config/doc.1611165997.txt.gz · Dernière modification : 2021/05/28 13:33 (modification externe)