Re: Bug#931548: Migration to Sphinx -- developers-reference
- To: 931548@bugs.debian.org
- Cc: Sean Whitton <spwhitton@spwhitton.name>, Osamu Aoki <osamu@debian.org>, Holger Levsen <holger@layer-acht.org>, debian-www@lists.debian.org
- Subject: Re: Bug#931548: Migration to Sphinx -- developers-reference
- From: Laura Arjona Reina <larjona@debian.org>
- Date: Fri, 4 Oct 2019 18:32:59 +0200
- Message-id: <[🔎] 51ca9a41-a275-d9df-acbc-613c6fd3dc06@debian.org>
- In-reply-to: <875zmyqm8d.fsf@zephyr.silentflame.com>
- References: <20190707135223.GA7117@goofy.osamu.debian.net> <20190722014549.uzpbobrrjox6c7f7@layer-acht.org> <20190722142441.GA4599@goofy.osamu.debian.net> <20190722212207.mmpmwymgizdgrkd5@layer-acht.org> <87ef2g9429.fsf@athena.silentflame.com> <20190724204019.i6rvmv7bl5ugwf3a@layer-acht.org> <20190725132224.GB12531@goofy.osamu.debian.net> <20190726201928.xt7xwvsowyj3lbki@layer-acht.org> <20190806143625.GA16874@goofy.osamu.debian.net> <875zmyqm8d.fsf@zephyr.silentflame.com>
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,
--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona
Reply to: