Outils pour utilisateurs

Outils du site


wiki:trucs-actuces

Truces & Astuces

Je met ici des informations glanées ça et là

Syntaxe

Les exemples de Formatting Syntax ne montrent pas tout.

Afficher des images sans lien

  • Par défaut, une image est un lien vers les infos de l'image:
    {{ wiki:dokuwiki-128.png?40 }}

  • Il suffit d'ajouter nolink dans les paramètres de l'image pour l'avoir telle quelle:
    {{ wiki:dokuwiki-128.png?nolink&40 }}

Informations copiées d'autres sites

sebsauvage

Référence: http://sebsauvage.net/wiki/doku.php?id=dokuwiki
J'ai modifié certains points (notamment supprimé des plugins) d'après mes goûts.

  • Le gestionnaire de fichiers n'autorise l'upload que des fichiers d'un certain type (png, jpg…). Pour autoriser l'upload d'autres types, il faut créer le fichier /conf/mime.local.conf et y ajouter les types voulus. Exemple:
    exe     application/octet-stream
  • Supprimer une page: Comme vous l'aurez remarqué, pas de bouton “supprimer cette page”. En fait il faut faire “editer la page”, sélectionner tout le texte, supprimer et faire “Enregistrer”. Enregistrer un texte vide a pour effet de supprimer la page.
  • Déplacer une page: Il n'est pas actuellement possible de déplacer un document d'un namespace à un autre, encore moins en corrigeant automatiquement tous les liens qui pointent dessus. Il faut re-créer la page. C'est un des aspects un peu lourds de DokuWiki (même si c'est pas bien grave).
  • DokuWiki chez free.fr: DokuWiki ne fonctionne tel quel pas chez Free (*.free.fr). Il est nécessaire de le patcher. Les infos devraient se retrouver en googlant.
  • Changer les CSS de votre DokuWiki.
    • Pour cela, pas besoin de toucher au thème: Contentez-vous de créer un fichier /conf/userstyle.css et mettez-y ce que vous voulez, par exemple:
      body {
         font-family: "Droid Sans","Noto Sans","Ascender Uni","Linotype Aroma","FF Kievit","Source Sans","Open Sans","Museo Sans","Myriad","Camphor","Corbel","Frutiger","Vectora","Calibri","Ubuntu","Roboto",sans-serif;
      }
    • Cette feuille de style survivra aux mises à jour DokuWiki.
    • (Je ne suis pas fan d'Arial)
  • Retirer les marges gauche/droite sur les petits écrans:
    • Dans mon userstyle.css, j'ajoute:
      @media screen and (max-width: 700px) { 
          #dokuwiki__site > .site {
              padding-right: 0px;
              padding-left: 0px;
          }
      }
    • Pour voir le résultat, diminuez la largeur de la fenêtre du navigateur: En dessous d'une certaine largeur, ça retirer les marges gauche et droite. C'est plus sympa pour les petits écrans.

Plugins intéressants

  • Discussion: Permet d'ajouter un fil de discussion dans un article de Dokuwiki. Ajoutez juste ~~DISCUSSION~~ dans le corps de l'article.

Usage

Usage

To turn it off, use ~~DISCUSSION:off~~.

If you want to show the existing discussion but don't want to allow new comments / replies, use ~~DISCUSSION:closed~~.

A custom title can be appended after the separator |.

~~DISCUSSION|Custom Title String~~
~~DISCUSSION:closed|Custom Title String~~

Threads syntax

This displays a list of all pages of the given namespace with a discussion section. The list is sorted by the most recent comment.

{{threads>[namespace]&[count=n]&[flags]&skipempty}}

cf Discussion pour plus de détails

  • Note: Pour mettre en valeur des notes, warning, etc. Simple et pratique.
    • Exemple:
Ceci est une note.

Usage

Usage

<note>
This is my note ! Remember it!!
</note>

<note important>
Warning ! You're about to lose your mind ;-)
</note>

<note tip>
The clues are in the images.
</note>

<note warning>
Beware of the cat when you open the door !!
</note>

You can use the note keywords important, warning and tip. Or some French synonyms: importante(important), bloquante, critique (warning), tuyau, idée (tip), classique (classic). It is quite easy to add new types of notes if you know a bit of PHP and CSS.
Plugin won't work inside numbered list

  • Hidden: collapse une zone qu'on peut agrandir en cliquant dessus (genre “spoiler”). Pratique pour publier de longs texte ou sources dans une page sans avoir à faire une page à côté).

Usage

Usage

The simplest way is:

<hidden>Hidden text</hidden>

This will display the default text “Click to display ⇲” when the text is hidden, and “Click to hide ⇱” when it's visible.

Some options may be added inside the opening <hidden> tag:

Option Effect Example
any textuse this text instead of the defaults “Click to display” and “Click to hide” <hidden click me!>hidden text</hidden>
onHidden=“any text”Display this text when the section is hiddensee below
onVisible=“any text”Display this text when the section is unfolded<hidden onHidden=“Click to read more” onVisible=“Click to see less”>Hidden text</hidden>
onExportPdf=“any text”Display this text when the page is dw2pdf exported in pdf (defaults to the onVisible text)<hidden onExportPdf=“you're reading a pdf, you can't click me”>hidden text</hidden>
initialState=“visible”The block will initially be expanded. Readers may still click to hide it
-noprintthe text “click to display” won't appear on the printed copy
-edit=“any text”Add an “edit” button below the hidden section.The text will appear when one let his mouse on the button
-editSame as above, but a default text is used

Please note that Dokuwiki formatting syntax may be used with options like “onHidden”. It's possible to add a button that will hide/display every hidden blocks at once using:

<hiddenSwitch>

or

<hiddenSwitch Here comes my custom text>

Therefore, to see it in action, you could create such a page:

<hidden>My first hidden block</hidden>
<hidden>My second hidden block</hidden>

<hiddenSwitch>

Note: this feature used to be provided by a separate plugin. However, since “hidden v2015-08-12”, they have been merged

  • Keyboard: permet d'afficher les touches de clavier. Pratique pour les tutoriels.
    • Exemple: <key>C-c</key>
    • Customiser l'apparence des touches comme ceci <key>K</key>, dans /conf/userstyle.css, ajouter à la fin:
      kbd {
         background-color: #F2F2F2 !important;
         border-style: outset;
         border-width: 3px;
         border-radius: 0.3em;
         padding : 0px 2px 0px 2px !important;
      }
    • Notez que par défaut ce plugin fait des substitutions et met en majuscules. Entourez votre texte de simple quotes pour qu'il ne soit pas modifié. Exemples: C-c-Right donne <key>C-c-Right</key>, t donne <key>t</key>, mais 't' donne <key>'t'</key>.
  • tokenbucketauth: Banni une adresse IP si elle fait trop de tentatives de connexion sur le formulaire de login.
    • Astuce: Si vous vous êtes vous-même bloqué(e), voici comment réinitialiser le blocage (je me note ça, car j'oublie tout le temps), supprimez les 3 fichiers suivants:
      • /dokuwiki/data/cache/block.pbf
      • /dokuwiki/data/cache/lock.pbf
      • /dokuwiki/data/cache/users.pbf
  • UnusedMedia: Affiche la liste des pages orphelines et des médias non utilisés.
wiki/trucs-actuces.txt · Dernière modification: 2017/08/07 23:56 (modification externe)