ORGWEBPAGE/index.org

   1
   2 #+TITLE:     Org-Mode Homepage
   3 #+LANGUAGE:  en
   4 #+EMAIL:     carsten at orgmode dot org
   5 #+OPTIONS:   H:3 num:nil toc:2 \n:nil @:t ::t |:t ^:t *:t TeX:t
   6
   7 * Org - an Emacs Mode for Notes and Project Planning
   8
   9 #+HTML:  <BASE href="http://orgmode.org/index.html">
  10
  11 Org-mode is a mode for keeping notes, maintaining ToDo lists, and doing
  12 project planning with a fast and effective plain-text system.
  13
  14 Org-mode develops organizational tasks around NOTES files that contain
  15 information about projects as plain text.  Org-mode is implemented on
  16 top of outline-mode, which makes it possible to keep the content of
  17 large files well structured.  Visibility cycling and structure editing
  18 help to work with the tree.  Tables are easily created with a built-in
  19 table editor.  Org-mode supports ToDo items, deadlines, time stamps,
  20 and scheduling.  It dynamically compiles entries into an agenda.
  21 Plain text URL-like links connect to websites, emails, Usenet
  22 messages, BBDB entries, and any files related to the projects.  For
  23 printing and sharing of notes, an Org-mode file can be exported as a
  24 structured ASCII file, HTML, and LaTeX.
  25
  26 * Current Version (6.05a) and Compatibility
  27
  28 The current version is 6.05a.  To see what has changed in recent
  29 releases, check this [[file:Changes.html][list of user-visible changes]].  These descriptions
  30 are extensive, to avoid that people will be printing the manual after
  31 each incremental release.  If you have an older version of the manual,
  32 just check the release notes and you will be up-to-date.
  33
  34 This package works on Emacs 23 and 22, and (with minor restrictions)
  35 on Emacs 21 and XEmacs 21 (where you must also use
  36 /xemacs/noutline.el/ shipped with Org-mode).  The Emacs 22.2 release
  37 ships with Org-mode version 4.67d.  The latest CVS emacs trunk usually
  38 contains a fairly recent version, but may lag a bit behind the website
  39 release.
  40
  41 * Downloads
  42
  43 ** The standard distribution
  44
  45 Download as [[file:org-6.05a.zip][zip file]] or [[file:org-6.05a.tar.gz][gzipped tar archive]].  These archives contain
  46 both the Lisp file org.el and the documentation in PDF and (TeX)Info
  47 formats.  A shell script to simplify upgrading to the newest release
  48 has been posted [[http://www.philfam.co.uk/pete/GTD/org-mode/update-org.sh][here]].
  49
  50 ** The development version
  51
  52 You can check out the latest Org development version (along with every
  53 release we ever had) by using git.  More information on this page:
  54 http://repo.or.cz/w/org-mode.git
  55
  56 ** Alternative distributions
  57
  58    There are several alternative distrbutions of Org:
  59
  60    - The [[http://savannah.gnu.org/cvs/%3Fgroup%3Demacs][Emacs CVS]] contains a recent version
  61    - The Debian packages are planned.
  62    - Mark A. Hershberger has made some [[https://launchpad.net/~hexmode/+archive][Ubuntu packages]] for Org, but
  63      these seem to be out of date.
  64
  65 * Documentation
  66 ** The Org manual
  67    - Read the documentation [[file:manual/index.html][online]].  This is a version consisting of many
  68      small files, to save bandwidth.
  69    - If you really need it, you can also have the entire manual in a
  70      [[file:org.html][single monolithic file]].
  71    - Download the documentation in other formats: [[file:org.pdf][PDF]], [[file:org][Info]], or [[file:org.texi][TeXInfo]].
  72    - There is also a [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual][Japanese translation]] of the manual (version 4.60),
  73      produced by Takeshi Okano.
  74    - The Org manual is a GNU Manual released under the GFDL.  If you
  75      want to redistribute Org with a distribution that does not allow
  76      the GFDL to be used, and if you see no other way to resolve this
  77      licensing conflict, you must use the special [[file:org_dual_license.texi][dual-license version]]
  78      of the manual.
  79 ** Reference card
  80    - Download the [[file:orgcard.pdf][Refcard]] for org-mode
  81    - Kyle Sherman has created a [[file:orgcard.txt][text version]] of the reference card
  82      (Org version 4.79).
  83 ** The FAQ
  84    - The [[http://orgmode.org/worg/org-faq.php][Org Mode FAQ]] is user-editable and is maintained by the [[http://orgmode.org/worg/][Worg
  85      project]].
  86
  87 * Links
  88
  89 ** Mailing list
  90
  91    There is a mailing list for discussion about org-mode.
  92
  93    - Subscribe to it at [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][this webpage]].
  94    - Directly [[mailto:emacs-orgmode@gnu.org][send mail to it]].  If you are not subscribed, a moderator
  95      will look at the message before passing it through to the
  96      list.  If that has happened once, future messages from your email
  97      address will get through immediately, even if you remain
  98      unsubscribed.
  99    - Read the list on [[http://www.gmane.org][Gmane]] through a [[http://news.gmane.org/gmane.emacs.orgmode][web interface]] or with a
 100      [[news://news.gmane.org/gmane.emacs.orgmode][newsreader]].
 101
 102 #+BEGIN_HTML
 103 <li><form method="get" action="http://search.gmane.org/">
 104 <input type="text" name="query">
 105 <input type="hidden" name="group" value="gmane.emacs.orgmode">
 106 <input type="submit" value="Search gmane.emacs.orgmode">
 107 </form>
 108 #+END_HTML
 109
 110 ** Worg - user-driven knowledge-base about org-mode
 111
 112 [[http://orgmode.org/worg/][Worg]], created by [[http://www.cognition.ens.fr/~guerry/][Bastien Guerry]], is a setup to allow users to jointly
 113 edit a number of Org-mode files containing documentation about
 114 Org-mode.  This is something like a wiki, but with the advantage that
 115 you do not have to be online to modify a file.  If you'd like to
 116 contribute your own setup, screenshots, tutorials etc, please go to
 117 [[http://orgmode.org/worg/][the Worg page]], and start from there.
 118
 119 ** Tutorials
 120
 121    [[http://orgmode.org/worg/org-tutorials/index.php][Tutorials and screencasts]] are maintained by the [[http://orgmode.org/worg][Worg project]].
 122
 123 ** Survey
 124
 125    In November 2007, Charles Cave organized a survey among Org-mode
 126    users.  The answers given in this survey can be found [[file:survey.html][here]].
 127
 128 ** GTD & Co
 129
 130    [[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
 131    other task management systems]].
 132
 133 ** Contributing to Org-mode
 134
 135    You can always contribute with ideas and bug reports on the mailing
 136    list.  If you want to contribute a patch, code snippets, or a full
 137    add-on, this is very welcome too!  However, I can only make it an
 138    official part of Org-mode if you have signed the papers with the
 139    Free Software Foundation.  Org-mode is distributed as part of Emacs
 140    and must therefore adhere to strict rules about the copyright of
 141    all included material.  If this is what you want to do, [[file:request-assign-future.txt][here]] is the
 142    form that you have to fill in and send to the FSF.  After you
 143    received the final copy with signatures, please scan it and send
 144    the scan to the maintainer.
 145
 146 ** Future Development
 147
 148    Org-mode is still developing fast.  The best way to stay up-to-date
 149    is to join the mailing list where the changes are developed and
 150    discussed.
 151
 152    Here is a loose [[file:todo.org][list of ideas]] that are still to be processed
 153    somehow, when I get to it...
 154
 155 ** Related Software
 156
 157    [[http://www.emacswiki.org/cgi-bin/wiki][The Emacs Wiki]] has extensive lists of related software in the
 158    categories
 159    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryOutline][Outline]]
 160    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryHypermedia][Hypermedia]]
 161    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTables][Tables]]
 162    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryPersonalInformationManager][Personal Information Manager]]
 163    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryCalendar][Calendar]]
 164    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTodo][Todo]]
 165    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTimeTracking][Time tracking]]
 166    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryJournaling][Journaling]]