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-06-24 18:46:35 +00:00
#+STYLE : <base href="http://orgmode.org/index.html" />
#+STYLE : <link rel="stylesheet" href="http://orgmode.org/org.css" type="text/css" />
2008-01-31 15:04:26 +00:00
2009-06-05 09:10:58 +00:00
2009-07-08 11:11:58 +00:00
#+begin_html
<!-- The logo links to the root of the website -- >
<a href="/" ><img src="http://orgmode.org/img/org-mode-unicorn.png" class="logo-link" / ></a >
#+end_html
2009-06-26 18:23:26 +00:00
#*Org - an Emacs Mode for Notes, Project Planning, and Authoring*
2009-06-05 09:10:58 +00:00
#+begin_html
2009-06-26 18:23:26 +00:00
<table >
2009-06-23 10:55:18 +00:00
<tr >
2009-06-26 18:23:26 +00:00
<td style="vertical-align:middle;" >
<b >Org - an Emacs Mode for Notes, Project Planning, and Authoring</b >
<br/ ><br/ >
Org-mode is for keeping notes, maintaining ToDo lists, doing project
planning, and authoring with a fast and effective plain-text
system.
2009-06-23 10:55:18 +00:00
</td >
</table >
2009-12-18 11:47:51 +00:00
</br > </br >
2009-06-05 09:10:58 +00:00
#+end_html
2009-01-07 13:41:57 +00:00
2009-06-26 18:23:26 +00:00
#+begin_html
2009-12-18 11:47:51 +00:00
<table width="750px" >
2009-06-26 18:23:26 +00:00
<tr >
2009-12-18 13:57:21 +00:00
<td ><br ><img src="http://orgmode.org/img/tasks.png"
2009-12-18 11:47:51 +00:00
style="border:1px solid black; width:500px"
alt="http://orgmode.org/img/tasks.png"/ >
2009-07-28 18:51:33 +00:00
</td >
2009-12-18 10:42:09 +00:00
<td >
2009-12-18 11:47:51 +00:00
<table width="220px" >
2009-12-18 13:57:21 +00:00
<tr ><td ><h3 style="text-align:center;vertical-align:bottom;" >Shirts and Donations</h3 ></td ></tr >
2009-12-18 11:47:51 +00:00
<tr >
2009-12-24 08:42:52 +00:00
<td ><a href="http://orgmode.org/img/shirts.jpg" >
2009-12-18 11:47:51 +00:00
<img src="http://orgmode.org/img/shirts.jpg"
style="border:1px solid black; width:200px"
alt="http://orgmode.org/img/shirts.jpg" / ></a >
2009-12-18 11:51:32 +00:00
<span style="font-size: 90%;" ></br >
2009-12-18 13:57:21 +00:00
<div style="margin-top:10px;" >
Promote Org-mode and support its development by
2010-01-03 15:45:29 +00:00
getting your Org-mode T-shirt, bag, or mug in either
the
<a href="http://orgmode.spreadshirt.com" >US-Shop</a >
or the
<a href="http://orgmode.spreadshirt.de" >EU-Shop</a >
2009-12-18 11:47:51 +00:00
</span >
</td >
</tr >
2009-12-18 10:42:09 +00:00
2009-12-18 11:47:51 +00:00
<tr >
2009-12-18 13:57:21 +00:00
<td style="vertical-align:bottom;" >
<div style="float:bottom; border:0px solid black;
padding:0px; vertical-align:bottom; margin-top:5px;">
<form style="float:right;padding:5px;" name= "_xclick"
2009-12-18 11:47:51 +00:00
action="https://www.paypal.com/cgi-bin/webscr" method= "post">
<div >
<input type="hidden" name="cmd" value="_xclick" / >
<input type="hidden" name="business" value="carsten.dominik@gmail.com" / >
<input type="hidden" name="item_name" value="Donate to Org-mode" / >
<input type="hidden" name="currency_code" value="USD" / >
<input type="hidden" name="lc" value="US"/ >
<input type="hidden" name="amount" / >
<input type="image" style= "text-align:right;margin-left:auto;margin-right:0px;border-style:none;"
src="http://www.paypal.com/en_US/i/btn/x-click-but04.gif"
name="submit"
alt="Make payments with PayPal - it's fast, free and secure!" />
</div >
</form >
2009-12-18 13:57:21 +00:00
<span style="font-size: 90%;margin-top:10px;" >
... or by making a direct donation.</span >
2009-12-18 11:47:51 +00:00
</div >
</td >
</tr >
</table >
2009-07-28 18:51:33 +00:00
</td >
2009-12-18 11:47:51 +00:00
</table >
2009-06-26 18:23:26 +00:00
#+end_html
2009-12-24 08:39:53 +00:00
- Simplicity :: At its core, Org-mode is a simple outliner for
note-taking and list management. You can learn the basics for
using it in [[http://orgmode.org/worg/org-tutorials/orgtutorial_dto.php ][five minutes ]]. This may be all you need, and Org-mode
will not impose more complex features on you.
- Portability :: Org files are [[http://en.wikipedia.org/wiki/Plain_text ][plain text ]]. You can view and edit them
in any editor, or add and extract data with custom-made scripts.
Your data will never be locked into an obscure or proprietary
data format. 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-12-24 08:39:53 +00:00
simple outline. The full feature set is both broad and deep,
easy to access, but unobtrusive. The [[http://orgmode.org/worg/org-faq.php ][typical answer ]] to "/Can it
do X?/" is "/Yes!/ ".
2009-01-07 17:54:34 +00:00
- 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-12-24 08:39:53 +00:00
- Support :: Org-mode is [[http://orgmode.org/manual/index.html ][documented extensively ]], and many [[http://orgmode.org/worg/org-tutorials/index.php ][tutorials ]]
put spotlights on particular features. Org-mode is supported by
an active [[id:0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26 ][mailing list ]] where questions are answered quickly and
effectively.
2009-06-26 13:04:27 +00:00
- It's free! :: Org is [[http://en.wikipedia.org/wiki/Open-source_software ][open source software ]], it is [[http://www.gnu.org/licenses/licenses.html#GPL ][free ]], like Emacs.
2008-01-31 15:04:26 +00:00
2009-12-24 08:39:53 +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-11-06 11:03:13 +00:00
#+ATTR_HTML : style="float:right;"
[[http://mobileorg.ncogni.to/ ][http://mobileorg.ncogni.to/images/screenshot-browse.png ]]
2010-09-25 06:27:54 +00:00
- <2010-09-24 Fri >: FLOSS Weekly [[http://twit.tv/floss136 ][interview ]] with Carsten available
2010-07-19 06:33:24 +00:00
- <2010-04-06 Tue >: Release 7.01
2010-06-06 10:43:42 +00:00
- <2010-06-06 Sun >: iPhone App [[http://mobileorg.ncogni.to/ ][MobileOrg ]] version 1.3 introduces
DropBox support, for vastly easier setup.
2010-04-06 07:16:36 +00:00
- <2010-04-06 Tue >: Release 6.35
2008-07-17 17:53:35 +00:00
2010-10-29 06:44:15 +00:00
* Current Version (7.02)
2008-01-31 15:04:26 +00:00
2010-10-29 06:44:15 +00:00
The current version is 7.02. 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-08-06 05:08:54 +00:00
on XEmacs 21. Emacs 22.2 ships with Org-mode version 4.67d, Emacs
23.1 with 6.21b. The latest CVS Emacs trunk usually contains a fairly
recent version, but may lag 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
2010-10-29 06:44:15 +00:00
Download as [[file:org-7.02.zip ][zip file ]] or [[file:org-7.02.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
2010-10-26 05:18:31 +00:00
online]]. At any time you can get a [[http://repo.or.cz/w/org-mode.git/snapshot ][snapshot ]] of the files in it. To
get a local clone of the repository use something like the following
(from the command line....):
2008-07-22 17:53:14 +00:00
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
2010-08-17 10:43:56 +00:00
git, we provide [[file:org-latest.zip ][zip ]] or [[file:org-latest.tar.gz ][tar.gz ]] snapshot release files updated each day
2010-10-27 22:47:46 +00:00
and corresponding to the latest git version. Alternatively, you can
also download a [[http://repo.or.cz/w/org-mode.git/snapshot ][tar.gz snapshot ]] from the repo.or.cz server.
2008-07-25 21:04:26 +00:00
2008-06-17 11:56:38 +00:00
** Alternative distributions
2009-04-21 12:43:45 +00:00
There are several alternative distributions of Org. Some of these
are more up-to-date than others, so check if this package really
has a recent version
2008-06-17 11:56:38 +00:00
2009-04-21 12:43:45 +00:00
- The [[http://packages.debian.org/sid/main/org-mode ][Debian package ]] is maintained by Sebastien Delafond.
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-04-21 12:43:45 +00:00
- The [[http://savannah.gnu.org/cvs/%3Fgroup%3Demacs ][Emacs CVS ]] contains a more-or-less recent version.
- 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
2010-07-19 11:14:55 +00:00
** The Org guide and manual
2010-07-21 03:39:42 +00:00
- Read the [[file:guide/index.html ][online compact guide ]] or download it as a [[file:orgguide.pdf ][PDF document ]].
2010-07-19 11:14:55 +00:00
The compact guide is a 40-page introduction to Org mode. It
covers all features in a basic way and has links to in-depth
documentation in the manual and on the web.
- Read the [[file:manual/index.html ][online manual ]]. The manual covers the complete feature
set with all the bells and whistles, in a systematic way. The
main structure is identical to the guide, so it is easy to go
back and forth between basic and advanced documentation.
2009-01-07 13:41:57 +00:00
- You can also have the entire manual in a [[file:org.html ][single monolithic file ]].
2010-07-19 11:14:55 +00:00
- Download the manual as a 200-page [[file:org.pdf ][PDF document ]].
2010-08-09 19:59:07 +00:00
- Translations of the manual
- A [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual ][Japanese translation ]] of an older version (4.60), by Takeshi
Okano.
- A [[http://gnu.manticore.es/manual-org-emacs ][Spanish translation ]] (version 6.21b).
2009-01-07 13:41:57 +00:00
2008-06-18 04:18:27 +00:00
** Reference card
- Download the [[file:orgcard.pdf ][Refcard ]] for org-mode
2010-05-12 14:21:00 +00:00
- There is also a [[file:orgcard.txt ][text version ]] of the
reference card.
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
2010-03-06 16:29:58 +00:00
** Talks about Org-mode
2010-03-06 16:35:43 +00:00
Check out the [[file:talks/index.html#sec-1 ][Google Tech Talk ]] about Org-mode, or another talk
2010-09-25 06:27:54 +00:00
given at the [[file:talks/index.html#sec-2 ][Max Planck Institute for Neurological Research ]]. On
FLOSS Weekly [[http://twit.tv/floss136 ][show number 136 ]] Randal Schwartz interviews Carsten
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
2010-10-27 22:27:09 +00:00
will look at the message before passing it through to the 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 ]].
2010-10-27 22:27:09 +00:00
- Please read the [[http://orgmode.org/manual/Feedback.html ][Feedback ]] section of Org's manual before posting a
question, it helps getting useful answer. [[http://www.catb.org/esr/faqs/smart-questions.html][How To Ask Questions
The Smart Way]], by E. S. Raymond is also worth reading.
2008-04-03 12:37:44 +00:00
2008-01-31 15:04:26 +00:00
#+BEGIN_HTML
2009-06-24 18:46:35 +00:00
</li ><li ><form method="get" action="http://search.gmane.org/" ><div >
<input type="text" name="query" / >
<input type="hidden" name="group" value="gmane.emacs.orgmode" / >
<input type="submit" value="Search gmane.emacs.orgmode" / >
</div ></form >
2008-01-31 15:04:26 +00:00
#+END_HTML
2010-05-23 05:41:19 +00:00
** MobileOrg
[[http://mobileorg.ncogni.to/ ][MobileOrg ]] is an excellent open source application to read and
change Org-files on the road, using an iPhone, and then sync the
changes back to your computer. Check out Richard's [[http://mobileorg.ncogni.to/ ][page ]].
Matt Jones is currently developing a compatible application for
Android, and this project is [[http://wiki.github.com/matburt/mobileorg-android/ ][hosted here ]].
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-10-21 14:17:01 +00:00
add-on, this is very welcome too! Detailed information on how and
what to contribute can be found [[http://orgmode.org/worg/org-contribute.php ][here ]].
2009-01-07 13:41:57 +00:00