emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Sebastian Hofer <sebhofer@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: [PATCH] latex export - title placement
Date: Thu, 02 Jun 2011 10:12:07 +0200	[thread overview]
Message-ID: <871uzcmz3c.wl%sebhofer@gmail.com> (raw)
In-Reply-To: <11174.1306965928@alphaville.dokosmarshall.org>

At Wed, 01 Jun 2011 18:05:28 -0400,
Nick Dokos wrote:
> 
> Thomas S. Dye <tsd@tsdye.com> wrote:
> 
> > Sebastian Hofer <sebhofer@gmail.com> writes:
> > 
> > > Hi all,
> > >
> > > This patch addresses the problem of ambiguous conventions for the
> > > placement of the title related macros (\author, \date,...) with
> > > respect to the main document body in different latex classes. It
> > > introduces the following changes:
> > >
> > > * org-exp.el:
> > >     - added the following options:
> > >       - title-position (tpos)
> > >       - with-title (wtitle)
> > >       - with-author (wauth)
> 
> [This is mostly addressed to Sebastian even though I'm replying to Tom's
> reply.]
> 
> An empty
> 
> #+AUTHOR:
> 
> disables the insertion of author (assuming that TITLE is not empty -
> see below.)
> 
> 
> > >       - with-date (wdate)
> 
> An empty
> 
> #+DATE:
> 
> disables the insertion of date (same assumption.)
> 
> > >       - with-maketitle (wmtitle)
> 
> An empty
> 
> #+TITLE:
> 
> disables the insertion of \maketitle.

To be honest, I didn't try setting empty author and date (which of
course makes sense) I just tried not setting them at all, which gives
default values. The main reason I submitted this patch, however, is
having better control of \maketitle. Personally I would like to be
able to have the title and author at the beginning of the file, just
for the looks, and still be able to produce a customized title. Of
course it is highly debatable if this is a sound reason to introduce
new options (I would argue yes).

> So if TITLE is not empty, you can get what you want with existing
> machinery. I could not find a way to make the title empty  and still
> have author and/or date fields.
> 
> Given all this, I think the only things you need is title-position and
> with-title, the latter in the unlikely event that you want a title page
> with author or date but without a title. Personally, I'd consider this
> last one unimportant and not worry about it, but you may disagree.

I agree concerning the author but no title case, this also does not
seem interesting to me.

> > >     
> > > * org-latex.el:
> > >     - implemented handling of new options (see above):
> > >       - title-position controls placement of \title, \author, \date;
> > >         possible values are "b" = before \begin{document},
> > >         any other values default to after \begin{document}
> > >       - with-* controls if the corresponding macro is exported at all
> > >         this can be convenient for more complex titles (e.g. several
> > >         authors including affiliations,...)
> > >
> > > The patch seems to work for me so far. What do you all think? IMO it
> > > would be useful to integrate this, as it gives slightly more control
> > > over the export process. Of course one might want to think about
> > > better option names. The diff is done against commit
> > > bc161ded3693f752616dcd247fc9d638789025ee.
> > >
> > > Let me briefly describe my current use case:
> > > I disable all commands except \title, use babel to created a title.tex
> > > file (including several authors and affiliations) by tangling latex
> > > code and then include the file (into the main body of the document,
> > > not the preamble). That's the only decent way I've found to do this,
> > > if anyone knows an easier way (I have the feeling that I might be
> > > overlooking an obvious solution) please let me know!
> > >
> 
> I'm not sure what problem you are trying to solve here: can you explain?
> It seems to me that all this can be done in standard ways.
> 

I'm using revtex4-1 at the moment. I need a title which looks like
this (within the document environment):

\begin{abstract}
 some blabla
\end{abstract}
\author{First author}
\affiliation{First affiliation}
\affiliation{Second affiliation}
\author{Second author}
\affiliation{Third affiliation}
...
\keywords{optional keywords}
\pacs{optional pacs}
\maketitle

How would you solve this problem?

> > > Cheers
> > > Sebastian
> > >
> > >
> > Aloha Sebastian,
> > 
> > Your patch should prove useful in the situation where one has to use a
> > particular class file that requires \title and friends to be declared in
> > the body of the document rather than the preamble.  That functionality
> > is a welcome addition to the LaTeX exporter, IMO.
> > 
> 
> IIUC, the only remaining thing is the position of the \title etc macros
> in the preamble or the body (or both).
> 
> There are three categories of LaTeX classes: the ones that implement
> Lamport's dictum that \title etc can come anywhere before \maketitle,
> the ones like RevTeX that insist on having them in the body and the ones
> like the thesis document class at Suvayu's university, that insist on
> having them in the preamble. I consider both of the latter two as buggy:
> has anybody submitted a bug report on them?
> 
> Has anybody researched the prevalence of these bugs? Are there lots of
> classes in one or the other of the buggy categories?
> 
> Be that as it may, it seems that org needs a patch to work around these
> bugs.  Personally, since it is a class problem, I'd rather have this
> kind of information in the class template.  You set it once for each
> class that needs it and you forget about it. Assuming the maintainers
> agree, any chance of reworking the patch along these lines? Maybe make
> it extensible as well: a property list that can accumulate all the junk
> in one place perhaps. That way the RevTeX class can be configured
> appropriately and the rest of the world can live in blissful ignorance
> of the problem. You might detect a bias here: I prefer these things in
> the preamble by default.

Last time this topic came up (because of Suvayu Ali's thesis) I posted
something along these lines (http://article.gmane.org/gmane.emacs.orgmode/41129),
wondering what's the best place to fix this problem. I never got any replies
(maybe also because the thread was already a month old by that time).
Back then I concluded that the class templates are not the best place
to handle this, as they are only concerned with the preamble, but not
with the body of the document. And I still don't see how this should
fit in exactly. I agree of course that it would be the nicest thing to
set this on a per class basis.
 
> > Another way to achieve your current use case, IIUC, which might or might
> > not seem easier, is to redefine \maketitle along the lines suggested by
> > Nick Dokos (see
> > http://orgmode.org/worg/org-tutorials/org-latex-export.html#sec-11_2).
> > 
> 
> As I mentioned, I'm not really sure what Sebastian is looking for, so I
> can't really say whether the above would help, but if it can be done
> this way, I think it would be preferable to introducing new user options
> for the exlusive use of the org latex exporter. There are legitimate uses
> for user options but working around bugs in downstream packages is
> not one of them. IMO, of course.
> 
> Nick
> 

Thanks for the detailed response, I'm hopeful that we can finally find
a solution to this problem. I have some other comments to your later
post about revtex, I will reply to this separately.

Sebastian

  parent reply	other threads:[~2011-06-02  8:12 UTC|newest]

Thread overview: 88+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-05-28 12:42 [PATCH] latex export - title placement Sebastian Hofer
2011-05-28 12:59 ` Sebastian Hofer
2011-05-28 17:27 ` Thomas S. Dye
2011-06-01 22:05   ` Nick Dokos
2011-06-01 23:19     ` Thomas S. Dye
2011-06-01 23:55     ` Nick Dokos
2011-06-02  8:36       ` Sebastian Hofer
2011-06-02  8:12     ` Sebastian Hofer [this message]
2011-06-02 15:57       ` Nick Dokos
2011-06-02 19:05         ` Sebastian Hofer
  -- strict thread matches above, loose matches on Subject: below --
2011-06-03  4:23 Nick Dokos
2011-06-03  8:11 ` Sebastian Hofer
2011-12-01 12:51 [bug] Symbol's function definition is void: org-pop-to-buffer-same-window Sebastien Vauban
2011-12-01 14:40 ` Kenny Meyer
2011-12-01 15:00   ` Nick Dokos
2011-12-01 15:05     ` Nick Dokos
2011-12-02 19:46       ` Kenny Meyer
2011-12-02 20:09         ` Nick Dokos
2011-12-02 20:41           ` Sebastien Vauban
2011-12-02 21:32             ` Nick Dokos
2011-12-06 20:24   ` Shelagh Manton
2011-12-06 21:19     ` Nick Dokos
2011-12-07  7:07       ` Shelagh Manton
2011-12-07  8:23         ` Nick Dokos
2011-12-07  8:34           ` Sebastien Vauban
2011-12-07 11:25             ` shelagh Manton
2011-12-07 20:45             ` Sebastien Vauban
2011-12-21 17:10               ` Gustav Wikström
2012-08-09 21:45 [OT] Current website not very attractive Marcelo de Moraes Serpa
2012-08-09 23:14 ` Jude DaShiell
2012-08-10  0:09   ` Sankalp
2012-08-10  4:02     ` Nick Dokos
2012-08-10  5:27       ` Jambunathan K
2012-08-10  6:30       ` Nick Dokos
2012-08-10 16:43         ` Marcelo de Moraes Serpa
2012-08-10 17:46           ` Nick Dokos
2012-08-11  9:29             ` Bastien
2012-08-10 19:56           ` brian powell
2012-08-11  9:30             ` Bastien
2012-09-13 20:19               ` Marcelo de Moraes Serpa
2012-09-13 20:21                 ` Marcelo de Moraes Serpa
2012-09-13 20:23                   ` Marcelo de Moraes Serpa
2012-09-14  5:41                     ` Bastien
2012-09-21 21:19                       ` Marcelo de Moraes Serpa
2012-09-21 22:50                         ` Nick Dokos
2012-09-21 22:59                           ` Eric Schulte
2012-09-21 23:14                             ` Nick Dokos
2012-09-22  4:06                               ` Nick Dokos
2012-09-22  6:51                               ` Bastien
2012-09-22  7:20                                 ` Nick Dokos
2012-09-22  7:44                                   ` Bastien
2012-09-22 14:13                                 ` Achim Gratz
2012-09-22 13:55                           ` John Hendy
2012-08-11 10:46             ` [ANN] Letter modes in the Groff exporter Luis Anaya
2012-08-11 11:03               ` Suvayu Ali
2012-08-11 15:50                 ` Luis Anaya
2012-08-11 17:00                   ` Bastien
2012-08-11  9:27           ` [OT] Current website not very attractive Bastien
2012-08-10  0:57 ` Ista Zahn
2012-08-10  7:05 ` [Contest] Redesign orgmode.org by the end of august (was: [OT] Current website not very attractive) Bastien
2012-08-10 12:40   ` John Hendy
2012-08-10 16:43     ` [Contest] Redesign orgmode.org by the end of august Thomas S. Dye
2012-08-10 18:04       ` Suvayu Ali
2012-08-11  9:33       ` Bastien
2012-08-11 21:45         ` Thomas S. Dye
2012-08-11 22:01           ` Bastien
2012-08-10 16:13   ` Rémi Letot
2012-08-11  9:25     ` Bastien
2012-08-25 20:18   ` Bastien
2012-08-25 21:11     ` Nick Dokos
2012-09-10 11:00   ` Bastien
2012-09-10 11:04     ` Bastien
2012-09-10 14:43       ` Nick Dokos
2012-09-10 12:01     ` Giovanni Ridolfi
2012-09-10 14:41     ` Nick Dokos
2012-09-10 14:45       ` Bastien
2012-09-11  0:23         ` Takaaki ISHIKAWA
2012-09-13  0:25           ` Bastien
2012-09-20 22:42     ` Brian van den Broek
2012-09-21  7:24       ` Bastien
2012-09-21 11:14         ` Brian van den Broek
2013-01-15 10:02 Logging of work no longer working with emcas24 Im Exil
2013-01-15 10:27 ` Nick Dokos
2013-01-15 10:47   ` Im Exil
2013-01-15 11:17   ` Nick Dokos
2013-01-15 13:55     ` Im Exil
2013-01-15 19:10       ` Achim Gratz
2013-01-16  8:20         ` Im Exil

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=871uzcmz3c.wl%sebhofer@gmail.com \
    --to=sebhofer@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).