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

Bug#175064: DocBook XML conversion is read with this script



On Sat, Jan 14, 2017 at 10:59:45AM -0800, Russ Allbery wrote:
> Guillem Jover <guillem@debian.org> writes:
> 
> > I've prepared a renewal of the conversion. And scripted it so that it
> > can be performed at any point in time regardless of most changes in the
> > sources.
> 
> > This also includes several fixes to the current SGML source to ease the
> > future conversion, I think these are fine to merge now already.
> 
> > There are still some things to polish and review I'm afraid. I think
> > there is a problem with spacing which get mangled on conversion, but I'd
> > need to recheck. The comments are currently lost. The PS and PDF
> > generation might also need some work. I think all IDs are preserved, but
> > this also needs checking.
> 
> > The current state can be tracked in the pu/markup-singularity branch at
> > <https://git.hadrons.org/cgit/debian/policy.git/>, which I might rebase
> > at any point in time.
> 
> Awesome, thank you so much!
> 
> Are any of the sub-policies ready to convert to DocBook right now?  We
> could convert them for the next release and worry about the main Policy
> document, which presumably would be harder, in a later release.

I am concerned that DocBook is much too complex to be used for Debian policy.
We need to people to write patches without trouble and we do not have
many editors available for fixing the XML. Debiandoc-SGML virtue is that
it is simple.

Cheers,
-- 
Bill. <ballombe@debian.org>

Imagine a large red swirl here. 


Reply to: