Table of Contents
DokuWiki
Setup
Just noticed that my date's been set wrong. Fixing was easy enough, see: tips:timezone.
Customising
Sidebar
If your template supports it, you can add a 'sidebar' by creating a page called 'sidebar' and adding something to it. A common thing to do is use the indexmenu plugin to display a list of pages.
If you use the tag plugin the sidebar goes missing on tag pages. A workround for this is to edit your wiki's theme, which is what controls when the sidebar appears.
For the default theme, find a line that says
$showSidebar = $hasSidebar && ($ACT=='show');
And tell it to also display the sidebar on pages that use showtag
, so it reads:
$showSidebar = $hasSidebar && ($ACT=='show' || $ACT == 'showtag');
See also: dokufreaks/plugin-tag/issues/125
Interwiki Links
Customising the shortcuts and icons for interwiki links involves three steps:
- Add the shortcut and syntax to
conf/interwiki.local.conf
, - Add a 16×16 GIF or PNG image with the same name as your shortcut to
lib/images/interwiki/
, - Refresh the wiki's cache by running
rm -rf data/cache/*/*.{gif,png,css}
from the wiki's base directory.
※ I think it looks best if you don't fill the bottom two pixels of your icon, so they sit on the same line as the text.
See Also
Interesting Plug-ins
- plugin:table2csv - Export dokuwiki tables as CSV.
- plugin:edittable - Nicer table editor, though I never end up using it…
- plugin:sortablejs - Sort data in tables.
- plugin:explain - Add a glossary.
- plugin:dir - Generates a list of pages in a namespace.
- plugin:pagelist - 〃
- plugin:indexmenu - Also generates a list (in the form of a tree) of pages.
- plugin:imagebox - MediaWIki-style image captions.
- plugin:backlinks - Shows list of pages that link to the current page. 'Backlinks' are already built-in to dokuwiki, this is just a different way of presenting it. Default is as a regular list, but I've style it a bit nicer and put it in the footer here.
- plugin:tag - Tags! Also works with pagelist plug-in to insert lists of pages depending on how they're tagged.
- plugin:move - Makes it easy to move and rename pages and files without destroying edit history.
- plugin:cloud - Generate 'clouds' of tags and popular words.
- plugin:footer - Insert stuff below the regular page contents. Used on this wiki to show a bunch of tags with the plugin:cloud plugin, and backlinks.
- plugin:cssperpage - Was thinking of making something like this myself. Seems useful if you want to use Dokuwiki to make a homepage, but I'm not fond of this implementation.
- plugin:confmanager - I haven't tried this, but seems to be an interface for changing things like interwiki links and abbreviations, without having to get into your server.
- plugin:stale - Easily refresh the wiki's cache. Handy after you've updated the footer, for example.
- plugin:diagram - Elaborate, grid-based diagrams, with a table-like syntax.
- plugin:flowcharts - Generate different kinds of flowcharts, with Mermaid syntax.
- plugin:custombuttons - Lets you add buttons that insert snippets of text. Easy to setup.
- plugin:snippets - Like custombuttons above, but can also use transclusion, so snippets can be updated when the main one is changed.
See Also
- dokuwiki-tweaks-rjt - This wiki's customisations on Tildegit.