kettek2/wiki/software/dokuwiki-plugins.qwk

59 lines
2.4 KiB
Plaintext

# DokuWiki Plugins
----
[[toc]]
----
## folding@wiki
* **Year:** 2013
* **Download:** [v1.0](dokuwiki-plugins/foldingatwiki_v1.0.tgz)
[![dokuwiki-plugins/foldingatwiki.png](dokuwiki-plugins/foldingatwiki.png)](dokuwiki-plugins/foldingatwiki.png)
### What & Why
**folding@wiki** is an action plugin that provides syntax for folding/hiding entire sections of text using only CSS! It runs some heavy processing during 'RENDERER_CONTENT_POSTPROCESS', so as to allow for folding already rendered text :) **Note:** due to this processing and my own limitations of mind, there may be bugs when combined with other plugins or particularly complicated wikisyntax - I did not experience any such problems, but just so you know!
For those experienced with CSS tricks, this basically uses the method that CSS-based drop-down menus generally use - simply have a container element that changes the properties of a contained element via its :hover style(e.g., display:none; and display:block).
It was created due to there being no (in my opinion) good folding plugins for DokuWiki, as they either required JavaScript or did not process dokuwiki syntax.
### Usage
Syntax-wise, there are four basic things to keep in mind:
* 1: DokuWiki syntax is fully supported, both in the FOLDs and in the FOLD's title line. :)
* 2: Begin a fold with `<FOLD` on its own line.
* 2.1: You can give a title to the fold: `<FOLD My Fold`
* 3: End a fold section with `FOLD>`.
Folding behaviors such as absolutely positioned "popups" or folds that simply overlay themselves rather than pushing DOM around can be done via the plugin's `style.css`.
### Example
Wiki syntax example:
<FOLD **My Menu**
* My First Link
* My Second Link :D
FOLD>
HTML output (formatted for readability):
<div class="foldingatwiki__fold">;
<div class="foldingatwiki__fold_title"><strong>My Menu</strong></div>
<span>
<ul>
<li class="level1"><div class="li"> My First Link</div>
</li>
<li class="level1"><div class="li"> My Second Link :D</div>
</li>
</ul>
</span>
</div>
## mandates
* **Year:** 2013
* **Download:** [v1.0](dokuwiki-plugins/dokuwiki-mandates-20130420.tgz)
Mandates is a wiki plugin that provides a dictionary/rules system wherein you can dynamically link to a defined "mandate" from any other page. See the README for more usage.