2008-05-25 14:15:25 +00:00
2009-01-07 13:41:57 +00:00
#+TITLE : Org-Mode: Your Life in Plain Text
2008-01-31 15:04:26 +00:00
#+LANGUAGE : en
#+EMAIL : carsten at orgmode dot org
2009-04-05 21:20:30 +00:00
#+OPTIONS : H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:t *:t TeX:t author:nil <:t LaTeX:t
2009-01-07 13:41:57 +00:00
#+STYLE : </style><link rel="stylesheet" href="http://orgmode.org/org.css" type="text/css" />
2008-01-31 15:04:26 +00:00
2009-01-21 13:57:41 +00:00
#+HTML : <BASE href="http://orgmode.org/index.html">
2008-01-31 15:04:26 +00:00
2008-07-20 15:25:14 +00:00
#+BEGIN_HTML
<form action="http://www.google.com/cse" id="cse-search-box" >
2009-01-07 13:41:57 +00:00
<div align="right" >
2008-07-20 15:25:14 +00:00
<input type="hidden" name="cx" value="002987994228320350715:2gaddxoioh4" / >
<input type="hidden" name="ie" value="UTF-8" / >
<input type="text" name="q" size="31" / >
<input type="submit" name="sa" value="Search this website" / >
</div >
</form >
<script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en" ></script >
#+END_HTML
2009-01-07 13:41:57 +00:00
*Org - an Emacs Mode for Notes, Project Planning, and Authoring*
Org-mode is for keeping notes, maintaining ToDo lists, doing project
planning, and authoring with a fast and effective plain-text
system.
#+ATTR_HTML : style="border:1px solid black;"
2009-01-21 14:01:09 +00:00
[[http://orgmode.org/img/tasks.png ]]
2009-01-07 13:41:57 +00:00
2009-01-07 17:54:34 +00:00
- Simplicity :: Org-mode is a simple outliner for note-taking and list
2009-01-09 23:09:19 +00:00
management. You can learn the basics for using it in five
2009-01-07 17:54:34 +00:00
minutes. This may be all you need, and Org-mode will not impose
more complex features on you.
2009-01-07 13:41:57 +00:00
- Portability :: Org files are plain text. You can view and edit them
in any editor. Your data is yours forever. Org-mode runs in
[[http://www.gnu.org/software/emacs/ ][Emacs ]], which is available for nearly every platform.
2009-01-07 17:54:34 +00:00
- Depth :: Org-mode will not let you down when you need more than a
2009-01-08 06:32:52 +00:00
simple outline. The full feature set is both [[http://orgmode.org/manual/Main-Index.html#Main-Index ][broad ]] and [[http://orgmode.org/manual/index.html ][deep ]].
2009-01-07 17:54:34 +00:00
The typical [[http://orgmode.org/worg/org-faq.php ][answer ]] to "/Can it do X?/ " is "/Yes!/ ".
- Flexibility :: Org-mode is like a Swiss army knife. People use it
for [[http://members.optusnet.com.au/~charles57/GTD/orgmode.html ][Getting Things Done (GTD) ]], as a [[http://www.newartisans.com/blog_files/org.mode.day.planner.php ][Day Planner ]], as a [[http://sachachua.com/wp/2008/01/18/outlining-your-notes-with-org/ ][Notebook ]],
for Web and PDF [[http://orgmode.org ][Authoring ]], and much more.
2009-01-07 13:41:57 +00:00
- Support :: Org-mode is supported by an active [[id:0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26 ][mailing list ]] where
2009-01-07 14:31:26 +00:00
questions are answered quickly and effectively.
2009-01-07 13:41:57 +00:00
- It's free! :: Org is [[http://en.wikipedia.org/wiki/Open-source_software ][open source software ]], it is free, like Emacs.
2008-01-31 15:04:26 +00:00
2008-12-16 11:07:42 +00:00
If you'd like to know what other people have said about Org-mode, take
a look at our [[http://orgmode.org/worg/org-quotes.php ][collected quotes about Org ]].
2008-07-17 17:53:35 +00:00
* News
2009-04-19 07:57:10 +00:00
- <2009-04-19 Sun >: Release 6.26
2009-04-01 14:00:39 +00:00
- <2009-04-01 Wed >: Release 6.25
2009-03-06 08:04:52 +00:00
- <2009-03-05 Thu >: Release 6.24
2008-07-17 17:53:35 +00:00
2009-04-21 08:21:36 +00:00
* Current Version (6.26b)
2008-01-31 15:04:26 +00:00
2009-04-21 08:21:36 +00:00
The current version is 6.26b. To see what has changed in recent
2009-01-07 13:41:57 +00:00
releases, check this detailed list of [[file:Changes.html ][user-visible changes ]].
2008-01-31 15:04:26 +00:00
2008-05-24 20:34:13 +00:00
This package works on Emacs 23 and 22, and (with minor restrictions)
2009-01-07 13:41:57 +00:00
on Emacs 21 and XEmacs 21. Emacs 22.2 ships with Org-mode version
2009-02-02 21:56:53 +00:00
4.67d. Emacs 23.1 release is expected to ship with 6.21b. The latest
2009-01-07 14:31:26 +00:00
CVS Emacs trunk usually contains a fairly recent version, but may lag
2009-01-07 13:41:57 +00:00
a bit behind the website release.
2008-01-31 15:04:26 +00:00
* Downloads
2008-06-17 11:56:38 +00:00
** The standard distribution
2008-03-31 11:33:38 +00:00
2009-04-21 08:21:36 +00:00
Download as [[file:org-6.26b.zip ][zip file ]] or [[file:org-6.26b.tar.gz ][gzipped tar archive ]]. These archives contain
2008-01-31 15:04:26 +00:00
both the Lisp file org.el and the documentation in PDF and (TeX)Info
2009-01-07 13:41:57 +00:00
formats. Follow the instructions for [[http://orgmode.org/manual/Installation.html#Installation ][Installation ]] and [[http://orgmode.org/manual/Activation.html#Activation ][Activation ]].
2008-01-31 15:04:26 +00:00
2008-06-17 11:56:38 +00:00
** The development version
2008-03-31 11:33:38 +00:00
2008-06-16 14:26:30 +00:00
You can check out the latest Org development version (along with every
2008-07-22 17:53:14 +00:00
release we ever had) by using git. The git repository is [[http://repo.or.cz/w/org-mode.git][browsable
2008-07-22 20:58:59 +00:00
online]]. To get a local clone use something like the following (from
2008-07-22 17:53:14 +00:00
the command line....):
2008-07-22 20:58:59 +00:00
: git clone git://repo.or.cz/org-mode.git
2008-03-31 11:33:38 +00:00
2009-01-07 13:41:57 +00:00
Some more information about this can be found in the [[http://orgmode.org/worg/org-faq.php ][FAQ ]], under [[http://orgmode.org/worg/org-faq.php#keeping-current-with-Org-mode-development][How do
2009-02-07 14:22:57 +00:00
I keep current with Org mode development?]]. For people who cannot use
git, we provide [[file:org-snapshot.zip ][zip ]] or [[file:org-snapshot.tar.gz ][tar.gz ]] snapshot release files corresponding to
the latest git version.
2008-07-25 21:04:26 +00:00
2008-06-17 11:56:38 +00:00
** Alternative distributions
2009-01-07 13:41:57 +00:00
There are several alternative distributions of Org:
2008-06-17 11:56:38 +00:00
- The [[http://savannah.gnu.org/cvs/%3Fgroup%3Demacs ][Emacs CVS ]] contains a recent version
2008-07-03 17:36:32 +00:00
- There is also a package on [[http://aur.archlinux.org/packages.php?do_Details&ID=18206 ][Archlinux ]], by Jiyunatori.
2009-01-07 14:31:26 +00:00
- The [[http://packages.debian.org/sid/main/org-mode ][Debian package ]] is maintained by Sebastien Delafond
2008-11-12 00:33:46 +00:00
- The [[http://pdb.finkproject.org/pdb/package.php/org-mode ][Fink package ]] for Mac OS X by Jesse Alama
2009-01-07 13:41:57 +00:00
- The [[https://launchpad.net/~hexmode/+archive ][Ubuntu package ]] by Mark A. Hershberger.
2008-06-17 11:56:38 +00:00
2008-01-31 15:04:26 +00:00
* Documentation
2008-06-18 04:18:27 +00:00
** The Org manual
2009-01-09 10:40:24 +00:00
- Read the [[file:manual/index.html ][documentation online ]].
2009-01-07 13:41:57 +00:00
- You can also have the entire manual in a [[file:org.html ][single monolithic file ]].
2008-11-19 16:33:49 +00:00
- Download the documentation as a [[file:org.pdf ][PDF document ]].
2009-01-07 13:41:57 +00:00
- A [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual ][Japanese translation ]] of the manual (version 4.60), by Takeshi
Okano.
2008-06-18 04:18:27 +00:00
** Reference card
- Download the [[file:orgcard.pdf ][Refcard ]] for org-mode
- Kyle Sherman has created a [[file:orgcard.txt ][text version ]] of the reference card
2008-09-07 05:49:09 +00:00
(Org version 6.07).
2008-06-18 04:18:27 +00:00
** The FAQ
2008-06-18 04:55:59 +00:00
- The [[http://orgmode.org/worg/org-faq.php ][Org Mode FAQ ]] is user-editable and is maintained by the [[http://orgmode.org/worg/ ][Worg
project]].
2008-01-31 15:04:26 +00:00
2009-01-07 13:41:57 +00:00
** Tutorials
- A complete list of [[http://orgmode.org/worg/org-tutorials/index.php ][Tutorials and screencasts ]] is maintained by the
[[http://orgmode.org/worg ][Worg project ]].
2008-01-31 15:04:26 +00:00
* Links
2008-07-17 17:53:35 +00:00
** Google Tech Talk
Check out the [[file:GoogleTech.org ][Google Tech Talk ]] about Org-mode.
2008-01-31 15:04:26 +00:00
** Mailing list
2009-01-07 13:41:57 +00:00
:PROPERTIES:
:ID: 0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26
:END:
2008-01-31 15:04:26 +00:00
There is a mailing list for discussion about org-mode.
2009-01-09 10:40:24 +00:00
- [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode ][Subscribe to it ]] at the web interface.
2008-01-31 15:04:26 +00:00
- Directly [[mailto:emacs-orgmode@gnu.org ][send mail to it ]]. If you are not subscribed, a moderator
will look at the message before passing it through to the
2009-01-07 13:41:57 +00:00
list.
2008-01-31 15:04:26 +00:00
- Read the list on [[http://www.gmane.org ][Gmane ]] through a [[http://news.gmane.org/gmane.emacs.orgmode ][web interface ]] or with a
[[news://news.gmane.org/gmane.emacs.orgmode ][newsreader ]].
2008-04-03 12:37:44 +00:00
2008-01-31 15:04:26 +00:00
#+BEGIN_HTML
<li ><form method="get" action="http://search.gmane.org/" >
<input type="text" name="query" >
<input type="hidden" name="group" value="gmane.emacs.orgmode" >
<input type="submit" value="Search gmane.emacs.orgmode" >
</form >
#+END_HTML
2009-01-07 13:41:57 +00:00
** Worg
2008-01-31 15:04:26 +00:00
2008-05-12 05:29:13 +00:00
[[http://orgmode.org/worg/ ][Worg ]], created by [[http://www.cognition.ens.fr/~guerry/ ][Bastien Guerry ]], is a setup to allow users to jointly
2008-04-14 05:47:32 +00:00
edit a number of Org-mode files containing documentation about
2008-12-22 12:18:11 +00:00
Org-mode, including the [[http://orgmode.org/worg/org-faq.php ][Org Mode FAQ ]] and [[http://orgmode.org/worg/org-tutorials/index.php ][Tutorials ]]. Worg is similar
to a wiki in that allows community to edit the contents. However,
since it uses a distributed version control system, you do not have to
2009-01-07 13:41:57 +00:00
be online while editing it. If you'd like to contribute to Worg,
please go to [[http://orgmode.org/worg/ ][the Worg page ]], and start from there.
2008-06-18 07:23:07 +00:00
2008-01-31 15:04:26 +00:00
** Contributing to Org-mode
2009-01-07 13:41:57 +00:00
You can always contribute with ideas and bug reports on the mailing
list. If you want to contribute a patch, code snippets, or a full
2009-01-09 11:03:23 +00:00
add-on, this is very welcome too! We do distribute good add-ons as
contributed packages. However, to integrate additions into the
Org-mode core, the author needs to assign the copyright to the [[http://www.fsf.org/ ][Free
Software Foundation]]. This is because Org-mode is part of Emacs, which
adheres to very strict rules. If you would like to sign the papers,
use [[file:request-assign-future.txt ][this form ]], fill it in and [[mailto:assign@gnu.org,carsten.dominik@gmail.com ][send ]] it to the FSF with a copy to the
Org-mode maintainer.
2009-01-07 13:41:57 +00:00