[O] Re: Difference between subtree-restricted export and 'publish enclosing subtree'

[Matt Lundin]

Sean Whitton <address@hidden> writes:

> Dear all,
>
> I noticed the "publish enclosing subtree" command in the export
> dispatcher today and I can't make it work, nor can I see how it differs
> From publishing a subtree (and needless to say I can't seem to find any
> documentation).
>
> This is a section of my .org file:
>
> ,----
> | * STARTED Hume Essay #2: Causation
> | DEADLINE: <2011-04-19 Tue>
> | [2011-03-14 Mon 16:04]
> | [[gnus:nnimap%2BNucifera:address@hidden
> | list]]
> | 
> | *Does Hume think that causal power is all in the mind?*
> | ** TODO Essay
> | :PROPERTIES:
> | :EXPORT_FILE_NAME: hume-essay-causation
> | :EXPORT_AUTHOR: Sean Whitton, Balliol
> | :EXPORT_DATE: April 2011
> | :EXPORT_TITLE: Does Hume think that causal power is all in the mind?
> | :EXPORT_OPTIONS: todo:nil toc:nil skip:t
> | :LaTeX_CLASS: spwessay
> | :END:
> | *** 
> | Blah de blah (check above for how to do footnotes).
> `----
>
> (yup I'm a non-science student using org, so shoot me :P)

Welcome to the club. :)

> When I put my cursor in the properties drawer within the essay text
> and hit C-c C-e 1 d I get my 'essay' exported and processed to
> hume-essay-causation.pdf correctly, but if I instead use C-c C-e SPC
> with point at various different places within the essay, I just get
> the error 'No enclosing node with LaTeX_CLASS or EXPORT_FILE_NAME',
> yet afaics they are there.

Yes, there are a few issues here.

I can replicate this bug when the cursor is above the LATEX_CLASS
property. For instance, if the cursor is located on the :PROPERTIES:
line, C-c C-e SPC results in an error. If it is on the :END: line, it
finds the relevant headline

The problem is that C-c C-e space calls a simple backwards regexp search
for the two properties. But the regexp search looks for export_title
instead of export_file_name (lines 998-1000):

            (if (re-search-backward
                 "^[ \t]+\\(:latex_class:\\|:export_title:\\)[ \t]+\\S-"
                 nil t)

In addition, the regexp search is not bounded, so if you have another
headline higher up in the file with one of the properties in the search,
such as...

--8<---------------cut here---------------start------------->8---
* Kant Essay
   :PROPERTIES:
   :LATEX_CLASS: spwessay
   :END:
** Some text
--8<---------------cut here---------------end--------------->8---

...hitting space will export that essay instead.

> How do I make the SPC command work and how does it differ from a subtree
> export?  

My guess is that the former was introduced to make it more convenient to
export subtrees with the relevant properties. I.e., one can simply press
C-c C-e SPC at the current point, rather than having to mark the tree
manually.

Best,
Matt