doc/plugins/contrib/org_mode.mdwn

   1 Summary
   2 =======
   3
   4 A plugin for handling files written in [org-mode][].
   5
   6 A complete rewrite of the plugin can be found
   7 [here][chrismgray-rewrite].  It uses a
   8 dedicated emacs instance to parse the org-mode files.  Thus, it should
   9 be a bit faster than the older plugin, as well as properly handling
  10 [[wikilinks|ikiwiki/wikilink]] and images, two features not present in the older
  11 plugin.  An example of its use can be found at my [blog][chrismgray-blog].
  12
  13 [[!template id=gitbranch branch=wtk/org author="[[wtk]]"]]
  14
  15 Original plugin
  16 ===============
  17
  18 This is an updated form of [Manoj Srivastava's plugin][MS].  You can
  19 see the plugin [in action][example] on my blog.
  20
  21 For reasons discussed in the [[reStructuredText plugin|plugins/rst]],
  22 wikilinks and other ikiwiki markup that inserts raw HTML can cause
  23 problems.  Org-mode provides a [means for processing raw HTML][raw],
  24 but Ikiwiki currently (as far as I know) lacks a method to escape
  25 inserted HTML depending on which plugins will be used during the
  26 [[htmlize phase|plugins/write#index11h3]].
  27
  28 [org-mode]: http://orgmode.org/
  29 [MS]: http://www.golden-gryphon.com/blog/manoj/blog/2008/06/08/Using_org-mode_with_Ikiwiki/
  30 [example]: http://blog.tremily.us/posts/Git/notes/
  31 [raw]: http://orgmode.org/manual/Quoting-HTML-tags.html
  32 [chrismgray-rewrite]: https://github.com/chrismgray/ikiwiki-org-plugin
  33 [chrismgray-blog]: http://chrismgray.github.com
  34