Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-06-10 Thread Holger Wansing
Holger Wansing wrote: > Hi, you may have noticed that we have an 'official' Debian-style html > theme for Sphinx-based manuals on the Debian website now. It can > be seen at debian-policy under https://www.debian.org/doc/debian-policy/ > It was created by Stéphane Blondon, based on a theme

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-20 Thread James Addison
Ok, that's reasonable. Re: content-negotation: the www FAQ[1] makes me think that, at least currently, it's not worth attempting anything more advanced than language negotiation. Re: file suffixes: after re-reading the Sphinx code and experimenting with a few builds: I'm convinced that the

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-20 Thread Holger Wansing
I tend to ignore the language-related issues with the search for now. Currently we have no document-wide search functionality at all on the Sphinx- based documents on our website. So it's clearly an improvement, if it works for English at least. Holger

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-18 Thread James Addison
On Wed, 17 Apr 2024 at 21:46, Holger Wansing wrote: > James Addison wrote (Sun, 14 Apr 2024 23:52:03 +0100): > > The _other_ hyperlinks in the static content are replaced as part of the > > cronjob[1] - but that doesn't work for items in the searchindex.js file. > > > > Fortunately I think there

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-18 Thread James Addison
On Wed, 17 Apr 2024 at 19:36, Holger Wansing wrote: > Am 16. April 2024 23:47:05 MESZ schrieb James Addison : > >> I have tried to deal with this by some adaptions in the cronjob - see the > >> first two additions in my patch: change all links to search.html into > >> search.§lang.html, and

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-17 Thread Holger Wansing
Hi, James Addison wrote (Sun, 14 Apr 2024 23:52:03 +0100): > The _other_ hyperlinks in the static content are replaced as part of the > cronjob[1] - but that doesn't work for items in the searchindex.js file. > > Fortunately I think there might be a better way to do this. Sphinx itself has >

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-17 Thread Holger Wansing
Hi, Am 16. April 2024 23:47:05 MESZ schrieb James Addison : >> I have tried to deal with this by some adaptions in the cronjob - see the >> first two additions in my patch: change all links to search.html into >> search.§lang.html, and rename the language-specific searchindex files into >>

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-16 Thread James Addison
On Tue, 16 Apr 2024 at 22:47, James Addison wrote:> > Thanks Holger, > > On Mon, 15 Apr 2024 at 20:43, Holger Wansing wrote: > > > > Hi, > > > > James Addison wrote (Sun, 14 Apr 2024 23:52:03 +0100): > > > From some testing of these: the search results have a problem that they > > > hyperlink

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-16 Thread James Addison
Thanks Holger, On Mon, 15 Apr 2024 at 20:43, Holger Wansing wrote: > > Hi, > > James Addison wrote (Sun, 14 Apr 2024 23:52:03 +0100): > > From some testing of these: the search results have a problem that they > > hyperlink to a language-less .html URL, meaning that clicking a result link > >

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-15 Thread Holger Wansing
Hi, James Addison wrote (Sun, 14 Apr 2024 23:52:03 +0100): > From some testing of these: the search results have a problem that they > hyperlink to a language-less .html URL, meaning that clicking a result link in > the DE-language search results takes the user to a EN-language page. Yes, good

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-14 Thread James Addison
Hi Holger, On Sun, 14 Apr 2024 22:40:36 +0200, Holger wrote: > I forgot to mention, that I have pushed a release-notes variant with this theme to > https://people.debian.org/~holgerw/new-rtd-sphinx-theme-for-debian/release-notes/release-notes/index.en.html > (English) > >

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-14 Thread Holger Wansing
Hi, Holger Wansing wrote (Sun, 14 Apr 2024 22:25:21 +0200): > It can be seen at debian-policy under > https://www.debian.org/doc/debian-policy/ I forgot to mention, that I have pushed a release-notes variant with this theme to

Bug#932957: 'Official' Debian-style html theme for Sphinx-based docs

2024-04-14 Thread Holger Wansing
Hi, you may have noticed that we have an 'official' Debian-style html theme for Sphinx-based manuals on the Debian website now. It can be seen at debian-policy under https://www.debian.org/doc/debian-policy/ It was created by Stéphane Blondon, based on a theme from readthedocs.org. Any