org Atom Feed

Description
Outline-based notes management and organizer
Latest
org-9.8pre0.20241112.195428.tar (.sig), 2024-Nov-13, 9.78 MiB
Maintainer
Bastien Guerry <bzg@gnu.org>
Website
https://orgmode.org
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

Full description

This is a distribution of Org Mode, a major mode for keeping notes, authoring documents, computational notebooks, literate programming, maintaining to-do lists, planning projects, and more — in a fast and effective plain text system.

Check the Org Mode website for more.

1. Install Org

Org is part of GNU Emacs: you probably don't need to install it.

To install a more recent version, please use command: M-x list-packages, find "org" in the list, click on it, and click "Install" in the popped up window.

2. Join the GNU Project

Org is part of GNU Emacs and GNU Emacs is part of the GNU Operating System, developed by the GNU Project.

If you are the author of an awesome program and want to join us in writing Free (libre) Software, please consider making it an official GNU program and become a GNU Maintainer. Instructions on how to do this are here http://www.gnu.org/help/evaluation.

Don't have a program to contribute? Look at all the other ways to help: https://www.gnu.org/help/help.html.

And to learn more about Free (libre) Software in general, please read and share this page: https://gnu.org/philosophy/free-sw.html

3. License

Org-mode is published under the GNU GPLv3 license or any later version, the same as GNU Emacs.

Org-mode is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Org mode. If not, see https://www.gnu.org/licenses/.

Old versions

org-9.8pre0.20241109.145322.tar.lz2024-Nov-091.66 MiB
org-9.8pre0.20241101.171600.tar.lz2024-Nov-021.66 MiB
org-9.8pre0.20241026.173319.tar.lz2024-Oct-261.66 MiB
org-9.8pre0.20241019.82913.tar.lz2024-Oct-191.66 MiB
org-9.8pre0.20240922.161519.tar.lz2024-Sep-221.64 MiB
org-9.8pre0.20240831.133113.tar.lz2024-Aug-311.64 MiB
org-9.7pre0.20240530.133120.tar.lz2024-May-301.63 MiB
org-9.5.0.20210929.134035.tar.lz2021-Sep-291.44 MiB
org-0.20171225.tar.lz2017-Dec-251.17 MiB
org-0.20121231.tar.lz2012-Dec-311017 KiB

News

ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-

#+STARTUP: overview

#+LINK: doc https://orgmode.org/worg/doc.html#%s
#+LINK: msg https://list.orgmode.org/%s/
#+LINK: git https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=%s

Copyright (C) 2012-2024 Free Software Foundation, Inc.
See the end of the file for license conditions.

Please send Org bug reports to mailto:emacs-orgmode@gnu.org.

* Version 9.8 (not released yet)
** Important announcements and breaking changes

# Here, we list the *most important* changes and changes that _likely_
# require user action for most Org mode users.
# Sorted from most important to least important.

*** =C-c C-x C-v= command toggling inline image display has been reworked

Previously, =C-c C-x C-v= always toggled image display in the whole
buffer (or narrowed part of the buffer).  With prefix argument, it
also forced displaying image links with description.

Now, =C-c C-x C-v= is bound to a new command
~org-toggle-inline-images-command~, which uses different defaults:

1. By default, it toggles image at point or, if there is no image at
   point, images in current entry

2. When region is active, it is honored

3. =C-u= argument changed its meaning.  Now, it forces toggling images
   in the whole buffer

4. =C-u C-u= argument unconditionally hides all the images in buffer

5. Displaying images over links with description can be forced using
   numeric argument:
   - ~C-u 1~ for toggling all images at point/current entry
   - ~C-u 11~ for toggling all images in buffer

The old ~org-toggle-inline-images~ command is still available.  You
can bind it back to =C-c C-x C-v= by adding the following to you config:
#+begin_src emacs-lisp
(eval-after-load 'org-keys
  (org-defkey org-mode-map (kbd "C-c C-x C-v") #'org-toggle-inline-images))
#+end_src

*** Org mode may throw an error when attempting to include remote unsafe resource noninteractively

Previously, when ~org-resource-download-policy~ is ~ask~ (default),
and Emacs is running in batch mode, Org mode simply skipped unsafe
remote resources in the =#+include:='s.  Now, an error is thrown to
avoid seemingly ignored =#+include= statements when publishing via
batch scripts.

*** Diary-style timestamps are exported together with active timestamps

~org-export-with-timestamps~ and ~org-icalendar-with-timestamps~ now
treat diary-style timestamps as a type of active timestamp for
purposes of export.

This mainly affects iCalendar export, where diary timestamps will now
be included when only active timestamps are exported (the default).

This should have minimal impact on non-iCalendar exporters, since
~org-export-with-timestamps~ was already ~t~ by default.  However,
users who manually set ~org-export-with-timestamps~ to ~active~ will
now have diary timestamps included as well.

** New features

# We list the most important features, and the features that may
# require user action to be used.

*** Alignment of image previews can be customized

This is not a new feature.  It has been added in Org 9.7, but not
documented in the news.  See [[#preview-align][restrospectively added news entry]].

*** Beamer export supports setting frame subtitles
If a headline is exported as a frame, and has its =BEAMER_SUBTITLE=
property set, the value is used as the subtitle.

*** =ol.el=: New =shortdoc= link type

You can now create links to =shortdoc= documentation groups for Emacs
Lisp functions (see =M-x shortdoc-display-group=).  Requires Emacs 28
or newer.

*** Some navigation commands can now be repeated

When ~repeat-mode~ is turned on, the following navigation commands can
be repeated:

| Command                           | Key binding            | Repeat key   |
|-----------------------------------+------------------------+--------------|
| ~org-next-visible-heading~        | {{{kbd(C-c C-n)}}}     | {{{kbd(n)}}} |
| ~org-previous-visible-heading~    | {{{kbd(C-c C-p)}}}     | {{{kbd(p)}}} |
| ~org-forward-heading-same-level~  | {{{kbd(C-c C-f)}}}     | {{{kbd(f)}}} |
...
...