Bug#373816: developers-reference: Please encode in UTF-8
Hi,
On Fri, Jun 16, 2006 at 09:34:22AM +0200, Andreas Barth wrote:
> * W. Borgert (debacle@debian.org) [060616 03:35]:
> > On Thu, Jun 15, 2006 at 07:26:58PM +0200, Jörg Sommer wrote:
> > > can you please encode the developers-reference text file in UTF-8?
>
> > I'm just now converting the developers-reference from DebianDoc
> > into DocBook XML. Of course, I changed it also into UTF-8 :-)
> > Expect my results soon.
>
> Eh, I expect that this will just be a proposal. It might be helpful to
> coordinate such changes a bit before with the main maintainer of the dev
> ref, before putting too much work into it.
It looks like he did it already as proof of concept :) It is very good
shape on 3.3.7 package.
What we need to decide are:
1) Let's address issues which is best addressed now.
2) Where these XML version goes in CVS/SVN for final refinement?
3) Include CVS change from 3.3.7 and reformat source nicely in
78 characters per line or so :)
4) Decide when we should make transition?
For the first point, I would like him to consolidate source files by
each language. I mean:
common.ent
en/*.dbk
fr/*.dbk
ja/*.dbk
(This is not so critical but it will help managing contents later.
Version tracking script is easy with such arrangement.)
Also I found
<?xml version="1.0" encoding="iso-8859-1"?>
in his common.ent source which should be fine but may also be converted
to UTF-8 and will be safer for future updating.
For 2nd question, if he is OK with CVS, how about creating
ddp/manuals.xml . This will make manuals.sgml and manuals.xml are
separated but next to each other. Let's agree on this location first.
For third point, not much issue.
As for the forth point, once he set up CVS/SVN, we can think it. No
rush.
With docbook, you can make tables! Andreas, you should love this.
Good luck.
Osamu
Reply to: