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

[Dmitry Shachnev]

Control: block -1 by 899124

Hi Stephen,

On Mon, Jun 11, 2018 at 12:12:33PM +0000, Stephen Sinclair wrote:
> 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 /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?

It looks like font-awesome was upgraded to version 5.0 which has filenames
completely different from 4.x.

See this bug for details:
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=899124.

Unfortunately there is no easy way to fix it. What we can do:

- Port mkdocs to font-awesome 5.x. The MkDocs RTD theme is based on Sphinx
  RTD theme so the Sphinx version must be ported first. I do not see any
  related activity in https://github.com/rtfd/sphinx_rtd_theme yet.

- Revert to using a bundled version of font-awesome 4.x, like it was the case
  before my 0.17.3+dfsg-1 upload (there can be problems with DFSG).

- Package font-awesome 4.x as a new source package and use it until we are
  ready for 5.x. This looks like the best solution, but I do not have enough
  time or interest to maintain the old version of font-awesome. Considering
  that this change affects many packages, I hope someone from the fonts team
  will step up to do it.

So for now I would prefer to wait until #899124 has some resolution and
recommend you to build your packages with fonts-font-awesome from testing
until this gets fixed.

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/python-modules-team/attachments/20180613/7c5b6067/attachment.sig>