Re: debiandoc vs. docbook
On Sat, Sep 21, 2002 at 09:05:42AM -0700, Osamu Aoki wrote:
> On Fri, Sep 20, 2002 at 08:27:32AM -0400, Susan Kleinmann wrote:
> > 3. We should (soon) transform the debiandoc files that we now have to
> > docbook-xml using, e.g., the script written by Ardo van Rangelrooij:
> > http://lists.debian.org/debian-doc/2002/debian-doc-200205/msg00183.html
> > In any case, we should agree on a script or process to do the
> > transformation, because without that, in order to ensure some uniformity
> > in the transformation of all the documents to a new DTD.
> Reminder for URL in above postings.
> correct: http://www.teaser.fr/~pbatailler/Debiandoc2docbookxml.tar.gz
> wrong: http://www.teaser.fr/~pbatailler/Debiandoc2docbook-xml.tar.gz
> "debiandoc2docbookxml" normalizes the sgml file (with sgml2xml) but not
> yet the files that are loaded by the internal subset of the dtd. So
> you must do it manually : the main problems are : missing semi-colon
> after an entity reference, % or < ... not escaped, conditional sections
> in the internal subset...
> I think, considering many debiandoc including mine use files that are
> loaded by the internally, I need to know what above problems are and how
> exactly fix them.
After few trials, it seems this script convert debiandoc SGML to XML by
$ ./debiandoc2docbookxml -b -s foo.sgml
(without options, I got practically nothing. Output looked like
But I still do not understand why these options are needed nor is this
right (I do not know XML stylesheet things). Also, I do not have build
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki @ Cupertino CA USA, GPG-key: A8061F32
.''`. Debian Reference: post-installation user's guide for non-developers
: :' : http://www.debian.org/doc/manuals/reference/ also http://qref.sf.net
`. `' "Our Priorities are Our Users and Free Software" --- Social Contract