forked from mirrors/org-mode
219 lines
10 KiB
Org Mode
219 lines
10 KiB
Org Mode
|
|
#+TITLE: Org-Mode: Your Life in Plain Text
|
|
#+LANGUAGE: en
|
|
#+EMAIL: carsten at orgmode dot org
|
|
#+OPTIONS: H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:t *:t TeX:t author:nil <:t LaTeX:t
|
|
#+STYLE: <base href="http://orgmode.org/index.html" />
|
|
#+STYLE: <link rel="stylesheet" href="http://orgmode.org/org.css" type="text/css" />
|
|
*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.
|
|
|
|
#+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>
|
|
<table width="100%">
|
|
<tr>
|
|
<td rowspan="2">
|
|
<img src="http://orgmode.org/img/tasks.png" style="border:1px solid
|
|
black; width:400px" alt="http://orgmode.org/img/tasks.png" />
|
|
</td>
|
|
<td>
|
|
|
|
<h3 style="text-align:center;">Vote for
|
|
Org-mode</h3><span style="font-size: 80%;">Org-mode is a finalist in the
|
|
2009 Sourceforge Community Choice Awards in the final category <i>Most
|
|
Likely to Change the Way you do Everything</i>. This is a fantastic
|
|
opportunity to make more people aware of this package. Please
|
|
<a href="http://sf.net/awards/cca/badge_img.php?f=401">go vote for Org-mode.</a>
|
|
<a href="http://sf.net/community/cca09/vote/?f=401"><br />
|
|
<img src="http://sf.net/awards/cca/badge_img.php?f=401" style="border-style:none;vertical-align:top;" alt="" />
|
|
</a>
|
|
</span>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
|
|
|
|
|
|
<td style="vertical-align:bottom;">
|
|
<div style="float:bottom; border:0px solid black; padding:3px
|
|
vertical-align:bottom;">
|
|
<h3 style="text-align:center;">Donations</h3>
|
|
<span style="font-size: 80%;">
|
|
If you are looking for <a
|
|
href="http://thread.gmane.org/gmane.emacs.orgmode/14209">a way to say
|
|
"thank you"</a>, or if you'd like to
|
|
support the future development of Org-mode with a donation, use the
|
|
button below.</span>
|
|
<br />
|
|
<hr />
|
|
<form style="float:right;" 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="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>
|
|
</div>
|
|
</td>
|
|
|
|
<td>
|
|
|
|
</td>
|
|
|
|
|
|
</tr>
|
|
</table>
|
|
#+end_html
|
|
|
|
- Simplicity :: 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 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.
|
|
- Depth :: Org-mode will not let you down when you need more than a
|
|
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]].
|
|
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.
|
|
- Support :: Org-mode is supported by an active [[id:0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26][mailing list]] where
|
|
questions are answered quickly and effectively.
|
|
- It's free! :: Org is [[http://en.wikipedia.org/wiki/Open-source_software][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 [[http://orgmode.org/worg/org-quotes.php][collected quotes about Org]].
|
|
|
|
* News
|
|
- <2009-06-25 Thu>: Release 6.28
|
|
- <2009-05-23 Sat>: Release 6.27
|
|
- <2009-04-19 Sun>: Release 6.26
|
|
- <2009-04-01 Wed>: Release 6.25
|
|
|
|
* Current Version (6.28c)
|
|
|
|
The current version is 6.28c. To see what has changed in recent
|
|
releases, check this detailed list of [[file:Changes.html][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 release is expected to ship 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 [[file:org-6.28c.zip][zip file]] or [[file:org-6.28c.tar.gz][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 [[http://orgmode.org/manual/Installation.html#Installation][Installation]] and [[http://orgmode.org/manual/Activation.html#Activation][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 [[http://repo.or.cz/w/org-mode.git][browsable
|
|
online]]. To get a local clone 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 [[http://orgmode.org/worg/org-faq.php][FAQ]], under [[http://orgmode.org/worg/org-faq.php#keeping-current-with-Org-mode-development][How do
|
|
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.
|
|
|
|
** 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 [[http://packages.debian.org/sid/main/org-mode][Debian package]] is maintained by Sebastien Delafond.
|
|
- There is also a package on [[http://aur.archlinux.org/packages.php?do_Details&ID=18206][Archlinux]], by Jiyunatori.
|
|
- 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.
|
|
- The [[https://launchpad.net/~hexmode/+archive][Ubuntu package]] by Mark A. Hershberger.
|
|
|
|
* Documentation
|
|
** The Org manual
|
|
- Read the [[file:manual/index.html][documentation online]].
|
|
- You can also have the entire manual in a [[file:org.html][single monolithic file]].
|
|
- Download the documentation as a [[file:org.pdf][PDF document]].
|
|
- A [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual][Japanese translation]] of the manual (version 4.60), by Takeshi
|
|
Okano.
|
|
|
|
** 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
|
|
(Org version 6.07).
|
|
** The FAQ
|
|
- 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]].
|
|
|
|
** 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]].
|
|
|
|
* Links
|
|
|
|
** Google Tech Talk
|
|
Check out the [[file:GoogleTech.org][Google Tech Talk]] about Org-mode.
|
|
|
|
** Mailing list
|
|
:PROPERTIES:
|
|
:ID: 0B280B26-A3AB-4E5C-B4EE-B7FFC52C4D26
|
|
:END:
|
|
|
|
There is a mailing list for discussion about org-mode.
|
|
|
|
- [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][Subscribe to it]] at the web interface.
|
|
- 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
|
|
list.
|
|
- 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]].
|
|
|
|
#+BEGIN_HTML
|
|
</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>
|
|
#+END_HTML
|
|
|
|
** Worg
|
|
|
|
[[http://orgmode.org/worg/][Worg]], created by [[http://www.cognition.ens.fr/~guerry/][Bastien Guerry]], is a setup to allow users to jointly
|
|
edit a number of Org-mode files containing documentation about
|
|
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
|
|
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.
|
|
|
|
** 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! 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.
|
|
|