git.oblomov.eu Git - ikiwiki/blob - doc/plugins/rst/discussion.mdwn

   1 Is [prest][1] the perl version of the reST processor referred to in the text?
   2 It seems to be reasonably well-maintained to me, and differences between it and
   3 "standard" reST are pretty minor (a fairly exhaustive list, taken from the
   4 prest docs, is at the end of this page).
   5
   6 [1]: http://search.cpan.org/~nodine/Text-Restructured-0.003024/
   7
   8 In addition, reST appears to allow raw HTML pass-through with the `raw`
   9 directive, though I think a better solution would be expanding the format plugin
  10 interface. --Ethan
  11
  12 An exhaustive list of differences between prest and "standard" reST follows:
  13
  14 * fewer alternatives for bullet lists (only "+", "*" and "-")
  15 * escaped colons are not allowed in field names
  16 * RCS keyword processing is only activated on "recognized bibliographic
  17     field names"
  18 * multiple consecutive blockquotes seperated by attributions may not be allowed
  19     (not sure; text could be interpreted either way)
  20 * a warning about auto-symbol footnotes is missing (maybe it's not relevant?)
  21 * colons are allowed within hyperlink reference names
  22 * inline markup can be nested
  23 * some directives are missing (epigraph, highlights, pull quote, date) and
  24     some have been added (MathML, code execution (disabled by default), enscript)
  25 * container directive now uses "class" instead of "classes"
  26 * csv directive doesn't require csv.py
  27 * references directive doesn't allow options
  28
  29 There may be a few others; my eyes glazed over. --Ethan