aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib/org_mode.mdwn
blob: 11153be7894881b43ebddba15ce18e3bf0849950 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
Summary
=======

A plugin for handling files written in [org-mode][].

A complete rewrite of the plugin can be found
[here][chrismgray-rewrite].  It uses a
dedicated emacs instance to parse the org-mode files.  Thus, it should
be a bit faster than the older plugin, as well as properly handling
[[wikilinks|ikiwiki/wikilink]] and images, two features not present in the older
plugin.  An example of its use can be found at my [blog][chrismgray-blog].

[[!template id=gitbranch branch=wtk/org author="[[wtk]]"]]

Original plugin
===============

This is an updated form of [Manoj Srivastava's plugin][MS].  You can
see the plugin [in action][example] on my blog.

For reasons discussed in the [[reStructuredText plugin|plugins/rst]],
wikilinks and other ikiwiki markup that inserts raw HTML can cause
problems.  Org-mode provides a [means for processing raw HTML][raw],
but Ikiwiki currently (as far as I know) lacks a method to escape
inserted HTML depending on which plugins will be used during the
[[htmlize phase|plugins/write#index11h3]].

[org-mode]: http://orgmode.org/
[MS]: http://www.golden-gryphon.com/blog/manoj/blog/2008/06/08/Using_org-mode_with_Ikiwiki/
[example]: http://blog.tremily.us/posts/Git/notes/
[raw]: http://orgmode.org/manual/Quoting-HTML-tags.html
[chrismgray-rewrite]: https://github.com/chrismgray/ikiwiki-org-plugin
[chrismgray-blog]: http://chrismgray.github.com