Re: Bug#931548: Migration to Sphinx -- developers-reference

Hello

After some tests, I've committed what I think it will publish at least
the English version (in different formats) of the new Sphinx based
developers-reference in the website, plus the formats different than
HTML for the languages:

Commits:
052b5734 by Laura Arjona Reina at 2019-10-04T16:23:20Z
developers-reference now uses nginx. Update the commands to publish. Not
sure how to deal with languages, I guess it still needs work

- - - - -


1 changed file:

- parts/7doc


Changes:

=====================================
parts/7doc
=====================================
@@ -447,13 +447,13 @@ for lang in $langlist ; do
 done

 unpack developers-reference
-mvdocs developers-reference usr/share/doc/developers-reference ADD en
-mvhtml developers-reference usr/share/doc/developers-reference ADD en
+mvdocs developers-reference usr/share/doc/developers-reference/docs NO en
+mvhtml_sphinx developers-reference
usr/share/doc/developers-reference/docs NO en
 langlist=`pkg2lang developers-reference-`
 for lang in $langlist ; do
 	unpack developers-reference-$lang
-	mvdocs developers-reference usr/share/doc/developers-reference-$lang
ADD $lang
-	mvhtml developers-reference usr/share/doc/developers-reference-$lang
ADD $lang
+	mvdocs developers-reference
usr/share/doc/developers-reference/docs/$lang ADD $lang
+	mvhtml_sphinx developers-reference
usr/share/doc/developers-reference/docs/$lang ADD $lang
 done

 unpack debian-faq



View it on GitLab:
https://salsa.debian.org/webmaster-team/cron/commit/052b5734b26b9e33cfc7d33787b7ea1610c815f3

I'm not sure how to deal with the Sphinx based html translations; will
try to have a look later after I'm sure than the English is ok.

About the aspect, ideally somebody would create a sphinx template for
all the Debian documentation (policy, developers reference, and future
ones). #915583  is open about this, but no proposals so far :/

Kind regards,