Bug#612997: blends-doc: Please convert SGML to DocBook XML
Le Sat, Feb 12, 2011 at 01:21:09PM +0100, Andreas Tille a écrit : > On Sat, Feb 12, 2011 at 05:33:29PM +0900, Osamu Aoki wrote: > > > > Google may be our friend :-) "XInclude xmllint" > > > > http://mail.gnome.org/archives/xml/2003-May/msg00173.html > > Well, tweaking the xmllint options does not change much. I tried to > understand but failed. Is there any working example where some main > page includes some chapters in separate xml files? Any help would > be welcome (even a hint where asking might have reasonable chances > for good answers). Hi Andreas and Osamu, in my hands, adding --xinclude to xmllint does not suppress the warnings and errors, but it definitely allows xmllint to parse the included document, as witnessed by the extra error messages: $ xmllint --xinclude --valid --noout index.dbk 2>&1 | tail ^ DevelDescription.dbk:3: validity error : Validation failed: no DTD found ! Description of development tools ^ QuickIntro.dbk:3: validity error : Validation failed: no DTD found ! Quick intro into building metapackages ^ bts.dbk:3: validity error : Validation failed: no DTD found ! Using the Bug Tracking System ^ xsltproc also has an --xinclude option and manages to convert to HTML the XML file produced by debiandoc2dbk. Here are quick comments that I do not have time to investigate this evening: - http://www.w3.org/2003/XInclude is deprecated in favor of http://www.w3.org/2001/XInclude (just visit the URLs) - debiandoc2dbk should probably add DTDs to the dbk files to include, as it is apparently one of the motivations for using xinclude instead of system entities. Have a nice week-end, -- Charles Plessy Debian Med packaging team, http://www.debian.org/devel/debian-med Tsurumi, Kanagawa, Japan -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
Hi, On Sun, Feb 13, 2011 at 08:55:36AM +0900, Osamu Aoki wrote: > I just woke up. Good morning and thanks for caring for this problem in the early morning. :-) > > 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: > > 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: ..." /> This was what I actually tried before posting my question because this was the only idea I had so far. However, the effect is non et all. The extra space does not change anything. > 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 ... This would be quite welcome. I tried to apply the syntax suggested at http://norman.walsh.name/2005/04/01/xinclude with no success but do not have time now to do some deeper investigation before today evening. Thanks for all your help Andreas. -- http://fam-tille.de -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
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 > > 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 > 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: 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 -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
On Sat, Feb 12, 2011 at 05:33:29PM +0900, Osamu Aoki wrote: > Hi, > > I have not made much of multiple XML. > > Google may be our friend :-) "XInclude xmllint" > > http://mail.gnome.org/archives/xml/2003-May/msg00173.html Well, tweaking the xmllint options does not change much. I tried to understand but failed. Is there any working example where some main page includes some chapters in separate xml files? Any help would be welcome (even a hint where asking might have reasonable chances for good answers). Kind regards Andreas. > On Sat, Feb 12, 2011 at 08:57:44AM +0100, Andreas Tille wrote: > ... > > The conversion process turns this into > > > > > xmlns:xi="http://www.w3.org/2003/XInclude"/> > > > > If I check this via > > > > $ xmllint --valid --noout index.xml > > Why not use "--xinclude" here. > > > index.dbk:76: element include: validity error : No declaration for > > attribute xmlns:xi of element include > > > xmlns:xi="http://www.w3.org/2003/XInclude"/> > V> >^ > > ... > > > > So I wonder what might be the proper statement to include the parts > > of the document. Any help is welcome. > > man xmllint say: > >--xinclude > Do XInclude processing. > > > > -- http://fam-tille.de -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
Hi, I have not made much of multiple XML. Google may be our friend :-) "XInclude xmllint" http://mail.gnome.org/archives/xml/2003-May/msg00173.html On Sat, Feb 12, 2011 at 08:57:44AM +0100, Andreas Tille wrote: ... > The conversion process turns this into > > xmlns:xi="http://www.w3.org/2003/XInclude"/> > > If I check this via > > $ xmllint --valid --noout index.xml Why not use "--xinclude" here. > index.dbk:76: element include: validity error : No declaration for attribute > xmlns:xi of element include > xmlns:xi="http://www.w3.org/2003/XInclude"/> V> ^ > ... > > So I wonder what might be the proper statement to include the parts > of the document. Any help is welcome. man xmllint say: --xinclude Do XInclude processing. -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
Hi, I'm more than willing ro convert the doc to XML and we actually did a try to manually convert it which was stalled because it seemed to require more work than expected - so an automatic tool would be really welcome. However, it seems I would need some help with the migration. The Blends documentation consists of a main document which includes several parts which are included via The conversion process turns this into 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 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. Kind regards Andreas. On Sat, Feb 12, 2011 at 03:06:25PM +0900, Osamu Aoki wrote: > Package: blends-doc > Version: 0.6.15 > Severity: wishlist > User: debian-...@lists.debian.org > Usertags: docbook-xml-transition > > Please consider to convert document to DocBook XML using debiandoc2dbk > command in the upcoming debiandoc-sgml package in wheezy. > > I think working on this later after the release of Debian 6.0.2 or so will be > good idea. No rush. > > === New tools === > > New debiandoc-sgml have debiandoc2dbk command and helper scripts. > Please see the following: > http://wiki.debian.org/DocbookXmlTransition > > I can help the conversion chore. > > Thanks. > > Osamu > > > > -- > To UNSUBSCRIBE, email to debian-blends-requ...@lists.debian.org > with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org > Archive: http://lists.debian.org/20110212060625.ga30...@debian.org > > -- http://fam-tille.de -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Bug#612997: blends-doc: Please convert SGML to DocBook XML
Package: blends-doc Version: 0.6.15 Severity: wishlist User: debian-...@lists.debian.org Usertags: docbook-xml-transition Please consider to convert document to DocBook XML using debiandoc2dbk command in the upcoming debiandoc-sgml package in wheezy. I think working on this later after the release of Debian 6.0.2 or so will be good idea. No rush. === New tools === New debiandoc-sgml have debiandoc2dbk command and helper scripts. Please see the following: http://wiki.debian.org/DocbookXmlTransition I can help the conversion chore. Thanks. Osamu -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org