Hi Rebecca and all!

On Sun, Nov 24, 2024 at 10:25:36AM +0000, Rebecca N. Palmer wrote:
> Control: affects 1085947 + src:python-xarray
>
> pydata-sphinx-theme itself now works, but sphinx-book-theme doesn't (this is
> #1085947) and those look like the packages using sphinx-book-theme.

Are you sure that pydata-sphinx-theme really works?

The binary package in unstable does not contain pydata-sphinx-theme.js or
pydata-sphinx-theme.css, which are present in upstream wheel.

And the only CSS file which is shipped in the package has just one line:
@import "../basic.css".

I made an attempt to generate pydata-sphinx-theme CSS file from SASS sources,
but unfortunately those files seem to use syntax and functions that are only
supported by dart-sass, and not by libsass or ruby-sass. And dart-sass is not
yet packaged in Debian [1]. The wnpp bug suggests using rsass, but rsass does
not yet support all features required by bootstrap [2].

While some parts of the code can be downgraded to older SASS standard by
renaming the functions, there is e.g. use of pow() function [3] for which I
found no replacement.

So, it looks like we need a volunteer to package dart and dart-sass, before
pydata-sphinx-theme or sphinx-book-theme are actually useful.

Or, alternatively, we can use pre-built CSS files from upstream for now.
This sounds like a much simpler path than the previous option, so I can try to
implement it myself. What do you think?

[1]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=998024
[2]: https://github.com/kaj/rsass/issues/186
[3]: 
https://github.com/pydata/pydata-sphinx-theme/blob/v0.16.1/src/pydata_sphinx_theme/assets/styles/abstracts/_accessibility.scss#L74

--
Dmitry Shachnev

Reply via email to