Re: [O] [PATCH] ox.el: Define subtitle macro

[Nicolas Goaziou]

Hello,

Jens Lechtenboerger <address@hidden> writes:

> On 2017-11-17, Rasmus wrote:
>
>> Jens Lechtenboerger <address@hidden> writes:
>>
>>> the attached patch adds a subtitle macro with documentation.
>>
>> AFAIK it’s already added to the backends where it makes sense.  It’s not a
>> basic keyword like "#+author".  It should be documented under the relevant
>> backends that support it.
>
> Sorry, I don't understand your suggestion.  I'm interested in
> org-reveal [1], which is based on ox-html.el.  In ox-html.el,
> subtitles are used at some hardcoded positions (preamble, postamble,
> template), but I need access to the subtitle elsewhere.
>
> What should I document where?

SUBTITLE keyword may not be supported in every back-end. As
a consequence, supporting a global {{{subtitle}}} macro sounds
presumptuous.

Anyway, it begs for generalisation. The same problem is going to arise
for CREATOR, KEYWORDS, and WHATNOT. Instead of {{{subtitle}}}, we could
implement {{{option(KWD)}}}. Basically,

  {{{option(SUBTITLE)}}}  => (org-element-interpret-data (plist-get info 
:subtitle))

Options with a `split' behaviour would need a special treatment,
however.

WDYT? Do you want to have a stab at it?

Regards,

-- 
Nicolas Goaziou