====== Truces & Astuces ======
**Je met ici des informations glanées ça et là**

===== Syntaxe =====
Les exemples de [[wiki:syntax|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:\\ <code>{{ wiki:dokuwiki-128.png?40 }}</code>{{ wiki:dokuwiki-128.png?40 }}
  * Il suffit d'ajouter //nolink// dans les paramètres de l'image pour l'avoir telle quelle:\\ <code>{{ wiki:dokuwiki-128.png?nolink&40 }}</code>{{ 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:\\ <code>exe     application/octet-stream</code>
  * **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:<code css>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;
}</code>
    * 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:<code css>@media screen and (max-width: 700px) { 
    #dokuwiki__site > .site {
        padding-right: 0px;
        padding-left: 0px;
    }
}</code>
    * 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 ===
    * **[[http://www.dokuwiki.org/plugin:discussion|Discussion]]**: Permet d'ajouter un fil de discussion dans un article de Dokuwiki. Ajoutez juste ''%%~~DISCUSSION~~%%'' dans le corps de l'article.
<hidden 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 ''|''.
<code>
~~DISCUSSION|Custom Title String~~
~~DISCUSSION:closed|Custom Title String~~
</code>
**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.
<code>
{{threads>[namespace]&[count=n]&[flags]&skipempty}}
</code>
cf [[http://www.dokuwiki.org/plugin:discussion|Discussion]] pour plus de détails
</hidden>

    * **[[http://www.dokuwiki.org/plugin:note|Note]]**: Pour mettre en valeur des notes, warning, etc. Simple et pratique.
      * Exemple:
<note>Ceci est une note.</note>
<hidden Usage>
<code>
<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>
</code>

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>

    * **[[http://www.dokuwiki.org/plugin:hidden|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é).
<hidden 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 text|use 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 hidden|see 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| |
|-noprint|the 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| |
|-edit|Same 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:
<code>
<hidden>My first hidden block</hidden>
<hidden>My second hidden block</hidden>

<hiddenSwitch>
</code>
Note: this feature used to be provided by a separate plugin. However, since "hidden v2015-08-12", they have been merged
</hidden>

    * **[[http://www.dokuwiki.org/plugin:keyboard|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:<code css>kbd {
   background-color: #F2F2F2 !important;
   border-style: outset;
   border-width: 3px;
   border-radius: 0.3em;
   padding : 0px 2px 0px 2px !important;
}</code>
      * 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>.
    * **[[https://www.dokuwiki.org/plugin:tokenbucketauth|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
    * **[[https://www.dokuwiki.org/plugin:unusedmedias|UnusedMedia]]**: Affiche la liste des pages orphelines et des médias non utilisés.