Ci-dessous, les différences entre deux révisions de la page.
Prochaine révision | Révision précédente | ||
wiki:trucs-actuces [2017/08/02 18:30] Grand Dub Truces & Astuces |
wiki:trucs-actuces [2017/08/07 23:56] (Version actuelle) |
||
---|---|---|---|
Ligne 34: | Ligne 34: | ||
=== Plugins intéressants === | === 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. | * **[[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. | * **[[http://www.dokuwiki.org/plugin:note|Note]]**: Pour mettre en valeur des notes, warning, etc. Simple et pratique. | ||
* Exemple: | * Exemple: | ||
<note>Ceci est une note.</note> | <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é). | * **[[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é). | ||
- | * Exemple: | + | <hidden Usage> |
- | <hidden Cliquez-moi pour ouvrir et fermer> | + | The simplest way is: |
- | Coucou ! Je suis une note cachée. | + | <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> | </hidden> | ||
+ | |||
* **[[http://www.dokuwiki.org/plugin:keyboard|Keyboard]]**: permet d'afficher les touches de clavier. Pratique pour les tutoriels. | * **[[http://www.dokuwiki.org/plugin:keyboard|Keyboard]]**: permet d'afficher les touches de clavier. Pratique pour les tutoriels. | ||
* Exemple: <key>C-c</key> | * Exemple: <key>C-c</key> |