Francesco Pizzolante <fpz-djc/ipccudyqhejpep6iedvlejwur...@public.gmane.org> writes:
> Hi, > > I have a few questions about links to sections. > > I've read that it is better to user IDs and CUSTOM_IDs to links to section... > > Here's a small example with 4 cases: > > --8<---------------cut here---------------start------------->8--- > * First > :PROPERTIES: > :CUSTOM_ID: heading-a > :END: > > Hello Toto! > > * Second > # <<heading-b>> > > Hello Tata! > > * Third > #+CUSTOM_ID: heading-c > > Hello Titi! > > * Fourth > #+ID: heading-d > > Hello Tete! > > [[heading-a]] > [[heading-b]] > [[heading-c]] > [[heading-d]] > --8<---------------cut here---------------end--------------->8--- > > Which give the following LaTeX code: > > --8<---------------cut here---------------start------------->8--- > \section{First} > \label{sec-1} > \label{heading-a} > > > Hello Toto! > > \section{Second} > \label{sec-2} > \label{heading-b} > > > Hello Tata! > > \section{Third} > \label{sec-3} > > > Hello Titi! > > \section{Fourth} > \label{sec-4} > > > Hello Tete! > > \hyperref[sec-1]{heading-a} > \hyperref[sec-2]{heading-b} > \hyperref[sec-3]{heading-c} > \hyperref[sec-4]{heading-d} > --8<---------------cut here---------------end--------------->8--- > > The first and second cases both generate labels which are not used in LaTeX. > > The third and fourth cases are very elegant as they use only aliases (which > are dropped from the LaTeX code). > > My questions are: > > - what's the difference between using ID and CUSTOM_ID? > > - the cases "Third" and "Fourth" are the more elegant from my point of view. > Is this the right way of doing? > > - what's the difference between cases "First" and "Second" (I mean between > using PROPERTIES and # <<X>>)? > > - in the documentation (section 4.2), we talk about "CUSTOM_ID property" does > it mean that we should use it as in case 1? I use the CUSTOM_ID property for HTML exports (not LaTeX). The ID property is automatically generated for me when I link to a task and is a unique identifier for that heading across all of my org files. ,---- | * Some Task | :PROPERTIES: | :ID: 1329fa08-3c1d-4b73-b984-bef414b0dd3d | :END: `---- This allows me to have more than one 'Some Task' in my files and each will have a unique ID so that linking to it finds the correct one. CUSTOM_IDs are a way to create links using a user-defined name. I use this for my org-mode document at http://doc.norang.ca/org-mode.html so that I can reference a section by name such as http://doc.norang.ca/org-mode.html#Publishing If I later insert a section before Publishing the link still goes to the correct place. Without the CUSTOM_ID property I get a link like http://doc.norang.ca/org-mode.html#sec-13 which may stop working if the document sections are moved around. I'm not sure what this buys you in LaTeX since I don't think the CUSTOM_ID names are exposed in the links (correct me if I'm wrong). I don't think the #+CUSTOM_ID: name #+ID: name forms are valid. These should be properties. The above names are probably just ignored during the export process. HTH, Bernt _______________________________________________ Emacs-orgmode mailing list Remember: use `Reply All' to send replies to the list. Emacs-orgmode@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-orgmode