Asciidoctor :: Discussion

DocBook 5 olink support

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

4 messages Options

MJang

DocBook 5 olink support

Hi,

Now that asciidoctor includes support for DocBook 5, it seems close to something we can use.

One thing I do not see is support for olink -- links / cross-references between documents that use xml IDs.

The one related entry that I see is from 2009.

Thanks,
Mike

mojavelinux

Re: DocBook 5 olink support

Administrator

Mike,

> Now that asciidoctor includes support for DocBook 5, it seems close to something we can use.

Excellent news!

> One thing I do not see is support for olink

Asciidoctor introduces a syntax to address cross-document references. We could wire this to olink in the DocBook backend. If necessary, we can enhance the feature if necessary to cover all the requirements.

http://asciidoctor.org/docs/user-manual/#inter-document-cross-references

The first thing to look at it is whether the AsciiDoc syntax is capable of capturing all the necessary information. Changing the output of the converter to emit olink is a separate and very trivial task.

Cheers,

-Dan

On Tue, Dec 30, 2014 at 9:11 AM, MJang [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi,

Now that asciidoctor includes support for DocBook 5, it seems close to something we can use.

One thing I do not see is support for olink -- links / cross-references between documents that use xml IDs.

The one related entry that I see is from 2009.

Thanks,
Mike

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/DocBook-5-olink-support-tp2621.html

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

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

MJang

Re: DocBook 5 olink support

Hi Dan,

I've checked your syntax doc on cross-document references, and I can see that it's close. What I'm hoping for is to "drop in" processed adoc -> Docbook XML files into our doc trunk.

One thing we need when setting up an olink is "an xlink:role="http://docbook.org/xlink/role/olink" attribute,", per http://www.docbook.org/tdg5/publishers/5.0/en/html/olink.html

One thing that would help us is something in asciidoc that can translate into xlink:show="new" , which opens the olink'd page in a new tab.

If you like, I'll set these requests up as issues in https://github.com/asciidoctor/asciidoctor/issues

Thanks,
Mike

mojavelinux

Re: DocBook 5 olink support

Administrator

Mike,

We can definitely support this. The converter knows when it is handling an inter-document cross reference, so we can simply add the necessary attribute in this case to ensure it opens in a new tab. Let's graduate this to an issue report and I'll schedule it for 1.5.3.

Cheers,

-Dan

On Mon, Jan 5, 2015 at 10:50 AM, MJang [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hi Dan,

I've checked your syntax doc on cross-document references, and I can see that it's close. What I'm hoping for is to "drop in" processed adoc -> Docbook XML files into our doc trunk.

One thing we need when setting up an olink is "an xlink:role="http://docbook.org/xlink/role/olink" attribute,", per http://www.docbook.org/tdg5/publishers/5.0/en/html/olink.html

One thing that would help us is something in asciidoc that can translate into xlink:show="new" , which opens the olink'd page in a new tab.

If you like, I'll set these requests up as issues in https://github.com/asciidoctor/asciidoctor/issues

Thanks,
Mike

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/DocBook-5-olink-support-tp2621p2645.html

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

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