From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Frontmatter / Text before first headline Date: Wed, 01 Feb 2012 14:43:04 +0100 Message-ID: <874nvasm8n.fsf@gmail.com> References: <81lion57bd.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([140.186.70.92]:33334) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RsaV6-0005AB-6B for emacs-orgmode@gnu.org; Wed, 01 Feb 2012 08:45:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RsaUv-0000aZ-Et for emacs-orgmode@gnu.org; Wed, 01 Feb 2012 08:45:26 -0500 Received: from mail-ww0-f49.google.com ([74.125.82.49]:56716) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RsaUv-0000ZM-8P for emacs-orgmode@gnu.org; Wed, 01 Feb 2012 08:45:17 -0500 Received: by wgbdt13 with SMTP id dt13so1009531wgb.30 for ; Wed, 01 Feb 2012 05:45:11 -0800 (PST) In-Reply-To: <81lion57bd.fsf@gmail.com> (Jambunathan K.'s message of "Wed, 01 Feb 2012 13:11:42 +0530") 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: Jambunathan K Cc: Orgmode Hello, Jambunathan K writes: > I have trouble understanding what the real purpose of the "text before > the first headline" is. It looks to me more like a placeholder for > capturing the "Frontmatter" [1]. If you're talking about the first section in the parse tree, the e-ascii back-end makes use of it: even if that part of the document, links may have to be collected and displayed before the first headline. Also, "Frontmatter" probably only makes sense for large documents. I sometimes write documents that doesn't even have an headline. Should they be considered as one big frontmatter? Where would be the matter, then? > I have also trouble understanding what the rightful position for it is: > > Should it be like: > (a) Title, Initial Text, TOC, Chapters > Or like > (b) Title, TOC, Initial Text, Chapters > > Currently org-latex does a (b). > > But if I look at an organization of a typical document, I am inclined to > think that it should be (a). It is also my contention that Table Of > Contents is relocatable only as a means to achieve (b). Honestly, (b) is easier to achieve than (a), since TOC can be stuffed in preamble (that is before reading the parse tree). Also, as it's configurable, I don't think we should bother too much here. > I am wondering if you would be interested in formalizing frontmatter in > Org documents. Backends will then be obligated to render the front > matter headings as "centered text". What about using special blocks? --8<---------------cut here---------------start------------->8--- #+begin_abstract This is the document abstract. #+end_abstract --8<---------------cut here---------------end--------------->8--- You can even use a drawer and define its export behaviour in `org-export-format-drawer-function' (current exporter) or an equivalent. Anyway, if it happens that tools to build complex documents are missing[1], I agree that we should provide them, as long as they aren't imposed to the user. Regards, [1] But, first, let's make sure that it's impossible, or at least very difficult, with current ones. -- Nicolas Goaziou