Emoji in offline environment

[earthwalker31]

When hosting the wiki in a network without internet connection, emojis dont seem to render correctly, because there is no connection to: https://cdn.jsdelivr.net/gh/jdecked/[email protected]/assets/svg/XXXXX.svg

This is my config:

markdown_extensions:
  - pymdownx.emoji:
  	emoji_index: !!python/name:materialx.emoji.twemoji
  	emoji_generator: !!python/name:materialx.emoji.to_svg

Is there any way of self hosting the twemoji converter? Are the other emoji indexes available offline?

[squidfunk]

Excellent question! This problem is solved by the privacy plugin, which downloads all external resources (emojis, images, style sheets, scripts, etc.) during mkdocs build and bundles them with your documentation, so they can be viewed without a connection.

You only need to add one line of config to the plugins setting in mkdocs.yml.

plugins:
  - privacy

Note that the privacy plugin is currently only available in Insiders, and thus reserved to sponsors ☺️ Sponsorships start at $15 for non-commercial use and at $125 for commercial use.

[kamilkrzyskow]

You can also create a MkDocs Hook which replaces any https://cdn.jsdelivr.net/gh/jdecked/[email protected]/ prefix with your own path to the previously downloaded SVG assets directory.

But paying for Insiders and using the privacy plugin would be easier and faster to do ✌️

[squidfunk]

Thanks for sharing – jup, anything is possible to achieve with customization. In the end, the question is how much code you want to maintain yourself and how much time you want to put into a solution we've already built and that is battle-tested ☺️ Also, if you run into any bugs with the privacy plugin, we're more than happy to fix them as quickly as we can 🚀