Login  Register

DocBook 5 olink support

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
4 messages Options Options
Embed post
Permalink
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

DocBook 5 olink support

MJang
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
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

Re: DocBook 5 olink support

mojavelinux
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



--
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

Re: DocBook 5 olink support

MJang
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
Reply | Threaded
Open this post in threaded view
| More
Print post
Permalink

Re: DocBook 5 olink support

mojavelinux
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



--