[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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 !
  <appendix id="DevelDescription"><title>Description of development tools</title>
  QuickIntro.dbk:3: validity error : Validation failed: no DTD found !
  <appendix id="QuickIntro"><title>Quick intro into building metapackages</title>
  bts.dbk:3: validity error : Validation failed: no DTD found !
  <appendix id="bts"><title>Using the Bug Tracking System</title>

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

Have a nice week-end,

Charles Plessy
Debian Med packaging team,
Tsurumi, Kanagawa, Japan

Reply to: