aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/rst
diff options
context:
space:
mode:
authorjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-02-27 08:37:38 +0000
committerjoey <joey@0fa5a96a-9a0e-0410-b3b2-a0fd24251071>2007-02-27 08:37:38 +0000
commit58474c3f37f9358b7f6f12d354ec40adbbb1bf3b (patch)
treefcaad3b50481c75784a08d0094f3397d9c0ceda3 /doc/plugins/rst
parentfaa1c1f738a465e87f4f35569f5a24727f0047d4 (diff)
downloadikiwiki-58474c3f37f9358b7f6f12d354ec40adbbb1bf3b.tar
ikiwiki-58474c3f37f9358b7f6f12d354ec40adbbb1bf3b.tar.gz
web commit by http://ethan.betacantrips.com/: document the issue
Diffstat (limited to 'doc/plugins/rst')
-rw-r--r--doc/plugins/rst/discussion.mdwn15
1 files changed, 9 insertions, 6 deletions
diff --git a/doc/plugins/rst/discussion.mdwn b/doc/plugins/rst/discussion.mdwn
index 68e8f514f..a792b670f 100644
--- a/doc/plugins/rst/discussion.mdwn
+++ b/doc/plugins/rst/discussion.mdwn
@@ -1,14 +1,17 @@
+The main problem with more sophisticated RST support is that ikiwiki turns
+preprocessor directives into raw HTML and reST hates inline HTML.
+inline relies on Markdown's handling of raw HTML, specifically
+that it doesn't wrap paragraph-level `<div>`s in `<p>` tags -- see
+[[todo/htmlvalidation]]. Other plugins might expect their output to be
+interpreted in certain ways too -- [[Joey]] mentions toggleable and fortune.
+
Is [prest][1] the perl version of the reST processor referred to in the text?
It seems to be reasonably well-maintained to me, and differences between it and
-"standard" reST are pretty minor (a fairly exhaustive list, taken from the
-prest docs, is at the end of this page).
+"standard" reST are pretty minor. A fairly exhaustive list, taken from the
+prest docs, follows:
[1]: http://search.cpan.org/~nodine/Text-Restructured-0.003024/
-In addition, reST appears to allow raw HTML pass-through with the `raw`
-directive, though I think a better solution would be expanding the format plugin
-interface. --Ethan
-
An exhaustive list of differences between prest and "standard" reST follows:
* fewer alternatives for bullet lists (only "+", "*" and "-")