Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
blog:dokuwiki [2020/01/07 21:19] tom |
blog:dokuwiki [2020/02/03 02:23] tom |
||
---|---|---|---|
Line 11: | Line 11: | ||
<code>/* https://www.dokuwiki.org/plugin:indexmenu */</code> | <code>/* https://www.dokuwiki.org/plugin:indexmenu */</code> | ||
The comment links to the documentation for the plugin. I will only see the comment while editing the page. | 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 <abbr title="User Interface">UI</abbr>), and may include several themes to choose from. | ||
+ | == Sites that use dark themes == | ||
+ | TODO | ||
+ | |||
+ | |||
=== Groups, Creating User Groups === | === Groups, Creating User Groups === | ||
* They get created when the first user gets added to a new group | * They get created when the first user gets added to a new group | ||
Line 19: | Line 25: | ||
* Plugins are enabled by default (i.e., there is no "enable" option for newly-installed 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 | * 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 === | === 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. | * Use [[doku>tips:findbadphp.php|this script]] to find corrupted PHP files. Place it in your wiki root and call it from your browser. | ||
Line 32: | Line 40: | ||
===== Plugins ===== | ===== Plugins ===== | ||
- | DokuWiki has a huge number of [[doku>plugins|plugins]]. 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. | + | 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 === | === 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!" | 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!" | ||
Line 45: | Line 60: | ||
</dtable> | </dtable> | ||
---- | ---- | ||
- | === Code Enhancement Plugin === | + | === Code Syntax Plugin === |
- | The [[doku>plugin:code|code]] plugin provides enhancements for the normal <nowiki><code></nowiki> syntax. | + | The [[doku>plugin:code2|code]] plugin provides enhancements for the normal <nowiki><code></nowiki> syntax. |
This wiki markup: | This wiki markup: | ||
Line 62: | Line 77: | ||
</code> | </code> | ||
- | Note that this plugin merely enables the "php sample" heading for the above code. The syntax highlighting is a built-in function of DokuWiki. | + | FIXME - finish updating the comments/notes/usage |
---- | ---- | ||
=== CodeMirror Plugin === | === CodeMirror Plugin === | ||
- | The [[doku>plugin:codemirror|CodeMirror]] plugin provides enhancements for the wiki editor. | + | 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: | Without CodeMirror, the editor looks like this: | ||
- | {{ :blog:codemirror-without.png?400 |}} | + | {{ :codemirror-without.png?600 |}} |
With CodeMirror, it looks like this: | With CodeMirror, it looks like this: | ||
- | {{ :blog:codemirror-with.png?400 |}} | + | {{ :codemirror-with.png?600 |}} |
---- | ---- | ||
=== Discussion Plugin === | === Discussion Plugin === | ||
The [[doku>plugin:discussion|discussion]] plugin is used by the [[doku>template:bootstrap3|bootstrap3]] template. | The [[doku>plugin:discussion|discussion]] plugin is used by the [[doku>template:bootstrap3|bootstrap3]] template. | ||
- | + | ---- | |
=== iFrame Plugin === | === iFrame Plugin === | ||
Line 87: | Line 101: | ||
This sample shows the iframe plugin's documentation page: | This sample shows the iframe plugin's documentation page: | ||
- | {{url>doku>plugin:iframe}} | + | {{url>https://www.dokuwiki.org/plugin:iframe}} |
---- | ---- | ||
=== Linkback Plugin === | === Linkback Plugin === | ||
Line 93: | Line 107: | ||
The [[doku>plugin:linkback|Linkback]] plugin is used by the [[doku>template:bootstrap3|bootstrap3]] template. It adds Trackback and Pingback support to DokuWiki. | 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 === | === Pagelist Plugin === | ||
The [[doku>plugin:pagelist|pagelist]] plugin is used by other plugins. | The [[doku>plugin:pagelist|pagelist]] plugin is used by other plugins. | ||
+ | === Tip Plugin === | ||
+ | |||
+ | <tip> | ||
+ | right aligned text | ||
+ | </tip> | ||
+ | |||
+ | <tip l> | ||
+ | left aligned text | ||
+ | </tip> | ||
+ | |||
+ | <tip c> | ||
+ | some centered text | ||
+ | </tip> | ||
+ | |||
+ | <tip d> | ||
+ | down text, right aligned | ||
+ | </tip> | ||
+ | |||
+ | <tip u> | ||
+ | up text, right aligned | ||
+ | </tip> | ||
+ | |||
+ | <tip h> | ||
+ | right aligned hint text | ||
+ | </tip> | ||
+ | |||
+ | <tip i> | ||
+ | right aligned information text | ||
+ | </tip> | ||
+ | |||
+ | <tip n> | ||
+ | right aligned note text | ||
+ | </tip> | ||
+ | |||
+ | <tip w> | ||
+ | right aligned warning text | ||
+ | </tip> | ||
+ | |||
+ | <tip l n d> | ||
+ | left aligned note down | ||
+ | </tip> | ||
+ | |||
+ | |||
+ | {{tag>wiki dokuwiki plugin}} |