* the opposite of the noexport tag
@ 2023-10-22 15:23 Uwe Brauer
2023-10-22 16:18 ` Bruno Barbier
0 siblings, 1 reply; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 15:23 UTC (permalink / raw)
To: emacs-orgmode
Hi
I usually have org files with say a dozen or more sections, and if I
wish not to export a specific section I just add the noexport tag.
However, sometimes I am faces with the opposite problem. The documents
contains dozens or more section and I only want to export one or two.
So it would be very handy to configure the exporter for that file
locally that he only exports sections that have a export tag
Is this possible?
Right now, what I do is to demote move all these sections I do not want
to export below one section and add the noexport tag
But this seems to me a kludge and is rather cumbersome.
Regards
Uwe Brauer
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 15:23 the opposite of the noexport tag Uwe Brauer
@ 2023-10-22 16:18 ` Bruno Barbier
2023-10-22 16:33 ` Uwe Brauer
0 siblings, 1 reply; 22+ messages in thread
From: Bruno Barbier @ 2023-10-22 16:18 UTC (permalink / raw)
To: Uwe Brauer, emacs-orgmode
Hi,
Uwe Brauer <oub@mat.ucm.es> writes:
>
> So it would be very handy to configure the exporter for that file
> locally that he only exports sections that have a export tag
>
> Is this possible?
Did you try org-export-select-tags ?
(I didn't but, from its documentation, it might be what you're looking
for).
Bruno.
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 16:18 ` Bruno Barbier
@ 2023-10-22 16:33 ` Uwe Brauer
2023-10-22 16:42 ` Ihor Radchenko
2023-10-22 16:58 ` Bruno Barbier
0 siblings, 2 replies; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 16:33 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1210 bytes --]
>>> "BB" == Bruno Barbier <brubar.cs@gmail.com> writes:
Hi
> Hi,
> Uwe Brauer <oub@mat.ucm.es> writes:
>>
>> So it would be very handy to configure the exporter for that file
>> locally that he only exports sections that have a export tag
>>
>> Is this possible?
> Did you try org-export-select-tags ?
> (I didn't but, from its documentation, it might be what you're looking
> for).
,----
|
| Yes I tried the following
| Some test
| * First section
| * Second :export:
| This
|
|
| # Local Variables:
| # mode: org
| # org-export-select-tags: noexport
| # org-export-exclude-tags: export
| # End:
`----
But when try export I obtained an error.
Uwe
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 16:33 ` Uwe Brauer
@ 2023-10-22 16:42 ` Ihor Radchenko
2023-10-22 17:03 ` Uwe Brauer
2023-10-22 16:58 ` Bruno Barbier
1 sibling, 1 reply; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-22 16:42 UTC (permalink / raw)
To: Uwe Brauer; +Cc: emacs-orgmode
Uwe Brauer <oub@mat.ucm.es> writes:
> | # org-export-select-tags: noexport
> | # org-export-exclude-tags: export
This is not right. The value must be a list.
Alternatively to file-local variables, you can also use SELECT_TAGS
keyword. See 13.2 Export Settings section of the manual.
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 16:33 ` Uwe Brauer
2023-10-22 16:42 ` Ihor Radchenko
@ 2023-10-22 16:58 ` Bruno Barbier
2023-10-22 17:06 ` Uwe Brauer
1 sibling, 1 reply; 22+ messages in thread
From: Bruno Barbier @ 2023-10-22 16:58 UTC (permalink / raw)
To: Uwe Brauer, emacs-orgmode
Uwe Brauer <oub@mat.ucm.es> writes:
>>>> "BB" == Bruno Barbier <brubar.cs@gmail.com> writes:
>
>> Did you try org-export-select-tags ?
>
>> (I didn't but, from its documentation, it might be what you're looking
>> for).
> ,----
> |
> | Yes I tried the following
> | Some test
> | * First section
> | * Second :export:
> | This
> |
> |
> | # Local Variables:
> | # mode: org
> | # org-export-select-tags: noexport
> | # org-export-exclude-tags: export
> | # End:
> `----
>
> But when try export I obtained an error.
I just tested your example. It works for me, exporting to HTML. I'm
using org version 9.7-pre.
What is the error ?
Unrelated, but you don't need the "Local Variables" if you didn't change
them elsewhere, as you are using their default values.
Bruno
>
> Uwe
>
>
>
> --
> Warning: Content may be disturbing to some audiences
> I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
> I strongly condemn Putin's war of aggression against Ukraine.
> I support to deliver weapons to Ukraine's military.
> I support the NATO membership of Ukraine.
> I support the EU membership of Ukraine.
> https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 16:42 ` Ihor Radchenko
@ 2023-10-22 17:03 ` Uwe Brauer
2023-10-22 17:22 ` Ihor Radchenko
0 siblings, 1 reply; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 17:03 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1389 bytes --]
>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>> | # org-export-select-tags: noexport
>> | # org-export-exclude-tags: export
> This is not right. The value must be a list.
Ok that triggered the error then
> Alternatively to file-local variables, you can also use SELECT_TAGS
> keyword. See 13.2 Export Settings section of the manual.
I tried
,----
|
| #+options: SELECT_TAGS: noexport
| #+options: EXCLUDE_TAGS: export
|
| Some test
| * First section
|
| * Second :export:
| This
|
| * third
|
| That
`----
That almost worked when exporting to LaTeX, the resulting file looks
like
,----
| \section{Second\hfill{}\textsc{export}}
| \label{sec:orgfba34a2}
| This
`----
I presumed the tag :export does not get exported, but it does, any
chance to avoid that, as well?
Uwe
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 16:58 ` Bruno Barbier
@ 2023-10-22 17:06 ` Uwe Brauer
2023-10-22 17:19 ` Bruno Barbier
0 siblings, 1 reply; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 17:06 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 1495 bytes --]
> Uwe Brauer <oub@mat.ucm.es> writes:
> I just tested your example. It works for me, exporting to HTML. I'm
> using org version 9.7-pre.
> What is the error ?
Well since I did not set a list, org mode complained about it. Not in
your case? I exported to LaTeX but it should make any difference
> Unrelated, but you don't need the "Local Variables" if you didn't change
> them elsewhere, as you are using their default values.
I tried now
,----
| #+options: SELECT_TAGS: noexport
| #+options: EXCLUDE_TAGS: export
|
| Some test
| * First section
|
| * Second :export:
| This
| * third
|
| That
`----
which is almost what I want besides the fact that the tag itself also
gets exported,
,----
| \section{Second\hfill{}\textsc{export}}
| \label{sec:orgfba34a2}
| This
`----
Do you say you get the same without changing anything? So
your headers without a tag don't get exported, hm that seems odd to me.
Uwe
> Bruno
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 17:06 ` Uwe Brauer
@ 2023-10-22 17:19 ` Bruno Barbier
2023-10-22 19:35 ` Uwe Brauer
0 siblings, 1 reply; 22+ messages in thread
From: Bruno Barbier @ 2023-10-22 17:19 UTC (permalink / raw)
To: Uwe Brauer, emacs-orgmode
Uwe Brauer <oub@mat.ucm.es> writes:
>> Uwe Brauer <oub@mat.ucm.es> writes:
>
>
>> I just tested your example. It works for me, exporting to HTML. I'm
>> using org version 9.7-pre.
>
>> What is the error ?
>
> Well since I did not set a list, org mode complained about it. Not in
> your case? I exported to LaTeX but it should make any difference
My mistake: I didn't reload the file after adding the local
variables: your example didn't work for me either. Sorry.
Just follow what Ihor told you, it's simpler.
About exporting the tags, the following option seem to do the trick:
#+OPTIONS: tags:nil
See (info "(org) Export Settings").
Bruno.
>> Unrelated, but you don't need the "Local Variables" if you didn't change
>> them elsewhere, as you are using their default values.
>
> I tried now
> ,----
> | #+options: SELECT_TAGS: noexport
> | #+options: EXCLUDE_TAGS: export
> |
> | Some test
> | * First section
> |
> | * Second :export:
> | This
> | * third
> |
> | That
> `----
>
>
> which is almost what I want besides the fact that the tag itself also
> gets exported,
>
> ,----
> | \section{Second\hfill{}\textsc{export}}
> | \label{sec:orgfba34a2}
> | This
> `----
>
>
> Do you say you get the same without changing anything? So
> your headers without a tag don't get exported, hm that seems odd to me.
>
>
> Uwe
>
>> Bruno
>
>
>
>
> --
> Warning: Content may be disturbing to some audiences
> I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
> I strongly condemn Putin's war of aggression against Ukraine.
> I support to deliver weapons to Ukraine's military.
> I support the NATO membership of Ukraine.
> I support the EU membership of Ukraine.
> https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 17:03 ` Uwe Brauer
@ 2023-10-22 17:22 ` Ihor Radchenko
2023-10-22 19:38 ` Uwe Brauer
0 siblings, 1 reply; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-22 17:22 UTC (permalink / raw)
To: Uwe Brauer; +Cc: emacs-orgmode
Uwe Brauer <oub@mat.ucm.es> writes:
> I tried
> ,----
> |
> | #+options: SELECT_TAGS: noexport
> | #+options: EXCLUDE_TAGS: export
This is not a correct format. Please, review the manual section I linked
to.
(side note: this is odd to set selected tags to "noexport")
#+SELECT_TAGS: noexport
#+EXCLUDE_TAGS: export
* First section
* Second :export:
This
* third
That
> ...
> That almost worked when exporting to LaTeX, the resulting file looks
> like
>
>
> ,----
> | \section{Second\hfill{}\textsc{export}}
> | \label{sec:orgfba34a2}
> | This
> `----
>
> I presumed the tag :export does not get exported, but it does, any
> chance to avoid that, as well?
Please use the correct formatting.
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 17:19 ` Bruno Barbier
@ 2023-10-22 19:35 ` Uwe Brauer
0 siblings, 0 replies; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 19:35 UTC (permalink / raw)
To: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 843 bytes --]
> Uwe Brauer <oub@mat.ucm.es> writes:
> My mistake: I didn't reload the file after adding the local
> variables: your example didn't work for me either. Sorry.
> Just follow what Ihor told you, it's simpler.
> About exporting the tags, the following option seem to do the trick:
> #+OPTIONS: tags:nil
Ah, thanks, that was the missing piece.
Uwe
> Bruno.
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 17:22 ` Ihor Radchenko
@ 2023-10-22 19:38 ` Uwe Brauer
2023-10-23 8:19 ` Ihor Radchenko
0 siblings, 1 reply; 22+ messages in thread
From: Uwe Brauer @ 2023-10-22 19:38 UTC (permalink / raw)
To: emacs-orgmode
>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>> I tried
>> ,----
>> |
>> | #+options: SELECT_TAGS: noexport
>> | #+options: EXCLUDE_TAGS: export
> This is not a correct format. Please, review the manual section I linked
> to.
So it should be
#+options: SELECT_TAGS: ("noexport")
#+options: EXCLUDE_TAGS: ("export")
Right?
I am wondering why it worked anyhow
> (side note: this is odd to set selected tags to "noexport")
So what to you propose instead, in order to achieve my goal:
«To export only the sections that have the export tag and leave the
ignore the others»
Uwe
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-22 19:38 ` Uwe Brauer
@ 2023-10-23 8:19 ` Ihor Radchenko
2023-10-23 12:16 ` Uwe Brauer
0 siblings, 1 reply; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-23 8:19 UTC (permalink / raw)
To: Uwe Brauer; +Cc: emacs-orgmode
Uwe Brauer <oub@mat.ucm.es> writes:
>> This is not a correct format. Please, review the manual section I linked
>> to.
>
> So it should be
> #+options: SELECT_TAGS: ("noexport")
> #+options: EXCLUDE_TAGS: ("export")
>
> Right?
No.
#+SELECT_TAGS: tag1 tag2 ...
Same for #+EXCLUDE_TAGS.
> I am wondering why it worked anyhow
By default, SELECT_TAGS is set to "export" tag and EXCLUDE_TAGS is set
to "noexport" tag.
>> (side note: this is odd to set selected tags to "noexport")
>
> So what to you propose instead, in order to achieve my goal:
>
> «To export only the sections that have the export tag and leave the
> ignore the others»
#+SELECT_TAGS: export
And then
* This section will be exported :export:
* This - will not
* This - neither :some_other_tag:
And you do not even need #+SELECT_TAGS if you use "export" tag - it is
already set like this by default.
So, it is enough to just put :export: tag as needed:
* This section will be exported :export:
* This - will not
* This - neither :some_other_tag:
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 8:19 ` Ihor Radchenko
@ 2023-10-23 12:16 ` Uwe Brauer
2023-10-23 12:32 ` Ihor Radchenko
0 siblings, 1 reply; 22+ messages in thread
From: Uwe Brauer @ 2023-10-23 12:16 UTC (permalink / raw)
To: Ihor Radchenko; +Cc: Uwe Brauer, emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 2005 bytes --]
>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>>> This is not a correct format. Please, review the manual section I linked
>>> to.
>>
>> So it should be
>> #+options: SELECT_TAGS: ("noexport")
>> #+options: EXCLUDE_TAGS: ("export")
>>
>> Right?
> No.
> #+SELECT_TAGS: tag1 tag2 ...
> Same for #+EXCLUDE_TAGS.
I recommend then to clarify this is in the manual: the expression in the manual is
`("export")'
And at least for me it is not clear that this translate to
#+SELECT_TAGS: export
>> I am wondering why it worked anyhow
> By default, SELECT_TAGS is set to "export" tag and EXCLUDE_TAGS is set
> to "noexport" tag.
>>> (side note: this is odd to set selected tags to "noexport")
>>
>> So what to you propose instead, in order to achieve my goal:
>>
>> «To export only the sections that have the export tag and leave the
>> ignore the others»
> #+SELECT_TAGS: export
> And then
> * This section will be exported :export:
> * This - will not
> * This - neither :some_other_tag:
> And you do not even need #+SELECT_TAGS if you use "export" tag - it is
> already set like this by default.
Ok, thanks! I figured that out now and it is, again, confusing.
- If I don't add any tag
* This section will be exported
* This - will
* This - will :some_other_tag:
- But if I just add *one* export tag to one of the sections the rest is ignored.
Couldn't that be clarified in the manual, please.
Regards
Uwe Brauer
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 12:16 ` Uwe Brauer
@ 2023-10-23 12:32 ` Ihor Radchenko
2023-10-23 12:34 ` Uwe Brauer
2023-10-23 12:59 ` Uwe Brauer
0 siblings, 2 replies; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-23 12:32 UTC (permalink / raw)
To: Uwe Brauer; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 171 bytes --]
Uwe Brauer <oub@mat.ucm.es> writes:
> I recommend then to clarify this is in the manual: the expression in the manual is
> `("export")'
What about the attached patch?
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-org-manual.org-Improve-documentation-for-SELECT_.patch --]
[-- Type: text/x-patch, Size: 2772 bytes --]
From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001
Message-ID: <f94d0c8dfa875983332dfe9432e6ec896c62bf59.1698064304.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Mon, 23 Oct 2023 15:30:42 +0300
Subject: [PATCH] * 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
---
doc/org-manual.org | 31 ++++++++++++++++++++-----------
1 file changed, 20 insertions(+), 11 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index c0e9c8d7e..29845f309 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -12053,22 +12053,31 @@ ** Export Settings
#+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 *only* 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. When selectively exporting files with =export= tags set,
+ Org does not export any text that appears before the first headline.
+
+ 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 o 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= ::
--
2.42.0
[-- Attachment #3: Type: text/plain, Size: 224 bytes --]
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 12:32 ` Ihor Radchenko
@ 2023-10-23 12:34 ` Uwe Brauer
2023-10-23 12:59 ` Uwe Brauer
1 sibling, 0 replies; 22+ messages in thread
From: Uwe Brauer @ 2023-10-23 12:34 UTC (permalink / raw)
To: Ihor Radchenko; +Cc: Uwe Brauer, emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 3735 bytes --]
>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>> I recommend then to clarify this is in the manual: the expression in the manual is
>> `("export")'
> What about the attached patch?
> From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001
> Message-ID: <f94d0c8dfa875983332dfe9432e6ec896c62bf59.1698064304.git.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Mon, 23 Oct 2023 15:30:42 +0300
> Subject: [PATCH] * doc/org-manual.org: Improve documentation for #+SELECT_TAGS
> and #+EXCLUDE_TAGS
> (Export Settings): Clarify how to define multiple tags per-document. Reword.
Thanks, this is better, but please give me some minutes and I will try to add my suggestions.
> Link: https://orgmode.org/list/87y1ftilf3.fsf@mat.ucm.es
> ---
> doc/org-manual.org | 31 ++++++++++++++++++++-----------
> 1 file changed, 20 insertions(+), 11 deletions(-)
> diff --git a/doc/org-manual.org b/doc/org-manual.org
> index c0e9c8d7e..29845f309 100644
> --- a/doc/org-manual.org
> +++ b/doc/org-manual.org
> @@ -12053,22 +12053,31 @@ ** Export Settings
> #+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 *only* 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. When selectively exporting files with =export= tags set,
> + Org does not export any text that appears before the first headline.
> +
> + 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 o 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= ::
> --
> 2.42.0
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 12:32 ` Ihor Radchenko
2023-10-23 12:34 ` Uwe Brauer
@ 2023-10-23 12:59 ` Uwe Brauer
2023-10-23 13:23 ` Loris Bennett
2023-10-24 9:01 ` Ihor Radchenko
1 sibling, 2 replies; 22+ messages in thread
From: Uwe Brauer @ 2023-10-23 12:59 UTC (permalink / raw)
To: Ihor Radchenko; +Cc: Uwe Brauer, emacs-orgmode
[-- Attachment #1.1: Type: text/plain, Size: 798 bytes --]
>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>> I recommend then to clarify this is in the manual: the expression in the manual is
>> `("export")'
> What about the attached patch?
I added some lines, and run rediff and I hoper therefore the modified patch is ok.
Feel free to use it
--
Warning: Content may be disturbing to some audiences
I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
I strongly condemn Putin's war of aggression against Ukraine.
I support to deliver weapons to Ukraine's military.
I support the NATO membership of Ukraine.
I support the EU membership of Ukraine.
https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1.2: 0001-doc-org-manual.org-Improve-documentation-for-SELECT_UB.patch --]
[-- Type: text/x-diff, Size: 3101 bytes --]
From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001
Message-ID: <f94d0c8dfa875983332dfe9432e6ec896c62bf59.1698064304.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Mon, 23 Oct 2023 15:30:42 +0300
Subject: [PATCH] * 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
---
doc/org-manual.org | 31 ++++++++++++++++++++-----------
1 file changed, 20 insertions(+), 11 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index c0e9c8d7e..29845f309 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -12053,23 +12053,37 @@ ** Export Settings
#+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 *only* 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.
+ Please recall, that a file without the =export= or the =noexport=
+ tag will export all its sections.
+ When selectively exporting files with =export= tags set,
+ Org does not export any text that appears before the first headline.
+
+ 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 o tags that will be excluded from export. The default value is
+ ~org-export-exclude-tags~ =("noexport")=.
+ This tag is useful, if the =export= tag is not used on other sections.
+ 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= ::
--
2.42.0
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 12:59 ` Uwe Brauer
@ 2023-10-23 13:23 ` Loris Bennett
2023-10-24 9:01 ` Ihor Radchenko
1 sibling, 0 replies; 22+ messages in thread
From: Loris Bennett @ 2023-10-23 13:23 UTC (permalink / raw)
To: emacs-orgmode
Hi,
Below are some minor comma niggles.
Cheers,
Loris
Uwe Brauer <oub@mat.ucm.es> writes:
>>>> "IR" == Ihor Radchenko <yantar92@posteo.net> writes:
>
>> Uwe Brauer <oub@mat.ucm.es> writes:
>>> I recommend then to clarify this is in the manual: the expression in the manual is
>>> `("export")'
>
>> What about the attached patch?
>
> I added some lines, and run rediff and I hoper therefore the modified patch is ok.
>
>
> Feel free to use it
>
>
> --
> Warning: Content may be disturbing to some audiences
> I strongly condemn Hamas bestialic terroristic attack on Israel, especially the despicable pogroms.
> I strongly condemn Putin's war of aggression against Ukraine.
> I support to deliver weapons to Ukraine's military.
> I support the NATO membership of Ukraine.
> I support the EU membership of Ukraine.
> https://addons.thunderbird.net/en-US/thunderbird/addon/gmail-conversation-view/
>
> From f94d0c8dfa875983332dfe9432e6ec896c62bf59 Mon Sep 17 00:00:00 2001
> Message-ID: <f94d0c8dfa875983332dfe9432e6ec896c62bf59.1698064304.git.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Mon, 23 Oct 2023 15:30:42 +0300
> Subject: [PATCH] * 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
> ---
> doc/org-manual.org | 31 ++++++++++++++++++++-----------
> 1 file changed, 20 insertions(+), 11 deletions(-)
>
> diff --git a/doc/org-manual.org b/doc/org-manual.org
> index c0e9c8d7e..29845f309 100644
> --- a/doc/org-manual.org
> +++ b/doc/org-manual.org
> @@ -12053,23 +12053,37 @@ ** Export Settings
>
> #+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 *only* 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
No comma between 'sections' and 'that'. English does not have a comma
before a restrictive relative pronoun.
> + =export= tag.
> + Please recall, that a file without the =export= or the =noexport=
No comma between 'recall' and 'that'. English does not have comma after
'that' used as a conjunction.
> + tag will export all its sections.
> + When selectively exporting files with =export= tags set,
> + Org does not export any text that appears before the first headline.
> +
> + 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 o tags that will be excluded from export. The default value is
> + ~org-export-exclude-tags~ =("noexport")=.
> + This tag is useful, if the =export= tag is not used on other sections.
No comma between 'useful' and 'if. The comma is usually only placed
between the clauses when the if-clause precedes the main clause.
> + 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= ::
--
This signature is currently under constuction.
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-23 12:59 ` Uwe Brauer
2023-10-23 13:23 ` Loris Bennett
@ 2023-10-24 9:01 ` Ihor Radchenko
2023-10-24 9:40 ` Loris Bennett
2023-10-24 12:22 ` Uwe Brauer
1 sibling, 2 replies; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-24 9:01 UTC (permalink / raw)
To: Uwe Brauer; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 846 bytes --]
Uwe Brauer <oub@mat.ucm.es> writes:
>> Uwe Brauer <oub@mat.ucm.es> writes:
>>> I recommend then to clarify this is in the manual: the expression in the manual is
>>> `("export")'
>
>> What about the attached patch?
>
> I added some lines, and run rediff and I hoper therefore the modified patch is ok.
>
>
> Feel free to use it
> + This tag is useful, if the =export= tag is not used on other sections.
> + When a tree is tagged
> + with =noexport=, Org excludes that tree and its subtrees from
> + export.
I find this part confusing - we first talk about no "export" tags at all
and then immediately about using with "export" tags. I dropped it in the
attached patch. Maybe there is a better way to formulate the same?
In the attached patch, I incorporated your other changes, the grammar
remarks from Loris, and reworded a bit more.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: v2-0001-doc-org-manual.org-Improve-documentation-for-SELE.patch --]
[-- Type: text/x-patch, Size: 2958 bytes --]
From c82ec6139269cfc5dabf0e2e4d3601143843c782 Mon Sep 17 00:00:00 2001
Message-ID: <c82ec6139269cfc5dabf0e2e4d3601143843c782.1698137891.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Mon, 23 Oct 2023 15:30:42 +0300
Subject: [PATCH v2] * 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
---
doc/org-manual.org | 38 +++++++++++++++++++++++++++-----------
1 file changed, 27 insertions(+), 11 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index c0e9c8d7e..7e4553668 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -12053,22 +12053,38 @@ ** Export Settings
#+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 *only* 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= or the =noexport= tag 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 o 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= ::
--
2.42.0
[-- Attachment #3: Type: text/plain, Size: 225 bytes --]
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-24 9:01 ` Ihor Radchenko
@ 2023-10-24 9:40 ` Loris Bennett
2023-10-24 11:06 ` Ihor Radchenko
2023-10-24 12:22 ` Uwe Brauer
1 sibling, 1 reply; 22+ messages in thread
From: Loris Bennett @ 2023-10-24 9:40 UTC (permalink / raw)
To: emacs-orgmode
Ihor Radchenko <yantar92@posteo.net> writes:
> Uwe Brauer <oub@mat.ucm.es> writes:
>
>>> Uwe Brauer <oub@mat.ucm.es> writes:
>>>> I recommend then to clarify this is in the manual: the expression in the manual is
>>>> `("export")'
>>
>>> What about the attached patch?
>>
>> I added some lines, and run rediff and I hoper therefore the modified patch is ok.
>>
>>
>> Feel free to use it
>> + This tag is useful, if the =export= tag is not used on other sections.
>> + When a tree is tagged
>> + with =noexport=, Org excludes that tree and its subtrees from
>> + export.
>
> I find this part confusing - we first talk about no "export" tags at all
> and then immediately about using with "export" tags. I dropped it in the
> attached patch. Maybe there is a better way to formulate the same?
>
> In the attached patch, I incorporated your other changes, the grammar
> remarks from Loris, and reworded a bit more.
>
> From c82ec6139269cfc5dabf0e2e4d3601143843c782 Mon Sep 17 00:00:00 2001
> Message-ID: <c82ec6139269cfc5dabf0e2e4d3601143843c782.1698137891.git.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Mon, 23 Oct 2023 15:30:42 +0300
> Subject: [PATCH v2] * 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
> ---
> doc/org-manual.org | 38 +++++++++++++++++++++++++++-----------
> 1 file changed, 27 insertions(+), 11 deletions(-)
>
> diff --git a/doc/org-manual.org b/doc/org-manual.org
> index c0e9c8d7e..7e4553668 100644
> --- a/doc/org-manual.org
> +++ b/doc/org-manual.org
> @@ -12053,22 +12053,38 @@ ** Export Settings
>
> #+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 *only* be selected for export. The default
I find the emphasised 'only' confusing here, since it implies to me
there the tags might have some other function. I would find, in analogy
to the corresponding text regarding exclude tags, the following text
better:
List of tags that will be included in the export.
I assume that 'only' was meant to imply that the list of tags is
exclusive in the sense that no other tags will be exported. However,
talking about an 'exclusive list' the context of what will be included
in the export is probably not going to be helpful.
Note that the keywords SELECT_TAGS and EXCLUDE_TAGS are not proper
antonyms, which might be a possible source of confusion. I don't know
how feasible it would be to replace (at least in the sense of an alias),
these terms with, say,
EXPORT_INCLUDE_TAGS
EXPORT_EXCLUDE_TAGS
> + 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= or the =noexport= tag 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 o tags that will be excluded from export. The default value is
There is an 'f' missing in
List o tags
(or an apostrophe in Pirate English).
> + ~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= ::
>
> --
> 2.42.0
--
This signature is currently under constuction.
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-24 9:40 ` Loris Bennett
@ 2023-10-24 11:06 ` Ihor Radchenko
2023-10-25 8:27 ` Ihor Radchenko
0 siblings, 1 reply; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-24 11:06 UTC (permalink / raw)
To: Loris Bennett; +Cc: emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 2261 bytes --]
"Loris Bennett" <loris.bennett@fu-berlin.de> writes:
>> + List of tags that will *only* be selected for export. The default
>
> I find the emphasised 'only' confusing here, since it implies to me
> there the tags might have some other function. I would find, in analogy
> to the corresponding text regarding exclude tags, the following text
> better:
>
> List of tags that will be included in the export.
> I assume that 'only' was meant to imply that the list of tags is
> exclusive in the sense that no other tags will be exported. However,
> talking about an 'exclusive list' the context of what will be included
> in the export is probably not going to be helpful.
What about
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.
> Note that the keywords SELECT_TAGS and EXCLUDE_TAGS are not proper
> antonyms, which might be a possible source of confusion. I don't know
> how feasible it would be to replace (at least in the sense of an alias),
> these terms with, say,
>
> EXPORT_INCLUDE_TAGS
> EXPORT_EXCLUDE_TAGS
They are not exactly antonyms, because there is also the default
behavior with neither export nor noexport tags. With "export" tags,
everything but what is tagged "export" is dropped, including subtrees
without "export" tag.
With "noexport" tags, only the subtrees explicitly tagged "noexport" are
dropped. The subtrees with no "noexport"/"export" tags will still be
exported.
As for EXPORT_... prefix, we do not use it, except in heading
properties. It is by convention.
In any case, I do not see a big problem with the current terminology. It
is to late too change it, unless there is a stronger reason.
>> + List o tags that will be excluded from export. The default value is
>
> There is an 'f' missing in
>
> List o tags
Fixed
New version of the patch attached.
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: v3-0001-doc-org-manual.org-Improve-documentation-for-SELE.patch --]
[-- Type: text/x-patch, Size: 2948 bytes --]
From 5c6d1741519e02a3b9d2774faf511b0b90a4c788 Mon Sep 17 00:00:00 2001
Message-ID: <5c6d1741519e02a3b9d2774faf511b0b90a4c788.1698145210.git.yantar92@posteo.net>
From: Ihor Radchenko <yantar92@posteo.net>
Date: Mon, 23 Oct 2023 15:30:42 +0300
Subject: [PATCH v3] * 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
---
doc/org-manual.org | 38 +++++++++++++++++++++++++++-----------
1 file changed, 27 insertions(+), 11 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index c0e9c8d7e..85568e7ab 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -12053,22 +12053,38 @@ ** Export Settings
#+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= ::
--
2.42.0
[-- Attachment #3: Type: text/plain, Size: 225 bytes --]
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply related [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-24 9:01 ` Ihor Radchenko
2023-10-24 9:40 ` Loris Bennett
@ 2023-10-24 12:22 ` Uwe Brauer
1 sibling, 0 replies; 22+ messages in thread
From: Uwe Brauer @ 2023-10-24 12:22 UTC (permalink / raw)
To: Ihor Radchenko; +Cc: Uwe Brauer, emacs-orgmode
[-- Attachment #1: Type: text/plain, Size: 564 bytes --]
> Uwe Brauer <oub@mat.ucm.es> writes:
> I find this part confusing - we first talk about no "export" tags at all
> and then immediately about using with "export" tags. I dropped it in the
> attached patch. Maybe there is a better way to formulate the same?
> In the attached patch, I incorporated your other changes, the grammar
> remarks from Loris, and reworded a bit more.
That looks good to me thanks. I appreciate the sentence
,----
| + Note that a file without the =export= or the =noexport= tag will
| + export all its sections.
`----
[-- Attachment #2: smime.p7s --]
[-- Type: application/pkcs7-signature, Size: 5673 bytes --]
^ permalink raw reply [flat|nested] 22+ messages in thread
* Re: the opposite of the noexport tag
2023-10-24 11:06 ` Ihor Radchenko
@ 2023-10-25 8:27 ` Ihor Radchenko
0 siblings, 0 replies; 22+ messages in thread
From: Ihor Radchenko @ 2023-10-25 8:27 UTC (permalink / raw)
To: Loris Bennett; +Cc: emacs-orgmode
Ihor Radchenko <yantar92@posteo.net> writes:
> New version of the patch attached.
>
> From 5c6d1741519e02a3b9d2774faf511b0b90a4c788 Mon Sep 17 00:00:00 2001
> Message-ID: <5c6d1741519e02a3b9d2774faf511b0b90a4c788.1698145210.git.yantar92@posteo.net>
> From: Ihor Radchenko <yantar92@posteo.net>
> Date: Mon, 23 Oct 2023 15:30:42 +0300
> Subject: [PATCH v3] * doc/org-manual.org: Improve documentation for
> #+SELECT_TAGS and #+EXCLUDE_TAGS
Applied, onto main.
https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=f632def07
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>
^ permalink raw reply [flat|nested] 22+ messages in thread
end of thread, other threads:[~2023-10-25 8:27 UTC | newest]
Thread overview: 22+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2023-10-22 15:23 the opposite of the noexport tag Uwe Brauer
2023-10-22 16:18 ` Bruno Barbier
2023-10-22 16:33 ` Uwe Brauer
2023-10-22 16:42 ` Ihor Radchenko
2023-10-22 17:03 ` Uwe Brauer
2023-10-22 17:22 ` Ihor Radchenko
2023-10-22 19:38 ` Uwe Brauer
2023-10-23 8:19 ` Ihor Radchenko
2023-10-23 12:16 ` Uwe Brauer
2023-10-23 12:32 ` Ihor Radchenko
2023-10-23 12:34 ` Uwe Brauer
2023-10-23 12:59 ` Uwe Brauer
2023-10-23 13:23 ` Loris Bennett
2023-10-24 9:01 ` Ihor Radchenko
2023-10-24 9:40 ` Loris Bennett
2023-10-24 11:06 ` Ihor Radchenko
2023-10-25 8:27 ` Ihor Radchenko
2023-10-24 12:22 ` Uwe Brauer
2023-10-22 16:58 ` Bruno Barbier
2023-10-22 17:06 ` Uwe Brauer
2023-10-22 17:19 ` Bruno Barbier
2023-10-22 19:35 ` Uwe Brauer
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).