How to use MathJax and Giscus with privacy plugin

[ZhiyuanChen]

Hi,

privacy plugin will download everything to local, while it does not download referenced js in MathJax of , it also makes Giscus unusable. Is there a workaround?

[squidfunk]

Thanks for asking. I've checked MathJax and yes, it does not correctly work due to the use of non-qualified URLs to resolve *.js and *.woff files. Thus, for MathJax, the solution is to download the JavaScript and additional assets manually. Sadly this can not be fixed, because we can't execute the JavaScript to generate the full URLs during the build process.

Please open an issue for the problem with Giscus, describing what does not work correctly. The solution is likely to exclude Giscus from processing with the privacy plugin. I'm thinking of adding exclude patterns, so this can be configured via mkdocs.yml.

Edit: it appears that self-hosting Giscus is possible, but requires more than just copying assets:
https://github.com/giscus/giscus/blob/main/SELF-HOSTING.md

[ZhiyuanChen]

The issue with mathjax is very diasppointing, it is a huge js and makes the site much slower if move to local as there would be no cdn for this.

Ths issue of Giscus is at #3662

[squidfunk]

I understand and am sorry for that. However, it is not fixable from our side as I already explained. Thanks for creating the Giscus issue, I'll look into it asap. The idea is to add an exclusion list, so you could add MathJax and Giscus.

[ZhiyuanChen]

Thank you so much!