[Python-modules-team] Bug#901318: mkdocs: package contains broken symlink to font-awesome.ttf

[Stephen Sinclair]

Package: mkdocs
Version: 0.17.3+dfsg-1
Severity: important

Dear Maintainer,

While building keras-doc, which uses mkdocs, I got the following error (full trace later):

FileNotFoundError: [Errno 2] No such file or directory: '/usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/fontawesome-webfont.ttf'

It appears that this file is a broken symlink to a file that was
previously in the fonts-font-awesome package.  In my chroot
fonts-font-awesome is installed, but,

$ ls -l /usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/fontawesome-webfont.ttf
lrwxrwxrwx 1 root root 78 May 25 13:08 /usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/fontawesome-webfont.ttf -> ../../../../../../../share/fonts/truetype/font-awesome/fontawesome-webfont.ttf

$ ls /usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/../../../../../../../share/fonts/truetype/font-awesome/fontawesome-webfont.ttf
ls: cannot access '/usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/../../../../../../../share/fonts/truetype/font-awesome/fontawesome-webfont.ttf': No such file or directory

# ls /usr/share/fonts/truetype/font-awesome/
fa-brands-400.ttf  fa-regular-400.ttf  fa-solid-900.ttf

Therefore I conclude that an important symlink is missing, and mkdocs
does not work as installed.  Can you please verify?

kind regards,
Steve


Full traceback:

INFO    -  Building documentation to directory: /build/keras-2.2.0/docs/html 
Traceback (most recent call last):
  File "/usr/bin/mkdocs", line 11, in <module>
    load_entry_point('mkdocs==0.17.3', 'console_scripts', 'mkdocs')()
  File "/usr/lib/python3/dist-packages/click/core.py", line 722, in __call__
    return self.main(*args, **kwargs)
  File "/usr/lib/python3/dist-packages/click/core.py", line 697, in main
    rv = self.invoke(ctx)
  File "/usr/lib/python3/dist-packages/click/core.py", line 1066, in invoke
    return _process_result(sub_ctx.command.invoke(sub_ctx))
  File "/usr/lib/python3/dist-packages/click/core.py", line 895, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/usr/lib/python3/dist-packages/click/core.py", line 535, in invoke
    return callback(*args, **kwargs)
  File "/usr/lib/python3/dist-packages/mkdocs/__main__.py", line 156, in build_command
    ), dirty=not clean)
  File "/usr/lib/python3/dist-packages/mkdocs/commands/build.py", line 276, in build
    theme_dir, config['site_dir'], exclude=['*.py', '*.pyc', '*.html', 'mkdocs_theme.yml'],
 dirty=dirty
  File "/usr/lib/python3/dist-packages/mkdocs/utils/__init__.py", line 179, in copy_media_f
iles
    copy_file(source_path, output_path)
  File "/usr/lib/python3/dist-packages/mkdocs/utils/__init__.py", line 113, in copy_file
    shutil.copyfile(source_path, output_path)
  File "/usr/lib/python3.6/shutil.py", line 120, in copyfile
    with open(src, 'rb') as fsrc:
FileNotFoundError: [Errno 2] No such file or directory: '/usr/lib/python3/dist-packages/mkdocs/themes/readthedocs/fonts/fontawesome-webfont.ttf'


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

Kernel: Linux 4.15.0-22-generic (SMP w/4 CPU cores)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968), LANGUAGE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /usr/bin/dash
Init: unable to detect

Versions of packages mkdocs depends on:
ii  fonts-font-awesome       5.0.10-4
ii  libjs-bootstrap          3.3.7+dfsg-2
ii  libjs-highlight.js       9.12.0+dfsg1-4
ii  libjs-jquery             3.2.1-1
ii  libjs-modernizr          2.6.2+ds1-3
ii  libjs-mustache           2.3.0-2
ii  libjs-requirejs          2.3.2-1
ii  libjs-requirejs-text     2.0.12-1
ii  python3                  3.6.5-3
ii  python3-click            6.7-4
ii  python3-jinja2           2.10-1
ii  python3-livereload       2.5.2-1
ii  python3-markdown         2.6.9-1
ii  python3-pkg-resources    39.1.0-1
ii  python3-tornado          5.0.2-1
ii  python3-yaml             3.12-1+b1
ii  sphinx-rtd-theme-common  0.2.4-1

mkdocs recommends no packages.

Versions of packages mkdocs suggests:
pn  ghp-import  <none>
pn  mkdocs-doc  <none>

-- no debconf information