Several bugfixes in org-publish.el
[org-mode.git] / ORGWEBPAGE / index.html
blobea618eb8562fe2b241647a675d144b90d5729015
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml"
4 lang="en" xml:lang="en">
5 <head>
6 <title>Org-Mode Homepage</title>
7 <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
8 <meta name="generator" content="Org-mode"/>
9 <meta name="generated" content="2008/01/18 12:46:32"/>
10 <meta name="author" content="Carsten Dominik"/>
11 <style type="text/css">
12 html {
13 font-family: Times, serif;
14 font-size: 12pt;
16 .title { text-align: center; }
17 .todo { color: red; }
18 .done { color: green; }
19 .timestamp { color: grey }
20 .timestamp-kwd { color: CadetBlue }
21 .tag { background-color:lightblue; font-weight:normal }
22 .target { background-color: lavender; }
23 pre {
24 border: 1pt solid #AEBDCC;
25 background-color: #F3F5F7;
26 padding: 5pt;
27 font-family: courier, monospace;
29 table { border-collapse: collapse; }
30 td, th {
31 vertical-align: top;
32 <!--border: 1pt solid #ADB9CC;-->
34 </style>
35 </head><body>
36 <h1 class="title">Org-Mode Homepage</h1>
37 <div id="table-of-contents">
38 <h2>Table of Contents</h2>
39 <ul>
40 <li><a href="#sec-1">Org - an Emacs Mode for Notes and Project Planning</a></li>
41 <li><a href="#sec-2">Current Version (5.19) and Compatibility</a></li>
42 <li><a href="#sec-3">Downloads</a></li>
43 <li><a href="#sec-4">Documentation</a>
44 <ul>
45 <li><a href="#sec-5">Manual and Reference card</a></li>
46 </ul>
47 </li>
48 <li><a href="#sec-6">Links</a>
49 <ul>
50 <li><a href="#sec-7">Mailing list</a></li>
51 <li><a href="#sec-8">Tutorials</a></li>
52 <li><a href="#sec-9">Org-mode, GTD and other task management systems </a></li>
53 <li><a href="#sec-10">Add-Ons</a></li>
54 <li><a href="#sec-11">Translators</a></li>
55 <li><a href="#sec-15">Alternative distributions</a></li>
56 <li><a href="#sec-16">Contributing to Org-mode</a></li>
57 <li><a href="#sec-17">Future Development</a></li>
58 </ul>
59 </li>
60 </ul>
61 </div>
63 <div class="outline-2">
64 <h2 id="sec-1">Org - an Emacs Mode for Notes and Project Planning</h2>
69 <BASE href="http://orgmode.org/index.html">
71 <p>
72 Org-mode is a mode for keeping notes, maintaining ToDo lists, and doing
73 project planning with a fast and effective plain-text system.
74 </p>
75 <p>
76 Org-mode develops organizational tasks around NOTES files that contain
77 information about projects as plain text. Org-mode is implemented on
78 top of outline-mode, which makes it possible to keep the content of
79 large files well structured. Visibility cycling and structure editing
80 help to work with the tree. Tables are easily created with a built-in
81 table editor. Org-mode supports ToDo items, deadlines, time stamps,
82 and scheduling. It dynamically compiles entries into an agenda.
83 Plain text URL-like links connect to websites, emails, Usenet
84 messages, BBDB entries, and any files related to the projects. For
85 printing and sharing of notes, an Org-mode file can be exported as a
86 structured ASCII file, HTML, and LaTeX.
87 </p>
88 </div>
90 <div class="outline-2">
91 <h2 id="sec-2">Current Version (5.19) and Compatibility</h2>
94 <p>
95 The current version is 5.19. To see what has changed in recent
96 releases, check this <a href="Changes.html">list of user-visible changes</a>. These descriptions
97 are extensive, to avoid that people will be printing the manual after
98 each incremental release. If you have an older version of the manual,
99 just check the release notes and you will be up-to-date.
100 </p>
102 This package works on Emacs 22, and (with minor restrictions) on Emacs
103 21 and XEmacs 21 (where you must also use <i>noutline.el</i> shipped with
104 Org-mode). The Emacs 22.1 release ships with Org-mode version 4.67c.
105 The latest CVS emacs trunk usually contains a fairly recent version,
106 but may lag a bit behind the website release.
107 </p>
108 </div>
110 <div class="outline-2">
111 <h2 id="sec-3">Downloads</h2>
114 <ul>
115 <li>Distribution<br/>
116 Download as <a href="org-5.19.zip">zip file</a> or <a href="org-5.19.tar.gz">gzipped tar archive</a>. These archives contain
117 both the Lisp file org.el and the documentation in PDF and (TeX)Info
118 formats. A shell script to simplify upgrading to the newest release
119 has been posted <a href="http://www.philfam.co.uk/pete/GTD/org-mode/update-org.sh">here</a>.
121 </li>
122 </ul>
123 </div>
125 <div class="outline-2">
126 <h2 id="sec-4">Documentation</h2>
129 <div class="outline-3">
130 <h3 id="sec-5">Manual and Reference card</h3>
132 <ul>
133 <li>
134 Read the documentation <a href="manual/index.html">online</a>. This is a version consisting of many
135 small files, to save bandwidth. If you really need it, you can also
136 have the entire manual in a <a href="org.html">single monolithic file</a>.
137 </li>
138 <li>
139 Download the documentation in other formats: <a href="org.pdf">PDF</a>, <a href="org">Info</a>, or <a href="org.texi">TeXInfo</a>.
140 </li>
141 <li>
142 Download the <a href="orgcard.pdf">Refcard</a> for org-mode, and Kyle Sherman hast created a
143 <a href="orgcard.txt">text version</a> of the reference card
144 </li>
145 <li>
146 There is also a <a href="http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual">Japanese translation</a> of the manual (version 4.60),
147 produced by Takeshi Okano.
148 </li>
149 <li>
150 The <a href="faq.html">FAQ</a> is not very up-to-date, but may still answer some of your
151 questions. Please have a look before posting to emacs-orgmode@gnu.org.
153 </li>
154 </ul></div>
155 </div>
157 <div class="outline-2">
158 <h2 id="sec-6">Links</h2>
162 <div class="outline-3">
163 <h3 id="sec-7">Mailing list</h3>
167 There is a mailing list for discussion about org-mode.
168 </p>
169 <ul>
170 <li>
171 Subscribe to it at <a href="http://lists.gnu.org/mailman/listinfo/emacs-orgmode">this webpage</a>.
172 </li>
173 <li>
174 Directly <a href="mailto:emacs-orgmode@gnu.org">send mail to it</a>. If you are not subscribed, a moderator
175 will look at the message before passing it through to the
176 list. If that has happened once, future messages from your email
177 address will get through immediately, even if you remain
178 unsubscribed.
179 </li>
180 <li>
181 Read the list on <a href="http://www.gmane.org">Gmane</a> through a <a href="http://news.gmane.org/gmane.emacs.orgmode">web interface</a> or with a
182 <a href="news://news.gmane.org/gmane.emacs.orgmode">newsreader</a>.
183 <li><form method="get" action="http://search.gmane.org/">
184 <input type="text" name="query">
185 <input type="hidden" name="group" value="gmane.emacs.orgmode">
186 <input type="submit" value="Search gmane.emacs.orgmode">
187 </form>
189 </li>
190 </ul></div>
192 <div class="outline-3">
193 <h3 id="sec-8">Tutorials</h3>
197 <a href="tutorials.html">Tutorials and screencasts</a> are listed on a separate page.
198 </p>
199 </div>
201 <div class="outline-3">
202 <h3 id="sec-9">Org-mode, GTD and other task management systems </h3>
204 <p>Org-mode is flexible enough to implement many different ways of
205 organizing your projects. A frequently discusses scheme is <a href="http://www.davidco.com/">David Allen's</a> strategy for <a href="http://en.wikipedia.org/wiki/GTD">Getting Things Done</a>. But it is clearly not
206 the only way to us Org-mode for planning. Here are a couple of
207 links related to this topic.
208 </p>
209 <ul>
210 <li>
211 <a href="http://johnwiegley.com">John Wiegley</a> has written an excellent document describing his
212 way of using Org-mode as a <a href="http://johnwiegley.com/org.mode.day.planner.html">day planner</a>. See also some later
213 messages for enhancements of his setup:
214 <a href="http://article.gmane.org/gmane.emacs.orgmode/2963">emacs-orgmode-2962</a>, <a href="http://article.gmane.org/gmane.emacs.orgmode/3629">emacs-orgmode-3629</a>
216 </li>
217 <li>
218 <a href="http://members.optusnet.com.au/charles57/Creative/">Charles Cave</a> has written an <a href="http://members.optusnet.com.au/~charles57/GTD/orgmode.html">article/tutorial</a> about the basic
219 elements of GTD and how he implements them in Org-mode.
221 </li>
222 <li>
223 There have been several threads on emacs-orgmode@gnu.org related
224 to GTD, the most important ones are:
225 <ul>
226 <li>
227 <a href="http://thread.gmane.org/gmane.emacs.orgmode/683">Another GTD question</a>, which contains a discussion about basic
228 GTD aspects. It also contains this
229 </li>
230 <li>
231 <a href="http://article.gmane.org/gmane.emacs.orgmode/715">Post by Carsten</a> summarizing several options for implementing
232 GTD in org-mode.
233 </li>
234 <li>
235 <a href="http://thread.gmane.org/gmane.emacs.orgmode/523">GTD, Projects and Next Actions in org-mode</a> is a thread where
236 several people describe their personal setup is
237 </li>
238 <li>
239 The <a href="http://thread.gmane.org/gmane.emacs.orgmode/4915">SOMEDAY/MAYBE vs. low priorities</a> thread contains a
240 discussion about priorities that is quite instructive.
241 </li>
242 <li>
243 Here is a <a href="http://thread.gmane.org/gmane.emacs.orgmode/4832/focus%3D4854">very instructive post</a> by Pete Phillips explaining
244 why David Allens book is where you should start to learn GTD,
245 and that the Internet and Org-mode only come into the game
246 later, when thinking about the implementation. And since
247 doing GTD the right way will give you lots of free time, don't
248 forget to listen to <a href="http://www.detox-jazz.co.uk/">Pete's music</a>!
249 </li>
250 </ul></li>
251 <li>
252 Also on the web you can find information about how people are
253 setting up Org-mode to fit their habits. A few examples:
255 <ul>
256 <li>
257 This <a href="http://www.brool.com/?p=82">blog post</a> shows a very simple and clear GTD setup.
259 </li>
260 </ul></li>
261 </ul></div>
263 <div class="outline-3">
264 <h3 id="sec-10">Add-Ons</h3>
267 <ul>
268 <li>
269 <a href="http://www.cl.cam.ac.uk/~pz215/">Piotr Zielinski</a> wrote <a href="http://www.cl.cam.ac.uk/~pz215/files/org-mouse.el">org-mouse.el</a> which is now distributed with
270 Org-mode. It implements great mouse support for many functions in
271 org-mode.
273 </li>
274 <li>
275 <a href="http://dto.freeshell.org/notebook/">David O'Toole</a> is the author of <a href="http://dto.freeshell.org/e/org-publish.el">org-publish.el</a>. While this is
276 now part of the Org-mode distribution, you might find the newest
277 bug fixes and developments at his <a href="http://dto.freeshell.org/notebook/OrgMode.html">Org-mode page</a>, along with
278 several other projects like <i>org-blog.el</i> and
279 <i>org-publish-escript.el</i>.
281 </li>
282 <li>
283 <a href="http://www.cognition.ens.fr/~guerry/">Bastien Guerry</a> has been really prolific in writing interesting
284 add-ons, all available at his <a href="http://www.cognition.ens.fr/~guerry/bastien-org-mode.html">org-mode page</a>:
285 <ul>
286 <li>
287 a package for using Org-mode as the basis for blogging
288 </li>
289 <li>
290 a LaTeX exporter that is now distributed together with
291 org-mode
292 </li>
293 <li>
294 a special table-of-contents buffer that simplifies navigation
295 </li>
296 <li>
297 a registry to find locations that link a specific document.
299 </li>
300 </ul></li>
301 <li>
302 George C.F. Greve wrote <a href="http://www.emacswiki.org/emacs/org-mairix.el">org-mairix.el</a> to add links that trigger a
303 mairix search.
305 </li>
306 </ul></div>
308 <div class="outline-3">
309 <h3 id="sec-11">Translators</h3>
313 I know about the following attempts to translate from and to
314 Org-mode files:
315 </p>
317 <div class="outline-4">
318 <h4 id="sec-12">Org-mode to XXX</h4>
321 <ul>
322 <li>
323 <a href="http://www.cognition.ens.fr/~guerry/u/org2rem.el">From Org-mode to remind</a> by <a href="http://www.cognition.ens.fr/~guerry/">Bastien Guerry</a>.
325 </li>
326 <li>
327 <a href="org-export-freemind-0.1.0.tar.gz">From Org-mode to Freemind</a> by Marco Vezzoli.
329 </li>
330 </ul></div>
332 <div class="outline-4">
333 <h4 id="sec-13">XXX to Org-mode</h4>
336 <ul>
337 <li>
338 <a href="http://www.olafdietsche.de/palm/palm2orgmode.pl">From Palm TODO database to Orgmode</a>. This Translator was
339 written by <a href="http://www.olafdietsche.de/">Olaf Dietsche</a>.
341 </li>
342 </ul></div>
344 <div class="outline-4">
345 <h4 id="sec-14">Bi-directional</h4>
349 Unfortunately nothing so far.
350 </p>
351 </div>
352 </div>
354 <div class="outline-3">
355 <h3 id="sec-15">Alternative distributions</h3>
358 <ul>
359 <li>
360 Mark A. Hershberger has made some <a href="https://launchpad.net/~hexmode/+archive">Ubuntu packages</a> for org-mode.
362 </li>
363 </ul></div>
365 <div class="outline-3">
366 <h3 id="sec-16">Contributing to Org-mode</h3>
370 You can always contribute with ideas and bug reports on the mailing
371 list. If you want to contribute a patch, code snippets, or a full
372 add-on, this is very welcome too! However, I can only make it an
373 official part of Org-mode if you have signed the papers with the
374 Free Software Foundation. Org-mode is distributed as part of Emacs
375 and must therefore adhere to strict rules about the copyright of
376 all included material. If this is what you want to do, <a href="request-assign-future.txt">here</a> is the
377 form that you have to fill in and send to the FSF. After you
378 received the final copy with signatures, please scan it and send
379 the scan to the maintainer.
380 </p>
381 </div>
383 <div class="outline-3">
384 <h3 id="sec-17">Future Development</h3>
388 Org-mode is still developing fast. The best way to stay up-to-date
389 is to join the mailing list where the changes are developed and
390 discusssed.
391 </p>
393 Here is a loose <a href="todo.html">list of ideas</a> that are still to be processed
394 somehow, when I get to it&hellip;
395 </p>
396 </div>
397 </div>
398 <div id="postamble"><p class="author"> Author: Carsten Dominik
399 <a href="mailto:carsten at orgmode dot org">&lt;carsten at orgmode dot org&gt;</a>
400 </p>
401 <p class="date"> Date: 2008/01/18 12:46:32</p>
402 </div></body>
403 </html>