Login  Register

Docbook Namespace Issue

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 Namespace Issue

ghillert
Hi,

I am experiencing the following issue with multiple authors in my asciidoctor generated docbook xml file. Once I convert the docbook.xml file with our own Docbook to PDF generator, there is NO space between the first and the last name of each author.

The asciidoctor generated docbook xml file uses the following header:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="en">
  <bookinfo>
...

The issue seems to be the namespace declaration. Our manual docbook files have the following header:

<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="spring-integration-reference"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink">
  <bookinfo>
...

With that header (copied over manually), the author names are appropriately spaced. As I am familiar with Docbook but NOT an expert, I am not even sure whether the issue is on our side our maybe related to the asciidoctor generated header. What is the more appropriate header?

How can I can customize the header and the namespace declaration?

Thank you so much for your insights!

Cheers,

Gunnar
 

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

Re: Docbook Namespace Issue

mojavelinux
Administrator
Gunnar,

This appears to be a DocBook 4.5 vs DocBook 5.0 issue. I'm not surprised that your toolchain is expecting DocBook 5.0 since the industry seems to have upgraded by now. In Asciidoctor, we cloned the DocBook templates from AsciiDoc, which target DocBook 4.5.

The quickest way around this issue is to use a custom template for the document. I'll push a file to the docbook-backends repo that you can snag. Then, you drop it in a folder and run:

asciidoctor -T custom-backends -b docbook master.adoc

You only need the templates you need to override in the custom-backends folder.

Long term, we either want to migrate the DocBook templates to take full advantage of DocBook 5.0 or create a second set of templates. I'm sort of keen on just upgrading since I don't want to maintain yet another set of templates ;)

Mid-term, I could probably get Asciidoctor to recognize -b docbook5 and just override the document template (where the XML header is added).

-Dan


On Thu, Jun 6, 2013 at 3:00 PM, ghillert [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi,

I am experiencing the following issue with multiple authors in my asciidoctor generated docbook xml file. Once I convert the docbook.xml file with our own Docbook to PDF generator, there is NO space between the first and the last name of each author.

The asciidoctor generated docbook xml file uses the following header:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="en">
  <bookinfo>
...

The issue seems to be the namespace declaration. Our manual docbook files have the following header:

<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="spring-integration-reference"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink">
  <bookinfo>
...

With that header (copied over manually), the author names are appropriately spaced. As I am familiar with Docbook but NOT an expert, I am not even sure whether the issue is on our side our maybe related to the asciidoctor generated header. What is the more appropriate header?

How can I can customize the header and the namespace declaration?

Thank you so much for your insights!

Cheers,

Gunnar
 




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Docbook-Namespace-Issue-tp315.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 Namespace Issue

mojavelinux
Administrator
In reply to this post by ghillert


On Thu, Jun 6, 2013 at 5:13 PM, Dan Allen <[hidden email]> wrote:
Gunnar,

This appears to be a DocBook 4.5 vs DocBook 5.0 issue. I'm not surprised that your toolchain is expecting DocBook 5.0 since the industry seems to have upgraded by now. In Asciidoctor, we cloned the DocBook templates from AsciiDoc, which target DocBook 4.5.

The quickest way around this issue is to use a custom template for the document. I'll push a file to the docbook-backends repo that you can snag. Then, you drop it in a folder and run:

asciidoctor -T custom-backends -b docbook master.adoc

You only need the templates you need to override in the custom-backends folder.

Long term, we either want to migrate the DocBook templates to take full advantage of DocBook 5.0 or create a second set of templates. I'm sort of keen on just upgrading since I don't want to maintain yet another set of templates ;)

Mid-term, I could probably get Asciidoctor to recognize -b docbook5 and just override the document template (where the XML header is added).

-Dan


On Thu, Jun 6, 2013 at 3:00 PM, ghillert [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi,

I am experiencing the following issue with multiple authors in my asciidoctor generated docbook xml file. Once I convert the docbook.xml file with our own Docbook to PDF generator, there is NO space between the first and the last name of each author.

The asciidoctor generated docbook xml file uses the following header:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="en">
  <bookinfo>
...

The issue seems to be the namespace declaration. Our manual docbook files have the following header:

<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="spring-integration-reference"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink">
  <bookinfo>
...

With that header (copied over manually), the author names are appropriately spaced. As I am familiar with Docbook but NOT an expert, I am not even sure whether the issue is on our side our maybe related to the asciidoctor generated header. What is the more appropriate header?

How can I can customize the header and the namespace declaration?

Thank you so much for your insights!

Cheers,

Gunnar
 




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Docbook-Namespace-Issue-tp315.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 Namespace Issue

mojavelinux
Administrator
In reply to this post by ghillert
Btw, here's the feature request:


-Dan


On Thu, Jun 6, 2013 at 5:54 PM, Dan Allen <[hidden email]> wrote:


On Thu, Jun 6, 2013 at 5:13 PM, Dan Allen <[hidden email]> wrote:
Gunnar,

This appears to be a DocBook 4.5 vs DocBook 5.0 issue. I'm not surprised that your toolchain is expecting DocBook 5.0 since the industry seems to have upgraded by now. In Asciidoctor, we cloned the DocBook templates from AsciiDoc, which target DocBook 4.5.

The quickest way around this issue is to use a custom template for the document. I'll push a file to the docbook-backends repo that you can snag. Then, you drop it in a folder and run:

asciidoctor -T custom-backends -b docbook master.adoc

You only need the templates you need to override in the custom-backends folder.

Long term, we either want to migrate the DocBook templates to take full advantage of DocBook 5.0 or create a second set of templates. I'm sort of keen on just upgrading since I don't want to maintain yet another set of templates ;)

Mid-term, I could probably get Asciidoctor to recognize -b docbook5 and just override the document template (where the XML header is added).

-Dan


On Thu, Jun 6, 2013 at 3:00 PM, ghillert [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi,

I am experiencing the following issue with multiple authors in my asciidoctor generated docbook xml file. Once I convert the docbook.xml file with our own Docbook to PDF generator, there is NO space between the first and the last name of each author.

The asciidoctor generated docbook xml file uses the following header:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<book lang="en">
  <bookinfo>
...

The issue seems to be the namespace declaration. Our manual docbook files have the following header:

<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="spring-integration-reference"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink">
  <bookinfo>
...

With that header (copied over manually), the author names are appropriately spaced. As I am familiar with Docbook but NOT an expert, I am not even sure whether the issue is on our side our maybe related to the asciidoctor generated header. What is the more appropriate header?

How can I can customize the header and the namespace declaration?

Thank you so much for your insights!

Cheers,

Gunnar
 




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



--



--



--