This is the official manual for the latest Org-mode release.
Org is part of recent distributions of GNU Emacs, so you normally don't need to install it. If, for one reason or another, you want to install Org on top of this pre-packaged version, there are three ways to do it:
We strongly recommend to stick to a single installation method.
Recent Emacs distributions include a packaging system which lets you install Elisp libraries. You can install Org with M-x package-install RET org.
Important: you need to do this in a session where no
.org file has
been visited, i.e. where no Org built-in function have been loaded.
Otherwise autoload Org functions will mess up the installation.
Then, to make sure your Org configuration is taken into account, initialize
the package system with
(package-initialize) in your .emacs
before setting any Org option. If you want to use Org's package repository,
check out the Org ELPA page.
You can download Org latest release from Org's website. In this case, make sure you set the load-path correctly in your .emacs:
(add-to-list 'load-path "~/path/to/orgdir/lisp")
The downloaded archive contains contributed libraries that are not included in Emacs. If you want to use them, add the contrib directory to your load-path:
(add-to-list 'load-path "~/path/to/orgdir/contrib/lisp" t)
Optionally, you can compile the files and/or install them in your system.
make help to list compilation and installation options.
You can clone Org's repository and install Org like this:
$ cd ~/src/ $ git clone git://orgmode.org/org-mode.git $ make autoloads
Note that in this case,
make autoloads is mandatory: it defines Org's
version in org-version.el and Org's autoloads in
Remember to add the correct load-path as described in the method above.
You can also compile with
make, generate the documentation with
make doc, create a local configuration with
make config and
install Org with
make install. Please run
make help to get
the list of compilation/installation options.
For more detailed explanations on Org's build system, please check the Org Build System page on Worg.