aboutsummaryrefslogtreecommitdiff
path: root/underlays/basewiki/directive/toc.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'underlays/basewiki/directive/toc.mdwn')
-rw-r--r--underlays/basewiki/directive/toc.mdwn19
1 files changed, 19 insertions, 0 deletions
diff --git a/underlays/basewiki/directive/toc.mdwn b/underlays/basewiki/directive/toc.mdwn
new file mode 100644
index 000000000..e499ee824
--- /dev/null
+++ b/underlays/basewiki/directive/toc.mdwn
@@ -0,0 +1,19 @@
+The `toc` directive is supplied by the [[!iki plugins/toc]] plugin.
+
+Add a table of contents to a page:
+
+ \[[!toc ]]
+
+The table of contents will be automatically generated based on the
+headers of the page. By default only the largest headers present on the
+page will be shown; to control how many levels of headers are shown, use
+the `levels` parameter:
+
+ \[[!toc levels=2]]
+
+The toc directive will take the level of the first header as the topmost
+level, even if there are higher levels seen later in the file.
+
+The table of contents will be created as an ordered list. If you want
+an unordered list instead, you can change the list-style in your local
+style sheet.