Docbook Namespace Issue

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

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

--

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

Here you go!

https://github.com/asciidoctor/asciidoctor-backends/blob/master/erb/docbook45/document.xml.erb

-Dan

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

--

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

--

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