export subtree

export subtree

[Skip Collins]

The export dispatcher allows me to export only the current subtree.
This is nice, but I would like to avoid having to put point in just
the right place before invoking the dispatcher. I have a document with
lots of things in it. One of the top-level headlines contains the
content of what I want to export. Is there a way to flag this heading
and its contents as the main export document so that wherever my
cursor is, when I export the document it only processes the correct
heading, treating its text as the title of the document?

Re: export subtree

[Andreas Leha]

Hi Skip,

Skip Collins <skip.collins@gmail.com> writes:
> The export dispatcher allows me to export only the current subtree.
> This is nice, but I would like to avoid having to put point in just
> the right place before invoking the dispatcher. I have a document with
> lots of things in it. One of the top-level headlines contains the
> content of what I want to export. Is there a way to flag this heading
> and its contents as the main export document so that wherever my
> cursor is, when I export the document it only processes the correct
> heading, treating its text as the title of the document?

Try to run `org-export-dispatch' with a prefix from the second time
onwards (so, do C-u C-c C-e).

From its docstring:

,----
| When ARG is C-u, repeat the last export action, with the same set
| of options used back then, on the current buffer.
`----

This might do what you want already.

Regards,
Andreas

Re: export subtree

[Skip Collins]

Andreas Leha <andreas.leha@med.uni-goettingen.de> wrote:
>> The export dispatcher allows me to export only the current subtree.
>> This is nice, but I would like to avoid having to put point in just
>> the right place before invoking the dispatcher. I have a document with
>> lots of things in it. One of the top-level headlines contains the
>> content of what I want to export. Is there a way to flag this heading
>> and its contents as the main export document so that wherever my
>> cursor is, when I export the document it only processes the correct
>> heading, treating its text as the title of the document?
>
> Try to run `org-export-dispatch' with a prefix from the second time
> onwards (so, do C-u C-c C-e).

Good try, but it does not do what I want. It selects the subtree
currently at point, just as if I ran the dispatcher again and selected
the same options. It might be a nice enhancement if the dispatcher
remembered which subtree it used last time so that it really could
repeat a subtree export with the same options and from the same
subtree.

Re: export subtree

[Andreas Leha]

Hi Skip,

Skip Collins <skip.collins@gmail.com> writes:
> Andreas Leha <andreas.leha@med.uni-goettingen.de> wrote:
>>> The export dispatcher allows me to export only the current subtree.
>>> This is nice, but I would like to avoid having to put point in just
>>> the right place before invoking the dispatcher. I have a document with
>>> lots of things in it. One of the top-level headlines contains the
>>> content of what I want to export. Is there a way to flag this heading
>>> and its contents as the main export document so that wherever my
>>> cursor is, when I export the document it only processes the correct
>>> heading, treating its text as the title of the document?
>>
>> Try to run `org-export-dispatch' with a prefix from the second time
>> onwards (so, do C-u C-c C-e).
>
> Good try, but it does not do what I want. It selects the subtree
> currently at point, just as if I ran the dispatcher again and selected
> the same options. It might be a nice enhancement if the dispatcher
> remembered which subtree it used last time so that it really could
> repeat a subtree export with the same options and from the same
> subtree.

That is what it does for me.  As I said, you have to do the first export
the normal way.

What is your Org version (M-x org-version)?

Regards,
Andreas

Re: export subtree

[Skip Collins]

Andreas Leha <andreas.leha@med.uni-goettingen.de> wrote:
> Skip Collins <skip.collins@gmail.com> writes:
>>> Try to run `org-export-dispatch' with a prefix from the second time
>>> onwards (so, do C-u C-c C-e).
>>
>> Good try, but it does not do what I want. It selects the subtree
>> currently at point, just as if I ran the dispatcher again and selected
>> the same options. It might be a nice enhancement if the dispatcher
>> remembered which subtree it used last time so that it really could
>> repeat a subtree export with the same options and from the same
>> subtree.
>
> That is what it does for me.  As I said, you have to do the first export
> the normal way.

Okay, it works now. I had confused org by trying to get it to work
from an INCLUDEd file. When that did not work, I had gone back to the
parent file and it did not work there. If I stick within a single
buffer and do not try to export from another buffer, it works as you
describe.
Thanks.

Re: export subtree

[Herbert Sitz]

Not a perfect solution, buy I think you can use the #+SELECT_TAGS option to
set which tress will be exported by default, then tag your desired export
tree with that tag.  Then when you export the full buffer (not just a
subtree) it will choose the tree with that tag.

E.g.,
---------------------------------
#+SELECT_TAGS: myexporttree

* Main tree     :myexporttree:
fkjaldfk
** subhead
** subhead
* anoher heading 1
* another heading level 1
** subhead
** subhead
--------------------------------

In org buffer above it will export only the first subtree now when you
export the entire buffer.  You should be able to export the others
selectively if you choose scope as 'subtree'.  And you can always comment
out or delete the SELECT_TAGS line if you want to export entire buffer.

Re: export subtree

[John Hendy]

On Thu, Dec 10, 2015 at 6:27 PM, Herbert Sitz <hesitz@gmail.com> wrote:
> Not a perfect solution, buy I think you can use the #+SELECT_TAGS option to
> set which tress will be exported by default, then tag your desired export
> tree with that tag.  Then when you export the full buffer (not just a
> subtree) it will choose the tree with that tag.
>

This was going to be my suggestion as well! In the case that a
majority of the document is desired for export, #+EXCLUDE_TAGS is
helpful as well. For reference:
- http://orgmode.org/manual/Export-settings.html

Export tags are fantastic, as one can add as many as desired and then
simply change the #+select_tags/#+exclude_tags target to generate a
bunch of variations from the same single .org file.

Maybe a little extreme and irrelevant to the OP need(s), but I've also
programmatically generated Org heading syntax with R, spit out
headlines with data driven content, inserted a \newpage at the end of
each, and then split them apart with stapler.[1] I was serving as a
financials secretary for a group at work, managing the budgets of many
chapter entities. This allowed me to start with a .csv with the target
spend for the next year, use R to create a document for each chapter,
and then send the chairs their tailored document vs. manually changing
figures and generating ~40 documents by hand. Worked slick! If any of
that sounds appealing/relevant, let me know and I can share an
example.


Best regards,
John

> E.g.,
> ---------------------------------
> #+SELECT_TAGS: myexporttree
>
> * Main tree     :myexporttree:
> fkjaldfk
> ** subhead
> ** subhead
> * anoher heading 1
> * another heading level 1
> ** subhead
> ** subhead
> --------------------------------
>
> In org buffer above it will export only the first subtree now when you
> export the entire buffer.  You should be able to export the others
> selectively if you choose scope as 'subtree'.  And you can always comment
> out or delete the SELECT_TAGS line if you want to export entire buffer.
>
>

Re: export subtree

[Skip Collins]

Herbert Sitz <hesitz@gmail.com> wrote:
> * Main tree     :myexporttree:
> fkjaldfk
> ** subhead
> ** subhead
> * anoher heading 1
> * another heading level 1
> ** subhead
> ** subhead

I did try using the default SELECT_TAG :export: on my main document
subtree. The problem is that the subtree is not "promoted" to the main
level. In your example, the title would not become "Main tree" as it
would if I selected subtree export in the dispatcher.

Re: export subtree

[John Hendy]

On Thu, Dec 10, 2015 at 8:50 PM, Skip Collins <skip.collins@gmail.com> wrote:
> Herbert Sitz <hesitz@gmail.com> wrote:
>> * Main tree     :myexporttree:
>> fkjaldfk
>> ** subhead
>> ** subhead
>> * anoher heading 1
>> * another heading level 1
>> ** subhead
>> ** subhead
>
> I did try using the default SELECT_TAG :export: on my main document
> subtree. The problem is that the subtree is not "promoted" to the main
> level. In your example, the title would not become "Main tree" as it
> would if I selected subtree export in the dispatcher.
>

Ah. Agreed on the behavior. I missed your specific request and agree
this doesn't work.

Thinking about it more, using select_tags as a potential solution to
your export of a subtree without navigating to it, problems could
arise if more than one were tagged. If multiple same-level headlines
were tagged with the select_tag, which one should Org use as the
"master" for the document title/level structure?

It sounds like the C-u option did work for you, correct? If so, glad
you found a solution!


John

Re: export subtree

[Skip Collins]

John Hendy wrote:
> Thinking about it more, using select_tags as a potential solution to
> your export of a subtree without navigating to it, problems could
> arise if more than one were tagged. If multiple same-level headlines
> were tagged with the select_tag, which one should Org use as the
> "master" for the document title/level structure?

Nevertheless, I like the idea of a special tag to designate the top
level export. Call it :master:. The first headline with the tag
:master: would cause export actions to default to that subtree. That
way one would be able to edit deep inside the master subtree or
outside of it and still easily and consistently generate the correct
document. It would also help with exporting from emacs/org in batch
mode without a user to put point at the correct subtree location.

> It sounds like the C-u option did work for you, correct?

Correct. C-u works and I have what I need for now. What I ended up
doing is placing the contents of the export tree into an INCLUDE file.
I duplicate all of the export header options in that file. So my
workflow is simply to edit that document and process it for export
without using the subtree option from the parent. It does break the
convenience of keeping everything together in one file.

Re: export subtree

[John Hendy]

[-- Attachment #1: Type: text/plain, Size: 4205 bytes --]

Hi Scott,
(Also adding in the group, just in case anyone else might want to see
this; no point typing a message twice!)


Took me a little bit to make good on my offer! This was for work, and
while it's probably not *that* sensitive (especially with anonymized
names), I took the time to change all the links away from our intranet
address. Never know who would care about some link between a company
and one of its employees on a mailing list... The rest is fairly
original to illustrate the use case. I was generating financial "cheat
sheets" for the equivalent of college clubs we have at work organized
around various technology interests. There's a chair, they're assigned
a budget, and need to charge expenses to a particular account number.
While all of this information exists in a wiki, our workplace is a bit
"old school" and people wanted some type of hard copy. Not being too
excited to hand generate 40+ of these

I attached a zip of what should be a fairly reproducible example if
you have R functionality enabled. If you go the whole document +
stapler route to split it, you'll need stapler installed and in your
path to run the bash code at the end. There's a link in the document.

I forgot that I'd programatically generated an EXPORT_FILE_NAME
property for each headline as well. That ended up tying back into
Skip's original issue, as I discovered by looking at my generated
documents that I went the manual subtree export route. I preferred the
headlines as the document title vs. just a headline, and couldn't get
there with a bulk export + split. I'd completely forgotten, yet ended
up in the same conundrum :)


Let me know if you run into issues, and hope you find it helpful!
John

P.S. I zipped these from within the directory, so you'll want to
create a folder and unzip them into it.





On Sun, Dec 13, 2015 at 9:25 AM, scot junkin <junkin@gmail.com> wrote:
> This sounds awesome, would enjoy an exampme
>
> On Dec 10, 2015 5:41 PM, "John Hendy" <jw.hendy@gmail.com> wrote:
>>
>> On Thu, Dec 10, 2015 at 6:27 PM, Herbert Sitz <hesitz@gmail.com> wrote:
>> > Not a perfect solution, buy I think you can use the #+SELECT_TAGS option
>> > to
>> > set which tress will be exported by default, then tag your desired
>> > export
>> > tree with that tag.  Then when you export the full buffer (not just a
>> > subtree) it will choose the tree with that tag.
>> >
>>
>> This was going to be my suggestion as well! In the case that a
>> majority of the document is desired for export, #+EXCLUDE_TAGS is
>> helpful as well. For reference:
>> - http://orgmode.org/manual/Export-settings.html
>>
>> Export tags are fantastic, as one can add as many as desired and then
>> simply change the #+select_tags/#+exclude_tags target to generate a
>> bunch of variations from the same single .org file.
>>
>> Maybe a little extreme and irrelevant to the OP need(s), but I've also
>> programmatically generated Org heading syntax with R, spit out
>> headlines with data driven content, inserted a \newpage at the end of
>> each, and then split them apart with stapler.[1] I was serving as a
>> financials secretary for a group at work, managing the budgets of many
>> chapter entities. This allowed me to start with a .csv with the target
>> spend for the next year, use R to create a document for each chapter,
>> and then send the chairs their tailored document vs. manually changing
>> figures and generating ~40 documents by hand. Worked slick! If any of
>> that sounds appealing/relevant, let me know and I can share an
>> example.
>>
>>
>> Best regards,
>> John
>>
>> > E.g.,
>> > ---------------------------------
>> > #+SELECT_TAGS: myexporttree
>> >
>> > * Main tree     :myexporttree:
>> > fkjaldfk
>> > ** subhead
>> > ** subhead
>> > * anoher heading 1
>> > * another heading level 1
>> > ** subhead
>> > ** subhead
>> > --------------------------------
>> >
>> > In org buffer above it will export only the first subtree now when you
>> > export the entire buffer.  You should be able to export the others
>> > selectively if you choose scope as 'subtree'.  And you can always
>> > comment
>> > out or delete the SELECT_TAGS line if you want to export entire buffer.
>> >
>> >
>>
>

[-- Attachment #2: prog-ex.zip --]
[-- Type: application/zip, Size: 295032 bytes --]