summaryrefslogtreecommitdiff
path: root/doc/plugins/meta.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joey@kitenet.net>2007-12-16 15:56:09 -0500
committerJoey Hess <joey@kitenet.net>2007-12-16 15:56:09 -0500
commit96817b00326b983299ce701532643f763259af89 (patch)
treea037be8bb92ccfa16e2f29a3b9f0a336d862fd2b /doc/plugins/meta.mdwn
parent97a69be23663edfef828faa6f690f03db203e06b (diff)
* meta: Drop support for "meta link", since supporting this for internal
links required meta to be run during scan, which complicated its data storage, since it had to clear data stored during the scan pass to avoid duplicating it during the normal preprocessing pass. * If you used "meta link", you should switch to either "meta openid" (for openid delegations), or tags (for internal, invisible links). I assume that nobody really used "meta link" for external, non-openid links, since the htmlscrubber ate those. (Tell me differently and I'll consider bringing back that support.) * meta: Improved data storage. * meta: Drop the hackish filter hook that was used to clear stored data before preprocessing, this hack was ugly, and broken (cf: liw's disappearing openids). * aggregate: Convert filter hook to a needsbuild hook.
Diffstat (limited to 'doc/plugins/meta.mdwn')
-rw-r--r--doc/plugins/meta.mdwn49
1 files changed, 17 insertions, 32 deletions
diff --git a/doc/plugins/meta.mdwn b/doc/plugins/meta.mdwn
index f97e267ef..0696dc08e 100644
--- a/doc/plugins/meta.mdwn
+++ b/doc/plugins/meta.mdwn
@@ -13,38 +13,7 @@ also specifies some additional sub-parameters.
The field values are treated as HTML entity-escaped text, so you can include
a quote in the text by writing `&quot;` and so on.
-You can use any field names you like, but here are some predefined ones:
-
-* link
-
- Specifies a link to another page. This can be used as a way to make the
- wiki treat one page as linking to another without displaying a user-visible
- [[ikiwiki/WikiLink]]:
-
- \[[meta link=otherpage]]
-
- It can also be used to insert a html &lt;link&gt; tag. For example:
-
- \[[meta link="http://joeyh.myopenid.com/" rel="openid.delegate"]]
-
- However, this latter syntax won't be allowed if the [[htmlscrubber]] is
- enabled, since it can be used to insert unsafe content.
-
-* redir
-
- Causes the page to redirect to another page in the wiki.
-
- \[[meta redir=otherpage]]
-
- Optionally, a delay (in seconds) can be specified. The default is to
- redirect without delay.
-
- It can also be used to redirect to an external url. For example:
-
- \[[meta redir="http://example.com/"]]
-
- However, this latter syntax won't be allowed if the [[htmlscrubber]] is
- enabled, since it can be used to insert unsafe content.
+Supported fields:
* title
@@ -100,6 +69,22 @@ You can use any field names you like, but here are some predefined ones:
\\[[meta openid="http://joeyh.myopenid.com/"
server="http://www.myopenid.com/server"]]
+* redir
+
+ Causes the page to redirect to another page in the wiki.
+
+ \[[meta redir=otherpage]]
+
+ Optionally, a delay (in seconds) can be specified. The default is to
+ redirect without delay.
+
+ It can also be used to redirect to an external url. For example:
+
+ \[[meta redir="http://example.com/"]]
+
+ However, this latter syntax won't be allowed if the [[htmlscrubber]] is
+ enabled, since it can be used to insert unsafe content.
+
If the field is not one of the above predefined fields, the metadata will be
written to the generated html page as a &lt;meta&gt; header. However, this
won't be allowed if the [[htmlscrubber]] is enabled, since it can be used to