Asciidoctor :: Discussion

Relative InterDocument Cross References - one level up

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

3 messages Options

GCoppez

Apr 21, 2015; 10:43am

Relative InterDocument Cross References - one level up

When using relative inter document cross references to other documents with syntax as follows <<document1.adoc#, document1>>, how does one navigate up a folder level? In general, I would think to use <<../document1.adoc#, document1>> but this doesn't seem to work. Any body have any suggestions?

Jeremie Bresson

Apr 22, 2015; 7:19am

Re: Relative InterDocument Cross References - one level up

I tried it with the asciidoctor-chrome-extension and it does not work either for me.

It seems that you cannot refer to a document with a path starting with a dot or with a slash.

However, this workaround is working:

[source,asciidoc]
----
Go to <<dir/../../document1.adoc#, document1>>
----

And it points to the correct document. The folder "dir" does not need to exist.

mojavelinux

Apr 29, 2015; 8:13pm

Re: Relative InterDocument Cross References - one level up

Administrator

Wow, cool workaround Jeremie! Obviously, we want to make it right, but it's nice to know that there's at least a way through for now ;)

This is a known issue that is currently scheduled to be fixed in 1.5.4. See https://github.com/asciidoctor/asciidoctor/issues/844. I noted the workaround in the comments of the issue.

Thanks!

-Dan

On Wed, Apr 22, 2015 at 1:19 AM, Jeremie Bresson [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I tried it with the asciidoctor-chrome-extension and it does not work either for me.

It seems that you cannot refer to a document with a path starting with a dot or with a slash.

However, this workaround is working:

[source,asciidoc]
----
Go to <<dir/../../document1.adoc#, document1>>
----

And it points to the correct document. The folder "dir" does not need to exist.

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Relative-InterDocument-Cross-References-one-level-up-tp3006p3010.html

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

... [show rest of quote]

Dan Allen | http://google.com/profiles/dan.j.allen