Package: furo
Version: 2023.09.10+dfsg-2
Severity: important
X-Debbugs-Cc: raph...@freexian.com

Hello Georges,

I was trying to use "furo" (as packaged in Debian) to build the debusine
documentation but I figured out that multiple things were not working
right:
https://hertzog.pages.debian.net/-/debusine/-/jobs/5153568/artifacts/docs/_build/html/index.html

- I have unwanted margins around the page, that's because "normalize.css"
  is not found, the Debian package hardcodes
  "/javascript/normalize.css/normalize.css" as the path... it's totally
  unreasonable to make that assumption for random documentation. It's
  great to reuse the Debian packaged version, but it should be reused in a
  way where it gets duplicated in the generated documentation so that
  the documentation is self-contained.

- the dark/light theme switcher is hidden because I have a ".no-js" class
  that is not removed by _static/scripts/furo.js because that script fails
  on the first import line (Uncaught SyntaxError: import declarations may
  only appear at top level of a module). This line has been patched
  by the Debian packaging, but I'm not sure if the change is the source of
  the problem.

Cheers,

-- System Information:
Debian Release: trixie/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 6.6.8-amd64 (SMP w/16 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages furo depends on:
ii  node-normalize.css  8.0.1-5
ii  python3             3.11.6-1
ii  python3-bs4         4.12.2-2
ii  python3-pygments    2.15.1+dfsg-1
ii  python3-sphinx      7.2.6-3
ii  sphinx-basic-ng     1.0.0~beta2-1

furo recommends no packages.

furo suggests no packages.

-- no debconf information

Reply via email to