Bug#931548: Migration to Sphinx

[Osamu Aoki <osamu@debian.org>]

Hi,

On Mon, Jul 22, 2019 at 01:45:50AM +0000, Holger Levsen wrote:
...
> > Maybe, now I think Sphinx expert can take over to get proper packaging.
> 
> yeah, indeed! ;)

Do you know anyone good in this.   Is there any volunteer?  (I am
seeking help on the mailinglist at sphinx-users@googlegroups.com now)

> I think it's ok if the master branch is broken for some time, this
> conversation has been much desired to get developers-reference in an
> editable state again, so here we go.

One thing stopping me to move forward is the difference of i18n HTML
page arrangement:

 * Debian web site https://www.debian.org/doc/manuals/developers-reference/
   It offers the automatic locale adjusted content by using
   index.en.html, index.fr.html, ...
 * Sphinx based web sites such as https://docs.python.org/3/
   It offers the manual pull-down menu and web pages are placed at
   .../en/index.html .../fr/index.html

How should we arrange web page? I want to migrate to Sphinx-style.
But that will break current URL links.  Any opinion?

Please note Debian web pages will be generated from the latest unstable
version binary package.  (Yes, "sed" scripts in cron work if written
correctly but that seems very fragile.)

Regards,

Osamu