* 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

View File

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