Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
4 posts
|
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! |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
354 posts
|
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, ... [show rest of quote] |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
4 posts
|
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? |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
354 posts
|
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:
... [show rest of quote] |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
Administrator
2681 posts
|
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! |
Free forum by Nabble | Edit this page |