Re: sgml source of man pages and translation
On Fri, Apr 19, 2002 at 04:12:48PM +0200, Wichert Akkerman wrote:
> Previously Martin Quinson wrote:
> > Then, you choosed to use the sgml version of DocBook, and not the xml one.
> > That's quite sad in my point of view, since tools exists to manage the
> > translation of xml files easily. Would it be possible to change the headers
> > from:
> > <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
> > to:
> > <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1//EN"
> > "docbook/dtd/xml/4.1/docbookx.dtd">
>
> Provided I can get the same quality output from it, yes. This mostly
> holds for the dpkg reference manual (see doc/reference.sgml). I'm
> currently using a combination of jade, htmldoc and a stylesheet from
> LDP. I still need to commit the right make bits for that though.
Could you please do it ? You asked me to reach the same quality with the xml
based solution, but I can't see the files generated by your solution ;)
Another solution would be that you send me (one of) the generated file(s),
so that i can play with it here.
> > The benefit is that using the poxml package, you can convert the english
> > file to a pot file (separated from the main one, not distributed in the
> > tarballs), then, you translate this file like any other po, and then you can
> > generate the (translated) xml file back. This ease greatly tracking which
> > file is outdated, and which part changed.
>
> That does sound nice indeed.
>
> > It wont add any build or plain depend, since this process only have to take
> > place on translators machines. Only man pages are distributed.
>
> I would want to have the translated po file in CVS and generate the
> manpages when creating a tarball we can ship.
Ok, I'll do that.
> > What is your opinion here ? Is there some bad things I missed about docbook
> > xml, or could you imagine to switch ?
>
> If it works I'm definitely in favour of switching. Right now my main
> goal is converting all the existing documentation to docbook and I
> am familiar enough with the sgml version of docbook to get that
> done properly. If you can provide me with a patch to turn a docbook
> file into proper XML and tell me the magic commands to turn that
> file into goodlooking html, nroff and pdf I'll gladly switch.
Ok, I'll look into it now. Please make sure to send me your generated file ;)
Bye, Mt.
--
To UNSUBSCRIBE, email to debian-dpkg-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: