summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2008-08-30 06:17:15 +0200
committerJonas Smedegaard <dr@jones.dk>2008-08-30 06:17:15 +0200
commit0f935cae8775f5d94dfdc6c50c753eded796abfc (patch)
treed7769dcc2bac98eafca69063d6f1c0a1c5329252 /ikiwiki
parent7a34ab14c1c817bc9ac43197c002c7b95e6ad1cc (diff)
parent70090d29241b365d5532360afed8782d3c7dfd2e (diff)
Merge branch 'master' into clean + drop ikiwiki/preprocessordirective.mdwn
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/blog.mdwn8
-rw-r--r--ikiwiki/directive.mdwn (renamed from ikiwiki/preprocessordirective.mdwn)8
-rw-r--r--ikiwiki/formatting.mdwn25
-rw-r--r--ikiwiki/markdown.mdwn6
-rw-r--r--ikiwiki/pagespec/attachment.mdwn6
-rw-r--r--ikiwiki/wikilink.mdwn6
6 files changed, 35 insertions, 24 deletions
diff --git a/ikiwiki/blog.mdwn b/ikiwiki/blog.mdwn
index 19ec7ac..53d4c7a 100644
--- a/ikiwiki/blog.mdwn
+++ b/ikiwiki/blog.mdwn
@@ -7,7 +7,7 @@
then="You can"
else="If this wiki had the inline plugin enabled, you could"]]
turn any page on this wiki into a weblog by using the `inline`
-[[PreProcessorDirective]]. For example:
+[[directive]]. For example:
\[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]
@@ -17,9 +17,9 @@ of them will appear in the page. Note that if files that are not pages
match the [[PageSpec]], they will be included in the feed using RSS
enclosures, which is useful for podcasting.
-The optional `rootpage` parameter tells the wiki that new posts to this blog
-should default to being [[SubPage]]s of "blog", and enables a form at the
-top of the blog that can be used to add new items.
+The optional `rootpage` parameter tells the wiki that new posts to this
+blog should default to being [[SubPages|SubPage]] of "blog", and enables a
+form at the top of the blog that can be used to add new items.
If you want your blog to have an archive page listing every post ever made
to it, you can accomplish that like this:
diff --git a/ikiwiki/preprocessordirective.mdwn b/ikiwiki/directive.mdwn
index 743c0d9..a0a4e1f 100644
--- a/ikiwiki/preprocessordirective.mdwn
+++ b/ikiwiki/directive.mdwn
@@ -1,5 +1,5 @@
[[!meta robots="noindex, follow"]]
-Preprocessor directives are similar to a [[WikiLink]] in form, except they
+Directives are similar to a [[WikiLink]] in form, except they
begin with `!` and may contain parameters. The general form is:
\[[!directive param="value" param="value"]]
@@ -12,11 +12,11 @@ Also, some directives may use parameters without values, for example:
\[[!tag foo]]
-A preprocessor directive does not need to all be on one line, it can be
+A directive does not need to all be on one line, it can be
wrapped to multiple lines if you like:
\[[!directive foo="baldersnatch"
- bar="supercalifragalisticexpealadocious" baz=11]]
+ bar="supercalifragilisticexpialidocious" baz=11]]
Also, multiple lines of *quoted* text can be used for a value.
To allow quote marks inside the quoted text, delimit the block
@@ -28,7 +28,7 @@ of text with triple-quotes:
3. "baz"
"""]]
-ikiwiki also has an older syntax for preprocessor directives, which requires a
+ikiwiki also has an older syntax for directives, which requires a
space in directives to distinguish them from [[wikilinks|wikilink]]. This
syntax has several disadvantages: it requires a space after directives with no
parameters (such as `\[[pagecount ]]`), and it prohibits spaces in
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
index 29dbce1..0145f9d 100644
--- a/ikiwiki/formatting.mdwn
+++ b/ikiwiki/formatting.mdwn
@@ -70,26 +70,37 @@ you use the following additional features:
\[[!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) and blog)" then="""
+ For example, you can:
+"""]]
+
[[!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="""
-* Change the title of a page:
+ * Change the title of a page:
\[[!meta title="full page title"]]
"""]]
[[!if test="enabled(inline) and blog" then="""
-* Create a [[blog]] by inlining a set of pages:
+ * Create a [[blog]] by inlining a set of pages:
\[[!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 ]]
"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
index bbda9ad..a419094 100644
--- a/ikiwiki/markdown.mdwn
+++ b/ikiwiki/markdown.mdwn
@@ -8,6 +8,6 @@ For documentation about the markdown syntax, see [[formatting]] and
[markdown mode](http://jblevins.org/projects/markdown-mode/) for
emacs can help in editing.
-Note that [[WikiLink]]s and [[PreProcessorDirective]]s are not part of the
-markdown syntax, and are the only bit of markup that this wiki handles
-internally.
+Note that [[WikiLinks|WikiLink]] and [[directives|directive]] are not part
+of the markdown syntax, and are the only bit of markup that this wiki
+handles internally.
diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn
index 2a1f8aa..6b86c51 100644
--- a/ikiwiki/pagespec/attachment.mdwn
+++ b/ikiwiki/pagespec/attachment.mdwn
@@ -4,8 +4,8 @@
else="This wiki has attachments **disabled**."]]
If attachments are enabled, the wiki admin can control what types of
-attachments will be accepted, by entering a [[ikiwiki/PageSpec]] in the
-"Allowed Attachments" field of their preferences page.
+attachments will be accepted, via the `allowed_attachments`
+configuration setting.
For example, to limit arbitrary files to 50 kilobytes, but allow
larger mp3 files to be uploaded by joey into a specific directory, and
@@ -13,7 +13,7 @@ check all attachments for virii, something like this could be used:
virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (!ispage() and maxsize(50kb)))
-The regular [[ikiwiki/PageSpec]] syntax is expanded with thw following
+The regular [[ikiwiki/PageSpec]] syntax is expanded with the following
additional tests:
* maxsize(size)
diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn
index bd5e3d1..371c252 100644
--- a/ikiwiki/wikilink.mdwn
+++ b/ikiwiki/wikilink.mdwn
@@ -23,11 +23,11 @@ page, but the link will appear like this: [[foo_bar|SandBox]].
To link to an anchor inside a page, you can use something like
`\[[WikiLink#foo]]`
-## Preprocessor directives and wikilinks
+## Directives and WikiLinks
ikiwiki has two syntaxes for
-[[preprocessor_directives|PreprocessorDirective]]. The older syntax
-used spaces to distinguish between preprocessor directives and
+[[directives|directive]]. The older syntax
+used spaces to distinguish between directives and
wikilinks; as a result, with that syntax in use, you cannot use spaces
in WikiLinks, and must replace spaces with underscores. The newer
syntax, enabled with the `prefix_directives` option in an ikiwiki