Asciidoctor :: Discussion

Links to subsections

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

2 messages Options

nicoulaj

Links to subsections

Hi all,

Let's say my document has the following hierarchy:

* Section 1
** Subsection 1
** Subsection 2
* Section 2
** Subsection 1
** Subsection 2

How can I make un unambiguous link to a subsection ?

Something like:

<<Section 2.Subsection 1>>

I could not find this in the manual, except adding an explicit blockId to every subsection...

Regards,
Julien

mojavelinux

Re: Links to subsections

Administrator

Julien,

I don't think this would be a good idea. The title-based xrefs are intended for rapid prototyping. Once beyond that stage, the xref should be updated to use the ID (whether implicit or explicit). When a bunch of titles share the same ID, it's almost a sure sign an explicit ID should be assigned (because you don't want to rely on auto-generated sequences).

Cheers,

-Dan

On Wed, Feb 15, 2017 at 3:14 AM nicoulaj [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi all,

Let's say my document has the following hierarchy:
* Section 1
** Subsection 1
** Subsection 2
* Section 2
** Subsection 1
** Subsection 2
How can I make un unambiguous link to a subsection ?

Something like:
<<Section 2.Subsection 1>>
I could not find this in the manual, except adding an explicit blockId to every subsection...

Regards,
Julien

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Links-to-subsections-tp5279.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | @mojavelinux | https://twitter.com/mojavelinux