User Tools

Site Tools


dokuwiki

DokuWiki

Setup

Just noticed that my date's been set wrong. Fixing was easy enough, see: tips:timezone.

Customising

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

Customising the shortcuts and icons for interwiki links involves three steps:

  1. Add the shortcut and syntax to conf/interwiki.local.conf,
  2. Add a 16×16 GIF or PNG image with the same name as your shortcut to lib/images/interwiki/,
  3. 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:csv - Takes CSV files (or TSV) and displays them as wiki tables.
  • 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: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:folded - Hide and reveal section, like using the HTML details element.
  • 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.txt · Last modified: 2024/08/31 14:49 by rjt