Bug#612997: blends-doc: Please convert SGML to DocBook XML

[Osamu Aoki <osamu@debian.org>]

Hi,

I just woke up.

On Sat, Feb 12, 2011 at 08:57:44AM +0100, Andreas Tille wrote:
> Hi,
> The conversion process turns this into
> 
> <xi:include href="introduction.dbk" xmlns:xi="http://www.w3.org/2003/XInclude"/>
> 
> If I check this via
> 
> $ xmllint --valid --noout index.xml
> index.dbk:76: element include: validity error : No declaration for attribute xmlns:xi of element include
> <xi:include href="introduction.dbk" xmlns:xi="http://www.w3.org/2003/XInclude"/>
>                                                                               ^
> ...
> 
> So I wonder what might be the proper statement to include the parts
> of the document.  Any help is welcome.

I see many web pages.  Some of them have space like:

<xi:include href="introduction.dbk" xmlns:xi="http://www.w3.org/2003/XInclude"; />

I had impresssion these are cosmetic differences but they may have reason
.... ^ mark makes this looks suspicious cause.

http://www.w3.org/TR/xinclude/

In this doc,
Some single tags end with: ..."/>
Some single tags end with: ..." />

http://www.sagehill.net/docbookxsl/ModularDoc.html
http://www.simonecarletti.com/blog/2009/01/using-xinclude-to-include-example-code-in-a-docbook-file/
These use one with space.  I may need to update script.

But
http://norman.walsh.name/2005/04/01/xinclude
This use no space.  Maybe requirement got strictor with time ....

Maybe we need to do DocBook 4 to 5 conversion
http://www.docbook.org/docs/howto/#convert4to5

I have not tried ... I need coffee and I need to go out today.  I am
writing this down so we do not forget what may be reqired.

Later ...

Osamu