Links and one page HTML

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

Links and one page HTML

melix
Hi guys,

As some of you are aware, we started writing the new documentation for the Groovy language using Asciidoctor (and the Gradle plugin). We faced several "minor" issues but so far so good, nothing critical yet. However, there's one place were we didn't find any answer: currently, we're generating one file per asciidoc source file plus a big "index.html" file corresponding to the whole documentation bundled in a single file (using include directives). This works quite good but there's a problem with links. For example, one can write this:

link:invokedynamic-support.html

Which would be good to link from one page to another, but when rendering the full page (index.html), we would like it to be replaced with an internal link.

Any idea how we can do this?

Thanks!
Reply | Threaded
Open this post in threaded view
|

Re: Links and one page HTML

LightGuardjp
I think what you're looking for (and what quite a few people are looking for) is https://github.com/asciidoctor/asciidoctor/issues/417


On Mon, Aug 5, 2013 at 6:51 AM, melix [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi guys,

As some of you are aware, we started writing the new documentation for the Groovy language using Asciidoctor (and the Gradle plugin). We faced several "minor" issues but so far so good, nothing critical yet. However, there's one place were we didn't find any answer: currently, we're generating one file per asciidoc source file plus a big "index.html" file corresponding to the whole documentation bundled in a single file (using include directives). This works quite good but there's a problem with links. For example, one can write this:

link:invokedynamic-support.html

Which would be good to link from one page to another, but when rendering the full page (index.html), we would like it to be replaced with an internal link.

Any idea how we can do this?

Thanks!


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Links-and-one-page-HTML-tp429.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: Links and one page HTML

melix
Hi!

I don't think it's exactly the same, mine looks a bit more complicated, since it's about replacing a link to an external (yet asciidoc) file into an internal link as soon as asciidoc "discovers" that the file that contains the link also has included the document (using the include macro).

It doesn't seem to be covered by https://github.com/asciidoctor/asciidoctor/issues/417, is it?
Reply | Threaded
Open this post in threaded view
|

Re: Links and one page HTML

LightGuardjp
In reply to this post by melix
Maybe not 100%, but they certainly seem related. 

Sent from Mailbox for iPhone


On Mon, Aug 5, 2013 at 11:47 AM, Jason Porter <[hidden email]> wrote:

I think what you're looking for (and what quite a few people are looking for) is https://github.com/asciidoctor/asciidoctor/issues/417


On Mon, Aug 5, 2013 at 6:51 AM, melix [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi guys,

As some of you are aware, we started writing the new documentation for the Groovy language using Asciidoctor (and the Gradle plugin). We faced several "minor" issues but so far so good, nothing critical yet. However, there's one place were we didn't find any answer: currently, we're generating one file per asciidoc source file plus a big "index.html" file corresponding to the whole documentation bundled in a single file (using include directives). This works quite good but there's a problem with links. For example, one can write this:

link:invokedynamic-support.html

Which would be good to link from one page to another, but when rendering the full page (index.html), we would like it to be replaced with an internal link.

Any idea how we can do this?

Thanks!


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Links-and-one-page-HTML-tp429.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--

Reply | Threaded
Open this post in threaded view
|

Re: Links and one page HTML

mojavelinux
Administrator
In reply to this post by melix

The goal is to solve the issue in both directions by writing the links using a more portable cross-reference association instead of a hard coded link and the renderer will just do the right thing. I'll be sure to use the Groovy docs as an example scenario.

This improvement promises to be a big step forward for writing portable docs.

-Dan

On Aug 6, 2013 12:44 AM, "melix [via Asciidoctor :: Discussion]" <[hidden email]> wrote:
Hi!

I don't think it's exactly the same, mine looks a bit more complicated, since it's about replacing a link to an external (yet asciidoc) file into an internal link as soon as asciidoc "discovers" that the file that contains the link also has included the document (using the include macro).

It doesn't seem to be covered by https://github.com/asciidoctor/asciidoctor/issues/417, is it?


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Links-and-one-page-HTML-tp429p436.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML