|The Org Mode 7 Reference Manual
by Carsten Dominik and others
Paperback (6"x9"), 282 pages
RRP £9.95 ($14.95)
Sales of this book support the Org project! Get a printed copy>>>
9.6.2 Internal archiving
If you want to just switch off (for agenda views) certain subtrees without
moving them to a different file, you can use the
A headline that is marked with the ARCHIVE tag (see section 6 Tags) stays at its location in the outline tree, but behaves in the following way:
It does not open when you attempt to do so with a visibility cycling
command (see section 2.3 Visibility cycling). You can force cycling archived
subtrees with C-TAB, or by setting the option
org-cycle-open-archived-trees. Also normal outline commands like
show-allwill open archived subtrees.
During sparse tree construction (see section 2.6 Sparse trees), matches in
archived subtrees are not exposed, unless you configure the option
During agenda view construction (see section 10 Agenda views), the content of
archived trees is ignored unless you configure the option
org-agenda-skip-archived-trees, in which case these trees will always be included. In the agenda you can press v a to get archives temporarily included.
Archived trees are not exported (see section 12 Exporting), only the headline
is. Configure the details using the variable
Archived trees are excluded from column view unless the variable
org-columns-skip-archived-treesis configured to
The following commands help manage the ARCHIVE tag:
- C-c C-x a
- Toggle the ARCHIVE tag for the current headline. When the tag is set, the headline changes to a shadowed face, and the subtree below it is hidden.
- C-u C-c C-x a
- Check if any direct children of the current headline should be archived. To do this, each subtree is checked for open TODO entries. If none are found, the command offers to set the ARCHIVE tag for the child. If the cursor is not on a headline when this command is invoked, the level 1 trees will be checked.
- Cycle a tree even if it is tagged with ARCHIVE.
- C-c C-x A
- Move the current entry to the Archive Sibling. This is a sibling of the entry with the heading ‘Archive’ and the tag ‘ARCHIVE’. The entry becomes a child of that sibling and in this way retains a lot of its original context, including inherited tags and approximate position in the outline.
|ISBN 9781906966089||The Org Mode 7 Reference Manual||See the print edition|