emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Nick Dokos <nicholas.dokos@hp.com>
To: Bastien <bzg@altern.org>
Cc: nicholas.dokos@hp.com, emacs-orgmode@gnu.org,
	Jambunathan K <kjambunathan@gmail.com>
Subject: Re: Re: unnumbered subsections in latex export
Date: Thu, 24 Mar 2011 15:25:02 -0400	[thread overview]
Message-ID: <3553.1300994702@alphaville.usa.hp.com> (raw)
In-Reply-To: Message from Bastien <bzg@altern.org> of "Thu, 24 Mar 2011 08:59:26 BST." <87bp11dk4h.fsf@gnu.org>

Bastien <bzg@altern.org> wrote:

> Here is a list of difficulties:
> 
> 1. the syntax of the backends vary, and this means that all Org options
>    are not meaningful in all target formats;
> 
>    *Example*: #+XSLT is only meaninful for the Docbook export.  The
>    variable `org-export-html-postamble' is only meaningful for the HTML
>    export.  Etc.
> 
> 2. exporters use various methods to export the file (e.g. the HTML
>    exporter goes line by line, the LaTeX exporter parses the file and
>    render each section);
> 
>    *Example*: users often ask why the LaTeX exporter cannot export a
>    headline of level 3 right after a headline of level 1: they ask that
>    because the HTML exporter can do this, while the LaTeX one cannot.
>    And the LaTeX one cannot because parsing an ill-structured Org buffer
>    is tricky for it.
> 
> 3. exporters are maintained by various people: I know the HTML exporter
>    and the LaTeX one, others know the other exporters, etc.
> 
> I need your help do deal with these issues.
> 
> The first thing to do is to have a list of annoying inconsistencies that
> need to be addressed in priority.
> 
> The second thing would be to build a table (somewhere on Worg?) with the
> list of options and the way they are taken care by each exporter.  Such
> a "synoptic view" would help developers know what they can work on, and
> users know what they have to expect from options.  On the long term, it
> would also help make the documentation clearer about all these aspects.
> 
> This will at least help with the first difficulty -- and motivate all
> people working on the exporters to address the second one.  The third
> one can be turned into a *chance*: that of having several people working
> in the same direction.
> 

Excellent plan!

If nobody beats me to it, I'll send out an initial draft of such a table
to the list for comment over the weekend: not a complete thing, mind
you - just something partially covering one or two exporters. We can modify
it as necessary and then proceed to populate it over the next few weeks.

Nick

PS:

> So, bare with me on this :)
> 
I'm sorry to be so sophomoric about this, but the image that popped into
my mind was a bunch of org developers dropping their pants and mooning
the world. Bastien, I will have to undergo years of therapy for this:
I'll send you the bill :-)

> PS: Also note that I couldn't be as available as I wanted the 10 last
> days due to personal problems, but things look better now.
> 

I think I'm speaking for all of us: Nothing here is so urgent that it
cannot wait for a few days or a few weeks or a few months. If something
absolutely *needs* to be done *today* (I can't think of anything that
would be this urgent, but let us say that there is something), and you
cannot get to it, let the list know: we'll either know to wait or
somebody will up and do it.

So you do what you need to do when you need to do it: org can take care
of itself for a while without much supervision. And you are not alone.

  parent reply	other threads:[~2011-03-24 19:25 UTC|newest]

Thread overview: 51+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-03-22 12:10 unnumbered subsections in latex export Suvayu Ali
2011-03-22 12:20 ` Sébastien Vauban
2011-03-22 12:31   ` Suvayu Ali
2011-03-22 12:56     ` Sébastien Vauban
2011-03-22 14:26       ` [PATCH] Allow mixed export of numbered and unnumbered sections in LaTeX Lawrence Mitchell
2011-03-22 22:52         ` Suvayu Ali
2011-03-23 14:04         ` [Accepted] " Bastien Guerry
2011-03-23 14:17         ` [PATCH] " Bastien
2011-03-22 14:35     ` Re: unnumbered subsections in latex export Nick Dokos
2011-03-22 23:08       ` Suvayu Ali
2011-03-22 23:21         ` Nick Dokos
2011-03-23  9:38           ` [PATCH] Allow mixed export of numbered and unnumbered sections in HTML Lawrence Mitchell
2011-03-23 14:05             ` [Accepted] " Bastien Guerry
2011-03-23 14:57               ` Nick Dokos
2011-03-23 15:50                 ` Suvayu Ali
2011-03-23 14:18           ` Re: unnumbered subsections in latex export Bastien
2011-03-23 15:02             ` Nick Dokos
2011-03-23 16:25               ` Lawrence Mitchell
2011-03-23 16:42                 ` Nick Dokos
2011-03-23 18:17                   ` Jambunathan K
2011-03-23 19:00                     ` Nick Dokos
2011-03-23 19:18                       ` Jambunathan K
2011-03-23 16:29               ` Thomas S. Dye
2011-03-23 17:42           ` Jambunathan K
2011-03-24  7:59             ` Bastien
2011-03-24 18:27               ` Achim Gratz
2011-03-24 19:25               ` Nick Dokos [this message]
2011-03-25  1:06                 ` Suvayu Ali
2011-04-04 14:39                 ` Sébastien Vauban
2011-04-04 17:04                   ` Nick Dokos
2011-04-04 20:32                   ` Aankhen
2011-04-05 10:16                     ` Sébastien Vauban
2011-04-05 19:07                       ` Aankhen
2011-04-05 19:27                         ` Eric S Fraga
2011-04-05 21:25                           ` New features for the exporters? Sébastien Vauban
2011-04-05 21:45                           ` Re: unnumbered subsections in latex export Aankhen
2011-04-06 18:49                   ` Matt Lundin
2011-04-06 20:19                     ` Sébastien Vauban
2011-03-27 11:16               ` Jambunathan K
2011-03-27 11:40                 ` Bastien
2011-03-31 21:58               ` Nicolas
2011-04-01  4:34                 ` Jambunathan K
2011-04-01  4:41                   ` Jambunathan K
2011-04-01  6:29                   ` Nick Dokos
2011-04-01 15:41                   ` Eric S Fraga
2011-04-04 14:00                     ` Matt Lundin
2011-04-04 14:12                       ` Jambunathan K
2011-04-04 16:36                         ` Matt Lundin
2011-04-04 17:09                           ` Nick Dokos
2011-04-01  7:39                 ` Jambunathan K
2011-04-01 18:25                 ` Achim Gratz

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=3553.1300994702@alphaville.usa.hp.com \
    --to=nicholas.dokos@hp.com \
    --cc=bzg@altern.org \
    --cc=emacs-orgmode@gnu.org \
    --cc=kjambunathan@gmail.com \
    /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).