Re: [O] [PATCH] ox-latex.el --- CUSTOM_ID-as-section-label-in-latex-export

2013-06-24 Thread Nicolas Goaziou
Hello,

Eric Schulte schulte.e...@gmail.com writes:

 From c087e84a8fd80b277bf064eb31f1b893c25f1b4a Mon Sep 17 00:00:00 2001
 From: Eric Schulte schulte.e...@gmail.com
 Date: Mon, 24 Jun 2013 10:25:03 -0600
 Subject: [PATCH] CUSTOM_ID as section label in latex export

   When exporting to HTML, custom ids of headlines become references to
   the resulting section in the exported document.  This is both more
   stable and more readable than using section numbers.  This commit adds
   this option to the latex exporter.

Thanks for the patch.

Though, it isn't as stable as relying on section numbers: there is no
guarantee the custom id will be unique nor that it will not contain any
forbidden character.

This patch also breaks cross references, which expects labels to be
built from section number (see `org-latex-link').

Since you (almost?) never need to write \ref{custom-id} in the Org
buffer, I don't think it is bad to keep current label system.

Another option would be to have both \label{sec-...} and
\label{custom-id}. But it would require the user to check validity of
its id.


Regards,

-- 
Nicolas Goaziou



Re: [O] [PATCH] ox-latex.el --- CUSTOM_ID-as-section-label-in-latex-export

2013-06-24 Thread Eric Schulte
Nicolas Goaziou n.goaz...@gmail.com writes:

 Hello,

 Eric Schulte schulte.e...@gmail.com writes:

 From c087e84a8fd80b277bf064eb31f1b893c25f1b4a Mon Sep 17 00:00:00 2001
 From: Eric Schulte schulte.e...@gmail.com
 Date: Mon, 24 Jun 2013 10:25:03 -0600
 Subject: [PATCH] CUSTOM_ID as section label in latex export

   When exporting to HTML, custom ids of headlines become references to
   the resulting section in the exported document.  This is both more
   stable and more readable than using section numbers.  This commit adds
   this option to the latex exporter.

 Thanks for the patch.

 Though, it isn't as stable as relying on section numbers: there is no
 guarantee the custom id will be unique nor that it will not contain any
 forbidden character.

 This patch also breaks cross references, which expects labels to be
 built from section number (see `org-latex-link').


Oh, I see now that I can simply use [[#id]] links and they will be
translated as appropriate.  This will then also resolve these references
if I export the paper to HTML.

Thanks for the explanation,


 Since you (almost?) never need to write \ref{custom-id} in the Org
 buffer, I don't think it is bad to keep current label system.

 Another option would be to have both \label{sec-...} and
 \label{custom-id}. But it would require the user to check validity of
 its id.


 Regards,

-- 
Eric Schulte
http://cs.unm.edu/~eschulte