From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: [ox, patch] Add #+SUBTITLE Date: Sun, 22 Mar 2015 15:02:09 +0100 Message-ID: <87vbht2kri.fsf@nicolasgoaziou.fr> References: <87a8z7z20k.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34812) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YZgR7-0003np-F3 for emacs-orgmode@gnu.org; Sun, 22 Mar 2015 10:01:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YZgQy-0003BV-Cp for emacs-orgmode@gnu.org; Sun, 22 Mar 2015 10:01:05 -0400 Received: from relay6-d.mail.gandi.net ([2001:4b98:c:538::198]:49349) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YZgQy-0003BL-79 for emacs-orgmode@gnu.org; Sun, 22 Mar 2015 10:00:56 -0400 In-Reply-To: <87a8z7z20k.fsf@gmx.us> (rasmus@gmx.us's message of "Sat, 21 Mar 2015 00:23:55 +0100") List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Rasmus Cc: emacs-orgmode@gnu.org Hello, Rasmus writes: > This patch adds #+SUBTITLE to a couple of backends. This property is > already supported in ox-texinfo and e.g. beamer.cls has a subtitles macro, > but ox-beamer.el has no #+SUBTITLE. I have used subtitles in > e.g. applications for research funds. > > The value-added is twofold: > > - It adds a consistent way to have subtitle across backends. I'm > explicitly assuming this is nice, but perhaps this is false. > - Currently, it is, I believe, impossible to hack-up a subtitle in at > least ox-odt.el. > > It's not documented yet as I want make sure that it's not an undesirable > feature before progressing further. > > WDTY? Adding #+SUBTITLE to Beamer is a fine idea, since there's already a dedicated macro for it. Thank you for taking care of it. However, I think porting this feature to back-ends that do not support it out of the box is pushing too hard. Back-ends developers should try hard to support features defined in "ox.el" (in particular in `org-export-options-alist'). However, all back-ends are free to implement their specific keywords without adding burden on other libraries. "ox-texinfo" supports #+SUBAUTHOR, should we add it everywhere? I don't think so. This is why I suggested to move KEYWORD and DESCRIPTION outside of "ox.el", as they cannot be ported to all back-ends without relying on dubious markup. Now, if SUBTITLE is a feature desperately needed everywhere, which can be discussed, it should be moved to "ox.el" and probably `org-element-document-keywords'. IMO, this is not necessary. SUBTITLE should be kept for back-ends that can handle it. As a side note, "ox-texinfo" doesn't parse SUBTITLE. You might want to change it and update manual accordingly. Regards, -- Nicolas Goaziou