Re: Bug#931548: Migration to Sphinx

HI,

On Sun, Jul 28, 2019 at 06:39:07PM +0100, Sean Whitton wrote:
> Hello,
> 
> On Sat 27 Jul 2019 at 06:31pm +09, Osamu Aoki wrote:
> 
> > Yes.  Eventually ;-)
> >
> > I also see the translation of Policy is building only HTML.
> 
> We can add others upon request.

OK.

> > I think I am going to rewrite build script more symmetrically to make it
> > easy to build all formats for all languages.
> >
> > Just give me some time with developers-reference get this sorted out.
> 
> Okay -- Policy's build is already quite complex so please try to keep
> the patch as small as possible.

Yes I know.  Let me make simple clean multi-language build script while
using -b option with sphinx-build.  -M option is buggy if I try to use
-d or move build directory in subdirectory for developers-reference.

Before going for debian-policy, I still need to get javascripts symlink as
<package>.link.  Then I also need to come up with pull down language
selector.

Also addendum is not supported now.

Once I get them all right, I will copy it into policy in which many
non-sphinx docs are build too.  I don't think current Japanese HTML
build location is the best place.

Osamu