aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/contrib
diff options
context:
space:
mode:
authorhttps://id.koumbit.net/anarcat <https://id.koumbit.net/anarcat@web>2014-12-11 10:56:38 -0400
committeradmin <admin@branchable.com>2014-12-11 10:56:38 -0400
commit7220a79e643aed2646f85207bad55faf2d159e42 (patch)
treebe9944b08a53f73dbf3be38f20adbd8491269ebf /doc/plugins/contrib
parent2fd7f8d5b87c89ad5f24df9df05d1d49cdaa6df4 (diff)
downloadikiwiki-7220a79e643aed2646f85207bad55faf2d159e42.tar
ikiwiki-7220a79e643aed2646f85207bad55faf2d159e42.tar.gz
rename todo/org_mode.mdwn to plugins/contrib/org_mode.mdwn
Diffstat (limited to 'doc/plugins/contrib')
-rw-r--r--doc/plugins/contrib/org_mode.mdwn36
-rw-r--r--doc/plugins/contrib/org_mode/Discussion.mdwn7
2 files changed, 43 insertions, 0 deletions
diff --git a/doc/plugins/contrib/org_mode.mdwn b/doc/plugins/contrib/org_mode.mdwn
new file mode 100644
index 000000000..bb3b7dec0
--- /dev/null
+++ b/doc/plugins/contrib/org_mode.mdwn
@@ -0,0 +1,36 @@
+[[!template id=gitbranch branch=wtk/org author="[[wtk]]"]]
+
+summary
+=======
+
+Add a plugin for handling files written in [org-mode][].
+
+notes
+=====
+
+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]].
+
+new plugin
+==========
+
+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].
+
+[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
diff --git a/doc/plugins/contrib/org_mode/Discussion.mdwn b/doc/plugins/contrib/org_mode/Discussion.mdwn
new file mode 100644
index 000000000..726590bf4
--- /dev/null
+++ b/doc/plugins/contrib/org_mode/Discussion.mdwn
@@ -0,0 +1,7 @@
+I don't find org.pm in git branch. The steps are:
+
+1. git clone git://github.com/wking/ikiwiki.git
+2. cd ikiwiki
+3. find . | grep org.pm
+
+I've taken the name from <http://www.golden-gryphon.com/software/misc/org.pm.html>