Customizable faces for individual tags.
[org-mode/org-tableheadings.git] / ORGWEBPAGE / index.org
blob67687f24be48f87b963a5d6c67ef205173c9fb9a
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
7 * Org - an Emacs Mode for Notes and Project Planning
9 #+HTML:  <BASE href="http://orgmode.org/index.html">
11 #+BEGIN_HTML
12 <form action="http://www.google.com/cse" id="cse-search-box">
13   <div>
14     <input type="hidden" name="cx" value="002987994228320350715:2gaddxoioh4" />
15     <input type="hidden" name="ie" value="UTF-8" />
16     <input type="text" name="q" size="31" />
17     <input type="submit" name="sa" value="Search this website" />
18   </div>
19 </form>
20 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en"></script>
21 #+END_HTML
23 Org-mode is a mode for keeping notes, maintaining ToDo lists, and doing
24 project planning with a fast and effective plain-text system.
26 Org-mode develops organizational tasks around NOTES files that contain
27 information about projects as plain text.  Org-mode is implemented on
28 top of outline-mode, which makes it possible to keep the content of
29 large files well structured.  Visibility cycling and structure editing
30 help to work with the tree.  Tables are easily created with a built-in
31 table editor.  Org-mode supports ToDo items, deadlines, time stamps,
32 and scheduling.  It dynamically compiles entries into an agenda.
33 Plain text URL-like links connect to websites, emails, Usenet
34 messages, BBDB entries, and any files related to the projects.  For
35 printing and sharing of notes, an Org-mode file can be exported as a
36 structured ASCII file, HTML, and LaTeX.
38 * News
40 - Check out [[http://article.gmane.org/gmane.emacs.orgmode/8547][Russel Adams' presentations]] with the Houston Linux User
41   Group.  This is a two part video with much of the first part about
42   other stuff, but the end of the first part and all of the second is
43   really about Org-mode.
45 - Check out the [[file:GoogleTech.org][Google Tech Talk]] about Org-mode.
47 * Current Version (6.13a) and Compatibility
49 The current version is 6.13a.  To see what has changed in recent
50 releases, check this [[file:Changes.html][list of user-visible changes]].  These descriptions
51 are extensive, to avoid that people will be printing the manual after
52 each incremental release.  If you have an older version of the manual,
53 just check the release notes and you will be up-to-date.
55 This package works on Emacs 23 and 22, and (with minor restrictions)
56 on Emacs 21 and XEmacs 21 (where you must also use
57 /xemacs/noutline.el/ shipped with Org-mode).  The Emacs 22.2 release
58 ships with Org-mode version 4.67d.  The Emacs 23 release is expected
59 to ship with 6.13. The latest CVS emacs trunk usually contains a
60 fairly recent version, but may lag a bit behind the website release.
62 * Downloads
64 ** The standard distribution
66 Download as [[file:org-6.13a.zip][zip file]] or [[file:org-6.13a.tar.gz][gzipped tar archive]].  These archives contain
67 both the Lisp file org.el and the documentation in PDF and (TeX)Info
68 formats.  A shell script to simplify upgrading to the newest release
69 has been posted [[http://www.philfam.co.uk/pete/GTD/org-mode/update-org.sh][here]].
71 ** The development version
73 You can check out the latest Org development version (along with every
74 release we ever had) by using git.  The git repository is [[http://repo.or.cz/w/org-mode.git][browsable
75 online]].  To get a local clone use something like the following (from 
76 the command line....):
78 : git clone git://repo.or.cz/org-mode.git
80 Some more information about this can be found in the [[http://orgmode.org/worg/org-faq.php][FAQ]], under
81 /How can I keep current with Org mode development?/.
83 ** Alternative distributions
85    There are several alternative distrbutions of Org:
87    - The [[http://savannah.gnu.org/cvs/%3Fgroup%3Demacs][Emacs CVS]] contains a recent version
88    - There is also a package on [[http://aur.archlinux.org/packages.php?do_Details&ID=18206][Archlinux]], by Jiyunatori.
89    - The [[http://packages.debian.org/sid/main/org-mode][Debian package]] is maintainned by Sebastien Delafond
90    - The [[http://pdb.finkproject.org/pdb/package.php/org-mode][Fink package]] for Mac OS X by Jesse Alama
91    - Mark A. Hershberger has made an [[https://launchpad.net/~hexmode/+archive][Ubuntu package]] for Org, but
92      that seems to be out of date.
94 * Documentation
95 ** The Org manual
96    - Read the documentation [[file:manual/index.html][online]].  This is a version consisting of many
97      small files, to save bandwidth.  
98    - If you really need it, you can also have the entire manual in a
99      [[file:org.html][single monolithic file]].
100    - Download the documentation as a  [[file:org.pdf][PDF document]].
101    - There is also a [[http://hpcgi1.nifty.com/spen/index.cgi?OrgMode%2fManual][Japanese translation]] of the manual (version 4.60),
102      produced by Takeshi Okano.
103    - The Org manual is a GNU Manual released under the GFDL.  If you
104      want to redistribute Org with a distribution that does not allow
105      the GFDL to be used, and if you see no other way to resolve this
106      licensing conflict, you must use the special [[file:org_dual_license.texi][dual-license version]]
107      of the manual.
108 ** Reference card
109    - Download the [[file:orgcard.pdf][Refcard]] for org-mode
110    - Kyle Sherman has created a [[file:orgcard.txt][text version]] of the reference card
111      (Org version 6.07).
112 ** The FAQ
113    - The [[http://orgmode.org/worg/org-faq.php][Org Mode FAQ]] is user-editable and is maintained by the [[http://orgmode.org/worg/][Worg
114      project]]. 
116 * Links
118 ** Google Tech Talk
119    Check out the [[file:GoogleTech.org][Google Tech Talk]] about Org-mode.
121 ** Mailing list
123    There is a mailing list for discussion about org-mode.
125    - Subscribe to it at [[http://lists.gnu.org/mailman/listinfo/emacs-orgmode][this webpage]].
126    - Directly [[mailto:emacs-orgmode@gnu.org][send mail to it]].  If you are not subscribed, a moderator
127      will look at the message before passing it through to the
128      list.  If that has happened once, future messages from your email
129      address will get through immediately, even if you remain
130      unsubscribed.
131    - Read the list on [[http://www.gmane.org][Gmane]] through a [[http://news.gmane.org/gmane.emacs.orgmode][web interface]] or with a
132      [[news://news.gmane.org/gmane.emacs.orgmode][newsreader]].
134 #+BEGIN_HTML
135 <li><form method="get" action="http://search.gmane.org/">
136 <input type="text" name="query">
137 <input type="hidden" name="group" value="gmane.emacs.orgmode">
138 <input type="submit" value="Search gmane.emacs.orgmode">
139 </form>
140 #+END_HTML
142 ** Worg - user-driven knowledge-base about org-mode
144 [[http://orgmode.org/worg/][Worg]], created by [[http://www.cognition.ens.fr/~guerry/][Bastien Guerry]], is a setup to allow users to jointly
145 edit a number of Org-mode files containing documentation about
146 Org-mode.  This is something like a wiki, but with the advantage that
147 you do not have to be online to modify a file.  If you'd like to
148 contribute your own setup, screenshots, tutorials etc, please go to
149 [[http://orgmode.org/worg/][the Worg page]], and start from there.
151 ** Tutorials
153    [[http://orgmode.org/worg/org-tutorials/index.php][Tutorials and screencasts]] are maintained by the [[http://orgmode.org/worg][Worg project]].
155 ** Survey
157    In November 2007, Charles Cave organized a survey among Org-mode
158    users.  The answers given in this survey can be found [[file:survey.html][here]].
160 ** GTD & Co
162    [[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
163    other task management systems]].
165 ** Contributing to Org-mode
167    You can always contribute with ideas and bug reports on the mailing
168    list.  If you want to contribute a patch, code snippets, or a full
169    add-on, this is very welcome too!  However, I can only make it an
170    official part of Org-mode if you have signed the papers with the
171    Free Software Foundation.  Org-mode is distributed as part of Emacs
172    and must therefore adhere to strict rules about the copyright of
173    all included material.  If this is what you want to do, [[file:request-assign-future.txt][here]] is the
174    form that you have to fill in and send to the FSF.  After you
175    received the final copy with signatures, please scan it and send
176    the scan to the maintainer.
178 ** Future Development
180    Org-mode is still developing fast.  The best way to stay up-to-date
181    is to join the mailing list where the changes are developed and
182    discussed.
184    Here is a loose [[file:todo.org][list of ideas]] that are still to be processed
185    somehow, when I get to it...
187 ** Related Software
189    [[http://www.emacswiki.org/cgi-bin/wiki][The Emacs Wiki]] has extensive lists of related software in the
190    categories
191    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryOutline][Outline]]
192    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryHypermedia][Hypermedia]]
193    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTables][Tables]]
194    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryPersonalInformationManager][Personal Information Manager]]
195    - [[http://www.emacswiki.org/cgi-bin/emacs-en/CategoryCalendar][Calendar]]
196    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTodo][Todo]]
197    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryTimeTracking][Time tracking]]
198    - [[http://www.emacswiki.org/cgi-bin/wiki/CategoryJournaling][Journaling]]