[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1053549: marked as done (Create a Debian theme for documentation based in Sphinx (reStructuredText))

Your message dated Sun, 7 Apr 2024 13:00:43 +0200
with message-id <[🔎] 20240407130043.894c57d79acee013d4ddab22@mailbox.org>
and subject line Re: Bug#1053549: Create a Debian theme for documentation based in Sphinx (reStructuredText)
has caused the Debian Bug report #1053549,
regarding Create a Debian theme for documentation based in Sphinx (reStructuredText)
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
1053549: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1053549
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: www.debian.org
Severity: normal
User: debian-www@lists.debian.org
Usertags: design
X-Debbugs-CC: debian-doc@lists.debian.org,design-devel@alioth-lists.debian.net. 

Dear website, documentation and design teams,
Several documentation manuals are being generated now using ReStructuredText and Sphinx, and it would be nice that a Debian theme in Sphinx is created and used to match our docs appearance with the Debian website colours etc. 

Currently in the website we publish, at least:

* Debian Policy: https://www.debian.org/doc/debian-policy/
* Debian Developers Reference: https://www.debian.org/doc/manuals/developers-reference/index.en.html * Testing Release notes: currently in https://www.debian.org/releases/testing/release-notes/ but that may change 

The upstream documentation about theming is here:
 http://www.sphinx-doc.org/en/stable/theming.html
Please take into account that currently the machine www-master where the website is built runs bullseye (sphinx version: 3.4.3-2, but at some time it will be upgraded to bookworm (sphinx version: 5.3.0-4). 

Kind regards
--
Laura Arjona Reina
https://wiki.debian.org/LauraArjona

--- End Message ---
--- Begin Message --- 
Hi,

Laura Arjona Reina <larjona@debian.org> wrote (Fri, 6 Oct 2023 09:35:09 +0200):
> Several documentation manuals are being generated now using 
> ReStructuredText and Sphinx, and it would be nice that a Debian theme in 
> Sphinx is created and used to match our docs appearance with the Debian 
> website colours etc.

Thanks to Stéphane Blondon, we have a nice Debian theme for Sphinx now, and
I managed to get it to the website in the end so far, currently visible at
debian-policy:
https://www.debian.org/doc/debian-policy/index.html

I had to deal with some missing javascript files as well, to make the 
sidebar appear/disappear on small screens like smartphones, but that works
now.

The only thing which is not working currently, is the search functionality,
but since that's not theme-specific I guess (please correct me, if I'm 
wrong), I close this bug.

Javascript leaves some open issues, but for those I will follow-up on some 
existing javascript bugs, we already have for the website/manuals.


Holger


-- 
Holger Wansing <hwansing@mailbox.org>
PGP-Fingerprint: 496A C6E8 1442 4B34 8508  3529 59F1 87CA 156E B076

--- End Message ---
Reply to: