This is an old revision of the document!
Table of Contents
double dashes in monospaced text
use ''%%--%%''
to render --
.
Compare this to ''--''
which renders as a single dash –
Ref:- https://www.dokuwiki.org/wiki:syntax#no_formatting
Extension:
To display an option such as --skip-string-normalization
, use
%%--skip-string-normalization%%
sitemap
useful plugins
- https://www.dokuwiki.org/plugin:tag - add search tags to the wiki pages.
- favorite configuration:
- set tags_list_css to “optimized for tags list at top of page”
- Multiple tags are separated by spaces. If a tag itself contains a space, it should be in quotes. For example
{{tag>"foo bar" baz}}
will set two tags “foo bar” and “baz”.
- https://www.dokuwiki.org/plugin:saveandedit - Adds a checkbox to continue editing after the page is saved.
- https://www.dokuwiki.org/plugin:nspages - to list all pages in a namespace
- https://www.dokuwiki.org/plugin:include - to transclude pages
- Using this to include python_pages as a section in notes
plugins I am exploring
plugins I came across
https://www.dokuwiki.org/tips:book mentions two plugins that are useful for creating books.
conflicting plugins
- https://www.dokuwiki.org/plugin:edittable - seems nice. But it is conflicting with https://www.dokuwiki.org/plugin:wrap . For example, if I have a cell with a list of items, and if I install the edittable plugin and then try to edit that table, the cell contents are not longer rendered as a list.
- Todo:- Try to come up with a small test case and report it upstream.
buggy plugins
- https://www.dokuwiki.org/plugin:keywords - add keywords to the wiki pages
- The keywords are not rendered but you can search on them (expected behaviour).
- issues:
- https://github.com/i-net-software/dokuwiki-plugin-keywords/issues/1 - Key words with spaces are broken into individual words. For example “foo bar” will become “foo, bar”.
- Use https://www.dokuwiki.org/plugin:tag instead. It populates the keywords meta field and does much more.
- https://www.dokuwiki.org/plugin:editsections2 is giving
startSectionEdit: $data "section" is NOT an array! One of your plugins needs an update.
on all the pages.
- Tested using 2012-10-13 version.
issues reported by me
- https://github.com/splitbrain/dokuwiki/issues/3531 - display section numbers in the page and table of contents
remove extra line in lists inside table cells
tags | lists inside table cells wrap plugin
When the WRAP plugin is used to create lists inside table cells, an extra line is added at the end of the list. To remove it, add the following to /etc/dokuwiki/userstyle.css .
div.plugin_wrap ul { margin-bottom: 0px; }
The new setting will be picked up automatically when the page is refreshed.
include code in ordered lists
Put the <code>
tag on the same line of the item. For example
- foo
bar
as opposed to
- foo
bar
links I came across
Useful documentation
- https://www.dokuwiki.org/namespaces has answers for
- How to create new namespaces?
- https://www.dokuwiki.org/wiki:syntax#quoting - quote some text. You can have other stuff like bold text, monospaced text etc., within the quoted text
- https://www.dokuwiki.org/wiki:syntax#basic_text_formatting - format text as bold, italic, underlined and monospaced
- https://www.dokuwiki.org/install:permissions - Which folders need to be set with what permissions?
documentation links I came across
- https://www.dokuwiki.org/faq:lists has answers for
- How to put line breaks in lists?
multiple lines in table cell
Install the wrap plugin and do something like
^ days ^ months ^ | <WRAP> * Sunday * Monday </WRAP> | <WRAP> * January * February * March </WRAP> | | <WRAP> * Tuesday * Wednesday </WRAP> | <WRAP> * April * May </WRAP> |
which will give
days | months |
---|---|
|
|
|
|
Ref:-
Questions to look into
- Is it possible to persist the breadcrumbs across user sessions? For example, the breadcrumbs are lost if I close the chrome browser and reopen it. Is it possible to preserve them even in such cases?