Re: Proposal: move forward to Sphinx
Hi,
On Sun, 02 Jul 2017 14:31:37 -0700
Russ Allbery <rra@debian.org> wrote:
> The approach that Guillem took with the DocBook conversion is to tune a
> script that did all the conversions until it could handle all of the
> documents, and then we were able to do that conversion all at once in one
> release. That's ideal, but certainly understood if you want to merge some
> partial results first.
Almost done (and probably will finish in this weekend).
I'll show you PoC later.
During conversion, some notes:
- Some tables should be fixed hy hand.
(e.g. license list in copyright-format-1.0)
- footnote should be placed manually.
- Should we split each chapter on small document?
menu-policy has just 2 chapters... and debconf-specification and
perl-policy are not so huge, it's better to put it into one html
file, IMHO.
> >> 3. Historically, text-like formats have struggled with multiply-nested
> >> lists with multi-paragraph blocks and embedded literal blocks. The
> >> output from Sphinx looks surprisingly good, so maybe its version of
> >> reStructured Text does address all of this. But we'd want to verify
> >> that we can get reasonable results from fairly complex structure.
> >> (There seems to be something weird going on with fonts in definition
> >> lists in your sample output, for instance.)
(snip)
> I was looking at:
>
> http://www.ma-aya.to/~henrich/debian/policy/ch-maintainerscripts.html#summary-of-ways-maintainer-scripts-are-called
Okay, I understand it. It's annoying. Hmm...
--
Regards,
Hideki Yamane henrich @ debian.or.jp/org
http://wiki.debian.org/HidekiYamane
Reply to: