ndwarshuis
/
org-mode
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* doc/org-manual.org: Improve documentation for #+SELECT_TAGS and #+EXCLUDE_TAGS 

(Export Settings): Clarify how to define multiple tags per-document.  Reword.

Link: https://orgmode.org/list/87y1ftilf3.fsf@mat.ucm.es
This commit is contained in:
Ihor Radchenko 2023-10-23 15:30:42 +03:00
parent 96286321c5
commit f632def07c
No known key found for this signature in database
GPG Key ID: 6470762A7DA11D8B
1 changed files with 27 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
doc/org-manual.org
View File

@ -12053,22 +12053,38 @@ global variables, include:
#+cindex: @samp{SELECT_TAGS}, keyword
#+vindex: org-export-select-tags
The default value is =("export")=. When a tree is tagged with
=export= (~org-export-select-tags~), Org selects that tree and its
subtrees for export. Org excludes trees with =noexport= tags, see
below. When selectively exporting files with =export= tags set, Org
does not export any text that appears before the first headline.
List of tags that will, if present, be selected for export. The
default value is ~org-export-select-tags~ =("export")=. When a tree
is tagged with =export=, Org selects that tree and its subtrees for
export, ignoring all the other sections that do not possess the
=export= tag.
When selectively exporting files with =export= tags set, Org does
not export any text that appears before the first headline.
Note that a file without the =export= tags will export all its
sections.
To select non-default tags for export, customize
~org-export-select-tags~ (globally) or add =#+SELECT_TAGS: tag1
tag2= to the document.
- =EXCLUDE_TAGS= ::
#+cindex: @samp{EXCLUDE_TAGS}, keyword
#+vindex: org-export-exclude-tags
The default value is =("noexport")=. When a tree is tagged with
=noexport= (~org-export-exclude-tags~), Org excludes that tree and
its subtrees from export. Entries tagged with =noexport= are
unconditionally excluded from the export, even if they have an
=export= tag. Even if a subtree is not exported, Org executes any
code blocks contained there.
List of tags that will be excluded from export. The default value is
~org-export-exclude-tags~ =("noexport")=. When a tree is tagged
with =noexport=, Org excludes that tree and its subtrees from
export.
Entries tagged with =noexport= are unconditionally excluded from the
export, even if they have an =export= tag. Even if a subtree is not
exported, Org executes any code blocks contained there.
To select non-default tags for the exclusion, customize
~org-export-exclude-tags~ (globally) or add =#+EXCLUDE_TAGS: tag1
tag2= to the document.
- =TITLE= ::