====== DokuWiki ======
This blog was created using [[doku>|DokuWiki]] (DW).
----
===== DokuWiki Tips =====
=== Cache ===
* Adding [&|?]purge=true to the end of a DokuWiki URL will refresh the DW cache. This is often needed to make the page recognize a recent change to a wiki setting.
* Saving the Configuration Settings page (at yourwiki.com/doku.php?id=doku.php&do=admin&page=config) will also refresh the DW cache.
=== Comments ===
* If you include the [[doku>plugin:comment|comment]] plugin in your wiki, then you can create "documentation" that only editors can see. For example, my sidebar has this wiki markup:
/* https://www.dokuwiki.org/plugin:indexmenu */
The comment links to the documentation for the plugin. I will only see the comment while editing the page.
=== Dark Themes ===
I like dark themes. Please note that a theme is not the same thing as a template. A theme only changes the colors of a website. A template changes the look and feel (the UI), and may include several themes to choose from.
== Sites that use dark themes ==
TODO
=== Groups, Creating User Groups ===
* They get created when the first user gets added to a new group
=== Namespaces ===
* A "namespace" is just a folder structure. Just like folders on your computer, a namespace can contain another namespaces.
* To create a new namespace, create a page with a colon in the name (namespace:pagename)
=== Plugins ===
* Plugins are enabled by default (i.e., there is no "enable" option for newly-installed plugins)
* there is a "disabled" list in dokuwiki\conf\plugins.local.php
=== Settings ===
* Settings are viewed or changed via the Configuration Settings page (at yourwiki.com/doku.php?id=doku.php&do=admin&page=config). Those settings get stored in conf/local.php.
=== Troubleshooting ===
* Use [[doku>tips:findbadphp.php|this script]] to find corrupted PHP files. Place it in your wiki root and call it from your browser.
----
===== Templates =====
The [[doku>template:bootstrap3|bootstrap3]] template provides the UI for this blog. It is a highly customizable Bootstrap-based template for DokuWiki. The template is responsive and is designed for all devices (mobile, tablet, desktop, etc).
----
===== Themes =====
The [[doku>template:bootstrap3|bootstrap3]] template has built-in support for several themes. Currently, this blog uses the [[https://bootswatch.com/3/|bootswatch]] theme called [[https://bootswatch.com/3/darkly/|darkly]].
----
===== Plugins =====
DokuWiki has a huge number of [[doku>plugins|plugins]]. Plugins provide a system of extending DokuWiki's features without the need to hack the original code.
Most plugins can be installed with the push of a button by searching for and installing the plugin via the [[doku>plugin:extension|extension manager]].
There are so many plugins available that there are often several plugins that do similar functions. So if you find one that doesn't quite work the way you want it to work, look for a different one. And because there are so many plugins, they often conflict with each other. For example, one of my usage requirements is a color-coded editor, such as the [[doku>plugin:codemirror|CodeMirror]] plugin (see [[dokuwiki#CodeMirror Plugin|screenshots]] below). Since that plugin conflicts with [[doku>plugin:fastwiki|fastwiki]], I can't use fastwiki in this blog.
Below are the plugins used by this blog. If the plugin enables specific wiki markup, I include both a sample of the markup itself, and a sample of the output of that markup.
----
=== Abbreviations ===
DokuWiki has built-in support for tooltip-style definitions. For example, rest your cursor over any these words: BTW, FAQ, HTML, WYSIWYG, EOF. The downside to this approach is that you have to edit a text file that lives on the DW server to add new entries to the list. As Captain Hook would say, "bad form!"
There are several plugins that make tooltips easier to use, but only [[doku>plugin:abbr|abbr]] appears to have a toolbar button.
^ Plugin ^ Syntax ^ Example ^
|[[doku>plugin:acronym|plugin:acronym]]|Type acronym to create a text “acronym” with an explanation “explanation”.|U of M|
|[[doku>plugin:tooltip|plugin:tooltip]]|Simple form: {!word:tooltip_text}} This plugin also supports a more detailed/complex form that lets you use custom styles.|{!simple:a simple example}}|
|[[doku>plugin:abbr|plugin:abbr]]|Put popup text here (Option 1)\\ Option 2 [Put popup text here]\\ Option 3|Put popup text here (Option 1)\\ Option 2 [Put popup text here]\\ Option 3|
----
=== Code Syntax Plugin ===
The [[doku>plugin:code2|code]] plugin provides enhancements for the normal
function getType(){ return 'protected';}
function getPType(){ return 'block';}
FIXME - finish updating the comments/notes/usage
----
=== CodeMirror Plugin ===
The [[doku>plugin:codemirror|CodeMirror]] plugin provides enhancements for the wiki editor, such as syntax highlighting, and searching via CTRL+F (CMD+F on a Mac).
Without CodeMirror, the editor looks like this:
{{ :codemirror-without.png?600 |}}
With CodeMirror, it looks like this:
{{ :codemirror-with.png?600 |}}
----
=== Discussion Plugin ===
The [[doku>plugin:discussion|discussion]] plugin is used by the [[doku>template:bootstrap3|bootstrap3]] template.
----
=== iFrame Plugin ===
The [[doku>plugin:iframe|iframe]] plugin allows external URLs to be loaded into an iframe in your DokuWiki page.
{{url>https://www.dokuwiki.org/plugin:iframe}}
This sample shows the iframe plugin's documentation page:
{{url>https://www.dokuwiki.org/plugin:iframe}}
----
=== Linkback Plugin ===
The [[doku>plugin:linkback|Linkback]] plugin is used by the [[doku>template:bootstrap3|bootstrap3]] template. It adds Trackback and Pingback support to DokuWiki.
----
=== Pagelist Plugin ===
The [[doku>plugin:pagelist|pagelist]] plugin is used by other plugins.
=== Tip Plugin ===
right aligned text
left aligned text
some centered text
down text, right aligned
up text, right aligned
right aligned hint text
right aligned information text
right aligned note text
right aligned warning text
left aligned note down
{{tag>wiki dokuwiki plugin}}