• Bug#1066967: Bug#1064593: Bug#1066967: dh_sphinxdoc: replaces files pro

    From Andrey Rakhmatullin@21:1/5 to Holger Wansing on Fri Mar 22 12:00:01 2024
    On Fri, Mar 22, 2024 at 11:29:11AM +0100, Holger Wansing wrote:
    I cannot reproduce this. I downloaded debian-policy source package and built
    it in an up-to-date sid chroot. And the built package has this:

    $ dpkg-deb -c debian-policy_4.6.2.1_all.deb | grep theme.css
    lrwxrwxrwx root/root 0 2024-02-24 15:39 ./usr/share/doc/debian-policy/policy.html/_static/css/theme.css -> ../../../../../sphinx_rtd_theme/static/css/theme.css

    But above output shows a filesize of 0B.
    Shouldn't that be something different?
    Not for symlinks.

    Has ./usr/share/doc/debian-policy/policy.html/_static/css/theme.css any useful content, when you open it?
    It's a symlink, it can't have content.
    It's target does have content, as shown in the quote below:

    So, it is a symlink, not an empty file. When resolving the relative path,
    I get /usr/share/sphinx_rtd_theme/static/css/theme.css, and that file exists in sphinx-rtd-theme-common and is non-empty.

    if you open that theme.css file in the debian/debian-policy build path,
    does it have any content?
    :-/

    Maybe it was bad wording, when I wrote
    "replaces files provided by read-the-doc theme by empty symlinks" in the subject of this bug.
    Probably "symlinks pointing to a not-existing file" is more correct?
    To which non-existent files? Are they non-existent only when you don't
    have sphinx-rtd-theme-common installed?

    I don't know where's the problem in detail, I only see that in the debian-policy binary package that file is empty, and therefore the html layout is broken.
    It's not empty, it's a symlink that points to a non-existent (on your
    system) file.

    BTW: the same counts for all the symlinks under _static/fonts/:

    holgerw@t520:~/debian-policy$ ls -la policy/debian/debian-policy/usr/share/doc/debian-policy/policy.html/_static/fonts/
    total 64
    drwxr-xr-x 2 holgerw holgerw 4096 Mar 22 11:17 .
    drwxr-xr-x 5 holgerw holgerw 4096 Mar 22 11:17 ..
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.eot -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.svg -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf
    lrwxrwxrwx 1 holgerw holgerw 69 Mar 22 11:17 fontawesome-webfont.woff -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff
    lrwxrwxrwx 1 holgerw holgerw 70 Mar 22 11:17 fontawesome-webfont.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2
    lrwxrwxrwx 1 holgerw holgerw 64 Mar 22 11:17 Lato-BoldItalic.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.ttf
    lrwxrwxrwx 1 holgerw holgerw 66 Mar 22 11:17 Lato-BoldItalic.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.woff2
    lrwxrwxrwx 1 holgerw holgerw 58 Mar 22 11:17 Lato-Bold.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.ttf
    lrwxrwxrwx 1 holgerw holgerw 60 Mar 22 11:17 Lato-Bold.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.woff2
    lrwxrwxrwx 1 holgerw holgerw 60 Mar 22 11:17 Lato-Italic.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Italic.ttf
    lrwxrwxrwx 1 holgerw holgerw 62 Mar 22 11:17 Lato-Italic.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Italic.woff2
    lrwxrwxrwx 1 holgerw holgerw 61 Mar 22 11:17 Lato-Regular.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Regular.ttf
    lrwxrwxrwx 1 holgerw holgerw 63 Mar 22 11:17 Lato-Regular.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Regular.woff2
    lrwxrwxrwx 1 holgerw holgerw 66 Mar 22 11:17 RobotoSlab-Bold.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.woff2
    lrwxrwxrwx 1 holgerw holgerw 69 Mar 22 11:17 RobotoSlab-Regular.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.woff2

    All those symlinks are pointing to a not-existing target here.
    Only because you don't have sphinx-rtd-theme-common installed.

    --
    WBR, wRAR

    -----BEGIN PGP SIGNATURE-----

    iQJhBAABCgBLFiEEolIP6gqGcKZh3YxVM2L3AxpJkuEFAmX9YnItFIAAAAAAFQAP cGthLWFkZHJlc3NAZ251cGcub3Jnd3JhckBkZWJpYW4ub3JnAAoJEDNi9wMaSZLh IB8P+QE/7O5/8+DnLy/WPpmHEzm9wbtb29b+xi5WJzBenTPvUwfwnDD3feHMPpdb +bLHASNxZFQsWBoAH1Z3MeOOTQNH91gTQhpym4jNJI5HO/UHmENcusBS656yMb9O XzpZSphDDCjsb30pbqPGeHh+PeywsTVbi62hTSI9uV1HDhog9rTI00ET1yihWILb CHLkAWLCQuC1LkejoWGi1J2VLlFjqooFEKoHBbmJECeBhe6durdbNwMWcXrskwqx 6FC0kKyQfJGYmGAGXTsXlDTq87e8bPngTk+pse0ugGsJaBkTR8gkp4FaZ7uzUS8P bbB2QKdl8lbaxJooGfp+PcNInxRZtY4/qPGcZ668M61pNS6SW0BXsyaLkk3k8o4G EMqLP0qo9ARGln3S5Ltek92DSysRRF6YqI2GXA0bHZ5E9XtFBVJur/+XLhYsRxC7 EysST85LeC3+LUFDbHiPoEoAeSSUsNEYNRrrn3luUlGBFqOzfv8QiOt1vL5yrrOm lYki4PCqQsX7keISxNEnkPXhLiSwK3WyjKrNPq2cxNX0Fv7ARN9GNBAjyXrH0ftr W2m9DYyNI+9n49gO3DFpxIWG2S/5n94t+Zs+WXYiqPaNyNcLIXe8z6ff0tDUQJ6r xEJqa6JMZPJw6g9o5+LcLqKM+X0DxhHvHX/7t5qSba5IBOLC
    =Bj5E
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Holger Wansing@21:1/5 to Andrey Rakhmatullin on Fri Mar 22 14:00:01 2024
    Hi,

    Andrey Rakhmatullin <wrar@debian.org> wrote (Fri, 22 Mar 2024 15:50:26 +0500):
    On Fri, Mar 22, 2024 at 11:29:11AM +0100, Holger Wansing wrote:
    I cannot reproduce this. I downloaded debian-policy source package and built
    it in an up-to-date sid chroot. And the built package has this:

    $ dpkg-deb -c debian-policy_4.6.2.1_all.deb | grep theme.css
    lrwxrwxrwx root/root 0 2024-02-24 15:39 ./usr/share/doc/debian-policy/policy.html/_static/css/theme.css -> ../../../../../sphinx_rtd_theme/static/css/theme.css

    But above output shows a filesize of 0B.
    Shouldn't that be something different?
    Not for symlinks.

    Ok.


    Has ./usr/share/doc/debian-policy/policy.html/_static/css/theme.css any useful content, when you open it?
    It's a symlink, it can't have content.
    It's target does have content, as shown in the quote below:

    So, it is a symlink, not an empty file. When resolving the relative path, I get /usr/share/sphinx_rtd_theme/static/css/theme.css, and that file exists in sphinx-rtd-theme-common and is non-empty.

    if you open that theme.css file in the debian/debian-policy build path, does it have any content?
    :-/

    Maybe it was bad wording, when I wrote
    "replaces files provided by read-the-doc theme by empty symlinks" in the subject of this bug.
    Probably "symlinks pointing to a not-existing file" is more correct?
    To which non-existent files? Are they non-existent only when you don't
    have sphinx-rtd-theme-common installed?

    Sure.

    I don't know where's the problem in detail, I only see that in the debian-policy binary package that file is empty, and therefore the html layout is broken.
    It's not empty, it's a symlink that points to a non-existent (on your
    system) file.

    BTW: the same counts for all the symlinks under _static/fonts/:

    holgerw@t520:~/debian-policy$ ls -la policy/debian/debian-policy/usr/share/doc/debian-policy/policy.html/_static/fonts/
    total 64
    drwxr-xr-x 2 holgerw holgerw 4096 Mar 22 11:17 .
    drwxr-xr-x 5 holgerw holgerw 4096 Mar 22 11:17 ..
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.eot -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.eot
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.svg -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.svg
    lrwxrwxrwx 1 holgerw holgerw 68 Mar 22 11:17 fontawesome-webfont.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.ttf
    lrwxrwxrwx 1 holgerw holgerw 69 Mar 22 11:17 fontawesome-webfont.woff -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff
    lrwxrwxrwx 1 holgerw holgerw 70 Mar 22 11:17 fontawesome-webfont.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/fontawesome-webfont.woff2
    lrwxrwxrwx 1 holgerw holgerw 64 Mar 22 11:17 Lato-BoldItalic.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.ttf
    lrwxrwxrwx 1 holgerw holgerw 66 Mar 22 11:17 Lato-BoldItalic.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-BoldItalic.woff2
    lrwxrwxrwx 1 holgerw holgerw 58 Mar 22 11:17 Lato-Bold.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.ttf
    lrwxrwxrwx 1 holgerw holgerw 60 Mar 22 11:17 Lato-Bold.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Bold.woff2
    lrwxrwxrwx 1 holgerw holgerw 60 Mar 22 11:17 Lato-Italic.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Italic.ttf
    lrwxrwxrwx 1 holgerw holgerw 62 Mar 22 11:17 Lato-Italic.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Italic.woff2
    lrwxrwxrwx 1 holgerw holgerw 61 Mar 22 11:17 Lato-Regular.ttf -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Regular.ttf
    lrwxrwxrwx 1 holgerw holgerw 63 Mar 22 11:17 Lato-Regular.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/Lato-Regular.woff2
    lrwxrwxrwx 1 holgerw holgerw 66 Mar 22 11:17 RobotoSlab-Bold.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/RobotoSlab-Bold.woff2
    lrwxrwxrwx 1 holgerw holgerw 69 Mar 22 11:17 RobotoSlab-Regular.woff2 -> ../../../../../sphinx_rtd_theme/static/fonts/RobotoSlab-Regular.woff2

    All those symlinks are pointing to a not-existing target here.
    Only because you don't have sphinx-rtd-theme-common installed.

    That is indeed installed in the latest version here (sid):

    root@t520:/# dpkg -s sphinx-rtd-theme-common
    Package: sphinx-rtd-theme-common
    Status: install ok installed
    Priority: optional
    Section: python
    Installed-Size: 1173
    Maintainer: Debian Python Team <team+python@tracker.debian.org>
    Architecture: all
    Multi-Arch: foreign
    Source: sphinx-rtd-theme
    Version: 2.0.0+dfsg-1
    Depends: fonts-font-awesome, fonts-lato
    Description: sphinx theme from readthedocs.org (common files)
    This mobile-friendly sphinx theme was initially created for readthedocs.org,
    but can be incorporated in any project.
    .
    Among other things, it features a left panel with a browseable table of
    contents, and a search bar.
    .
    This package contains the common files used by the theme.
    Homepage: https://github.com/readthedocs/sphinx_rtd_theme

    ---------------------------------------------------------------------------------


    Anyway, the symlink points to some path inside the package build path, here: /srv/debian-policy/debian-policy-4.6.2.1/debian/debian-policy/usr/share/sphinx_rtd_theme_static/css/theme.css

    and that path does not exist.
    Same in the debian-policy binary package.


    Holger

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

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)
  • From Andrey Rakhmatullin@21:1/5 to Holger Wansing on Fri Mar 22 14:10:01 2024
    On Fri, Mar 22, 2024 at 01:46:48PM +0100, Holger Wansing wrote:
    Anyway, the symlink points to some path inside the package build path, here: /srv/debian-policy/debian-policy-4.6.2.1/debian/debian-policy/usr/share/sphinx_rtd_theme_static/css/theme.css
    You are looking at relative symlinks not in their final locations, which
    isn't useful and also is expected for every relative symlink that is
    packaged.

    --
    WBR, wRAR

    -----BEGIN PGP SIGNATURE-----

    iQJhBAABCgBLFiEEolIP6gqGcKZh3YxVM2L3AxpJkuEFAmX9gHQtFIAAAAAAFQAP cGthLWFkZHJlc3NAZ251cGcub3Jnd3JhckBkZWJpYW4ub3JnAAoJEDNi9wMaSZLh 4QEP/2hgPPeoeUfWQwgmoutbU3bNC3ao9UV28b37QAjeKTkA8XcZ8evyigfoPirv SXybTdtYrHsmetqvMLlv13DwTAY1WqK9bTpzCA3O2YhIMKziZx3WmI4kPcRAct9z ExXokE3SR6tk8+I0iLNC6RpHeGYjjyz5diSb4H9XlLkoVPGw6vqu1FPvUDLMJWMp RxcEyyJ4XJ3mR0Q+MeNvekIGLuMRhN2qxtf/45CnahYiMY4KkMBGeLn9WHroCib7 ZA13yvWB3lfMSfw9WgZ5/iCdPcDSGBKxcU6v6l1Vy+I4k2icA/CY1XzjLQ2cSRVE dyblTA/XOrA+/KuilUEprkmr3l752706iNctG60SzpiEgysxLBHmwKkTnAFsEzOm 6xLcYwfr6mcGb5pTZEfklux04wht++/na2yfuQQGOVEhE/QYiFKf4bblQ4fiSa7j 9gyEHd9kQYNERWl/T6N0Ewd5xLO2YIYYgmMPvPTPXED3z5pkhNhQBTOIh7GZBJBp AEof2qOti7UGFQleT6rRqWEPzsyoGwJSMN4fxeO2UE3X/ZEJnQBQXHs15l4EhvHk frzcXh3RfyX2eNcCLJ5OOxq+VjMZwnp5NVcAevit6WNGYWpTmEJ01JvHcoboiyWO 4PeRFWU2Lh5ABt9XYghvYFRdXag89jf6y1Ms0blWj5KBrsX+
    =P2rn
    -----END PGP SIGNATURE-----

    --- SoupGate-Win32 v1.05
    * Origin: fsxNet Usenet Gateway (21:1/5)