13 KiB
Org-Mode: Your Life in Plain Text
<!– The logo links to the root of the website –> <a href="/"><img src="" class="logo-link" /></a>
#*Org - an Emacs Mode for Notes, Project Planning, and Authoring*
<table> <tr> <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. </td> </table> </br> </br>
<table width="750px"> <tr> <td><br><img src="" style="border:1px solid black; width:500px" alt=""/> </td>
<td> <table width="220px"> <tr><td><h3 style="text-align:center;vertical-align:bottom;">Shirts and Donations</h3></td></tr> <tr> <td><a href=""> <img src="" style="border:1px solid black; width:200px" alt="" /></a> <span style="font-size: 90%;"></br> <div style="margin-top:10px;">
Promote Org-mode and support its development by 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> </span> </td> </tr>
<tr> <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" action="https://www.paypal.com/cgi-bin/webscr" method="post"> <div> <input type="hidden" name="cmd" value="_xclick" /> <input type="hidden" name="business" value="bastien1@free.fr" /> <input type="hidden" name="item_name" value="Emacs Org-mode maintainance" /> <input type="hidden" name="item_number" value="1" /> <input type="hidden" name="no_note" value="1" /> <input type="hidden" name="currency_code" value="EUR" /> <input type="hidden" name="tax" value="0" /> <input type="image" src="" name="submit" alt="Make a donation!" /> </div> </form>
<span style="font-size: 90%;margin-top:10px;"> … or by making a direct donation.</span> </div> </td> </tr> </table> </td> </table>
- 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 five minutes. This may be all you need, and Org-mode will not impose more complex features on you.
- Portability
- Org files are 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 Emacs, which is available for nearly every platform.
- Depth
- Org-mode will not let you down when you need more than a simple outline. The full feature set is both broad and deep, easy to access, but unobtrusive. The typical answer to "Can it do X?" is "Yes!".
- Flexibility
- Org-mode is like a Swiss army knife. People use it for Getting Things Done (GTD), as a Day Planner, as a Notebook, for Web and PDF Authoring, and much more.
- Support
- Org-mode is documented extensively, and many tutorials put spotlights on particular features. Org-mode is supported by an active mailing list where questions are answered quickly and effectively.
- It's free!
- Org is open source software, it is free, like Emacs.
If you'd like to know what other people have said about Org-mode, take a look at our collected quotes about Org.
News
- <2010-12-17 Fri> The Org manual is now available as book published by Network Theory Ltd, at a retail price of $14.95. For each book sold, $1 is donated to the Org project.
- <2010-12-10 Fri>: Release 7.04.
- <2010-12-03 Fri>: MobileOrg for Android supports Voice Capture
- <2010-11-25 Thu>: Maybe the times where Org mode could change hard-core vi users into honorable Emacs users are coming to an end? A Vim clone of Org mode is be written by Herbert Sitz, and judging by the videos it looks promising.
- <2010-06-06 Sun>: iPhone App MobileOrg version 1.5 introduces encryption.
Current Version (7.4)
The current version is 7.4. To see what has changed in recent releases, check this detailed list of user-visible changes.
This package works on Emacs 23 and 22, and (with minor restrictions) 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.
Downloads
The standard distribution
Download as zip file or gzipped tar archive. These archives contain both the Lisp file org.el and the documentation in PDF and (TeX)Info formats. Follow the instructions for Installation and Activation.
The development version
You can check out the latest Org development version (along with every release we ever had) by using git. The git repository is browsable online. At any time you can get a snapshot of the files in it. To get a local clone of the repository use something like the following (from the command line….):
git clone git://repo.or.cz/org-mode.git
Some more information about this can be found in the FAQ, under How do I keep current with Org mode development?. For people who cannot use git, we provide zip or tar.gz snapshot release files updated each day and corresponding to the latest git version. Alternatively, you can also download a tar.gz snapshot from the repo.or.cz server.
Alternative distributions
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
- The Debian package is maintained by Sebastien Delafond.
- There is also a package on Archlinux, by Jiyunatori.
- The Emacs development version contains a more-or-less recent version.
- The Fink package for Mac OS X by Jesse Alama.
- The Ubuntu package by Mark A. Hershberger.
Documentation
The Org guide and manual
- Read the online compact guide or download it as a PDF document. 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 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.
- You can also have the entire manual in a single monolithic file.
- Download the manual as a 200-page PDF document.
- Buy a paperback edition of the manual from Network Theory Ltd. One Euro of each book sold is donated to Org mode project.
-
Translations of the manual
- A Japanese translation of an older version (4.60), by Takeshi Okano.
- A Spanish translation (version 6.21b).
Reference card
- Download the Refcard for org-mode
- There is also a text version of the reference card.
The FAQ
- The Org Mode FAQ is user-editable and is maintained by the Worg project.
Tutorials
- A complete list of Tutorials and screencasts is maintained by the Worg project.
Links
Talks about Org-mode
Check out the Google Tech Talk about Org-mode, or another talk given at the Max Planck Institute for Neurological Research. On FLOSS Weekly show number 136 Randal Schwartz interviews Carsten about Org mode.
Mailing list
There is a mailing list for discussion about org-mode.
- Subscribe to it at the web interface.
- Directly send mail to it. If you are not subscribed, a moderator will look at the message before passing it through to the list.
- Read the list on Gmane through a web interface or with a newsreader.
- Please read the Feedback section of Org's manual before posting a question, it helps getting useful answer. How To Ask Questions The Smart Way, by E. S. Raymond is also worth reading.
</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>
MobileOrg
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 page.
Matt Jones is currently developing a compatible application for Android, and this project is hosted here.
Worg
Worg, created by Bastien Guerry, is a setup to allow users to jointly edit a number of Org-mode files containing documentation about Org-mode, including the Org Mode FAQ and 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 be online while editing it. If you'd like to contribute to Worg, please go to the Worg page, and start from there.
Contributing to Org-mode
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 add-on, this is very welcome too! Detailed information on how and what to contribute can be found here.