summaryrefslogtreecommitdiff
path: root/doc/plugins/wikitext.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'doc/plugins/wikitext.mdwn')
-rw-r--r--doc/plugins/wikitext.mdwn21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/plugins/wikitext.mdwn b/doc/plugins/wikitext.mdwn
new file mode 100644
index 000000000..5c5383fc5
--- /dev/null
+++ b/doc/plugins/wikitext.mdwn
@@ -0,0 +1,21 @@
+This plugin allows ikiwiki to process pages written in the original wiki
+text format. To use it, you need to have the Text::WikiFormat perl module
+installed, enable the plugin, then files with the extention `.wiki` will be
+processed as wiki text.
+
+Wiki formatting is very simple. An item wrapped in three single quotes is
+strong. An item wrapped in two single quotes is emphasized. Any word with
+multiple CapitalLetters (e. g., StudlyCaps) will become a link (standard
+[[WikiLinks|WikiLink]] work too). Four or more
+hyphen characters at the start of a line create a horizontal line.
+Newlines turn into the appropriate tags. Headers are matching equals signs
+around the header text -- the more signs, the lesser the header.
+
+Lists are indented text, by one tab or four spaces. In unordered lists,
+where each item has its own bullet point, each item needs a leading
+asterisk and space. Ordered lists consist of items marked with combination
+of one or more alphanumeric characters followed by a period and an optional
+space. Any indented text without either marking is code, handled literally.
+You can nest lists.
+
+This plugin is included in ikiwiki, but is not enabled by default.