org-mode/ORGWEBPAGE/index.org

#+TITLE:     Org-Mode Homepage
#+LANGUAGE:  en
#+EMAIL:     carsten at orgmode dot org
#+OPTIONS:   H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:t *:t TeX:t

* Org - an Emacs Mode for Notes and Project Planning

#+HTML:  <BASE href="http://orgmode.org/index.html">

#+BEGIN_HTML
<form action="http://www.google.com/cse" id="cse-search-box">
  <div>
    <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

Org-mode is a mode for keeping notes, maintaining ToDo lists, and doing
project planning with a fast and effective plain-text system.

Org-mode develops organizational tasks around NOTES files that contain
information about projects as plain text.  Org-mode is implemented on
top of outline-mode, which makes it possible to keep the content of
large files well structured.  Visibility cycling and structure editing
help to work with the tree.  Tables are easily created with a built-in
table editor.  Org-mode supports ToDo items, deadlines, time stamps,
and scheduling.  It dynamically compiles entries into an agenda.
Plain text URL-like links connect to websites, emails, Usenet
messages, BBDB entries, and any files related to the projects.  For
printing and sharing of notes, an Org-mode file can be exported as a
structured ASCII file, HTML, and LaTeX.

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

- Check out [[http://article.gmane.org/gmane.emacs.orgmode/8547][Russel Adams' presentations]] with the Houston Linux User
  Group.  This is a two part video with much of the first part about
  other stuff, but the end of the first part and all of the second is
  really about Org-mode.

- Check out the [[file:GoogleTech.org][Google Tech Talk]] about Org-mode.

* Current Version (6.17a) and Compatibility

The current version is 6.17a.  To see what has changed in recent
releases, check this [[file:Changes.html][list of user-visible changes]].  These descriptions
are extensive, to avoid that people will be printing the manual after
each incremental release.  If you have an older version of the manual,
just check the release notes and you will be up-to-date.

This package works on Emacs 23 and 22, and (with minor restrictions)
on Emacs 21 and XEmacs 21 (where you must also use
/xemacs/noutline.el/ shipped with Org-mode).  The Emacs 22.2 release
ships with Org-mode version 4.67d.  The Emacs 23.1 release is expected
to ship with 6.16.  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.17a.zip][zip file]] or [[file:org-6.17a.tar.gz][gzipped tar archive]].  These archives contain
both the Lisp file org.el and the documentation in PDF and (TeX)Info
formats.  A shell script to simplify upgrading to the newest release
has been posted [[http://www.philfam.co.uk/pete/GTD/org-mode/update-org.sh][here]].

** 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
/How can I keep current with Org mode development?/.

** Alternative distributions

   There are several alternative distrbutions of Org:

   - The [[http://savannah.gnu.org/cvs/%3Fgroup%3Demacs][Emacs CVS]] contains a recent version
   - There is also a package on [[http://aur.archlinux.org/packages.php?do_Details&ID=18206][Archlinux]], by Jiyunatori.
   - The [[http://packages.debian.org/sid/main/org-mode][Debian package]] is maintainned by Sebastien Delafond
   - The [[http://pdb.finkproject.org/pdb/package.php/org-mode][Fink package]] for Mac OS X by Jesse Alama
   - Mark A. Hershberger has made an [[https://launchpad.net/~hexmode/+archive][Ubuntu package]] for Org, but
     that seems to be out of date.

* Documentation
** The Org manual
   - Read the documentation [[file:manual/index.html][online]].  This is a version consisting of many
     small files, to save bandwidth.  
   - If you really need it, 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]].
   - There is also a [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual][Japanese translation]] of the manual (version 4.60),
     produced by Takeshi Okano.
   - The Org manual is a GNU Manual released under the GFDL.  If you
     want to redistribute Org with a distribution that does not allow
     the GFDL to be used, and if you see no other way to resolve this
     licensing conflict, you must use the special [[file:org_dual_license.texi][dual-license version]]
     of the manual.
** 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]]. 

* Links

** Google Tech Talk
   Check out the [[file:GoogleTech.org][Google Tech Talk]] about Org-mode.

** Mailing list

   There is a mailing list for discussion about org-mode.

   - Subscribe to it at [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][this webpage]].
   - 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.  If that has happened once, future messages from your email
     address will get through immediately, even if you remain
     unsubscribed.
   - 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><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

** Worg - User-edited content

[[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 by
posting your own special setup, screenshots, tutorials etc, please go
to [[http://orgmode.org/worg/][the Worg page]], and start from there.

** Tutorials

   [[http://orgmode.org/worg/org-tutorials/index.php][Tutorials and screencasts]] are maintained by the [[http://orgmode.org/worg][Worg project]].

** Survey

   In November 2007, Charles Cave organized a survey among Org-mode
   users.  The answers given in this survey can be found [[file:survey.html][here]].

** GTD & Co

   [[http://orgmode.org/worg/][Worg]] also has a list of links related to using Org for [[http://orgmode.org/worg/org-gtd-etc.php][GTD and
   other task management systems]].

** 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!  However, I can only make it an
   official part of Org-mode if you have signed the papers with the
   Free Software Foundation.  Org-mode is distributed as part of Emacs
   and must therefore adhere to strict rules about the copyright of
   all included material.  If this is what you want to do, [[file:request-assign-future.txt][here]] is the
   form that you have to fill in and send to the FSF.  After you
   received the final copy with signatures, please scan it and send
   the scan to the maintainer.

** Future Development

   Org-mode is still developing fast.  The best way to stay up-to-date
   is to join the mailing list where the changes are developed and
   discussed.

   Here is a loose [[file:todo.org][list of ideas]] that are still to be processed
   somehow, when I get to it...

** Related Software

   [[http://www.emacswiki.org/cgi-bin/wiki][The Emacs Wiki]] has extensive lists of related software in the
   categories
   - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryOutline][Outline]]
   - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryHypermedia][Hypermedia]]
   - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTables][Tables]]
   - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryPersonalInformationManager][Personal Information Manager]]
   - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryCalendar][Calendar]]
   - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTodo][Todo]]
   - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTimeTracking][Time tracking]]
   - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryJournaling][Journaling]]