OSError: no library called "cairo-2" was found

[schroedk]

When trying to build the documentation via

mkdocs build

or

mkdocs serve

I observed the error

OSError: no library called "cairo-2" was found no library called "cairo" was found no library called "libcairo-2" was found

Setup:

• Python 3.8.19
• Mac OS 14.4 / M2 Max

The error is due to the corresponding lib files not linked to locations, where mkdocs is looking for it, when cairo is installed via
brew.

Also observed here:

• Cairocffi can't find cairo library squidfunk/mkdocs-material#5121
• mkdocs serve fails to import libcairo on certain mac setups dora-metrics/pelorus#1073
• OSError: no library called "cairo-2" was found squidfunk/mkdocs-material#6071

The described workaround is setting the fallback environment variable:

export DYLD_FALLBACK_LIBRARY_PATH=$DYLD_FALLBACK_LIBRARY_PATH:/opt/homebrew/lib

I suggest to mention this in our CONTRIBUTING.md.

[schroedk]

@mdbenito @AnesBenmerzoug did you have to install the non-python dependencies manually? So something like:

apt-get install libcairo2-dev libfreetype6-dev libffi-dev libjpeg-dev libpng-dev libz-dev

[AnesBenmerzoug]

I am not 100% sure, but I would say yes.