update with new features to deal with large sites

[git.ikiwiki.info.git] / doc / ikiwiki / formatting.mdwn

diff --git a/doc/ikiwiki/formatting.mdwn b/doc/ikiwiki/formatting.mdwn
index 29dbce181563ce00af528ffe1cc9918e8da87e49..befbce9aa421b3255bf8bb4012c898e38030e1b9 100644 (file)
--- a/doc/ikiwiki/formatting.mdwn
+++ b/doc/ikiwiki/formatting.mdwn
@@ -7,7 +7,7 @@ called [[MarkDown]], and it works like this:
 
 Leave blank lines between paragraphs.
 
 
 Leave blank lines between paragraphs.
 

-You can \**emphasise*\* or \*\***strongly emphasise**\*\* text by placing it
+You can *\*emphasise\** or **\*\*strongly emphasise\*\*** text by placing it

 in single or double asterisks.
 
 To create a list, start each line with an asterisk:
 in single or double asterisks.
 
 To create a list, start each line with an asterisk:


@@ -70,26 +70,37 @@ you use the following additional features:
        \[[!wikipedia War\_of\_1812]]
 """]]
 
        \[[!wikipedia War\_of\_1812]]
 """]]
 

+[[!if test="enabled(template) and templates" then="""
+* Create and fill out [[templates]] for repeated chunks of
+  parameterized wiki text.
+"""]]
+
+* Insert various [[directives|directive]] onto a page to perform useful
+  actions.
+[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then="""
+  For example, you can:
+"""]]
+

 [[!if test="enabled(toc)" then="""
 [[!if test="enabled(toc)" then="""

-* Add a table of contents to a page:
+  * Add a table of contents to a page:

 
 

-       \[[!toc ]]
+       \[[!toc]]

 """]]
 
 
 [[!if test="enabled(meta)" then="""
 """]]
 
 
 [[!if test="enabled(meta)" then="""

-* Change the title of a page:
+  * Change the title of a page:

 
        \[[!meta title="full page title"]]
 """]]
 
 
        \[[!meta title="full page title"]]
 """]]
 

-[[!if test="enabled(inline) and blog" then="""
-* Create a [[blog]] by inlining a set of pages:
+[[!if test="enabled(inline)" then="""
+  * Create a blog by inlining a set of pages:

 
        \[[!inline pages="blog/*"]]
 """]]
 
 
        \[[!inline pages="blog/*"]]
 """]]
 

-[[!if test="enabled(template) and templates" then="""
-* Create and fill out [[templates]] for repeated chunks of
-  parameterized wiki text.
+[[!if test="enabled(listdirectives)" then="""
+  Full list of [[directives|directive]] enabled for this wiki:
+  [[!listdirectives ]]

 """]]
 """]]