Problem

The homepage uses emoji shortcodes (, , ) in the "Get Started" section, but they don't render as emojis on the deployed site at https://osg-htc.org/networking/

Solution

Add the pymdownx.emoji extension to mkdocs.yml with Material theme's Twemoji integration.

Changes

markdown_extensions:
  # ... existing extensions ...
  - pymdownx.emoji:
      emoji_index: cd /root/Git-Repositories/networking && git push -u origin fix/enable-emoji-supportpython/name:material.extensions.emoji.twemoji
      emoji_generator: cd /root/Git-Repositories/networking && git push -u origin fix/enable-emoji-supportpython/name:material.extensions.emoji.to_svg

This enables:

• ✅ Emoji shortcode rendering (e.g., :rocket: → 🚀)
• ✅ Consistent emoji appearance across all browsers
• ✅ SVG-based rendering for crisp display at any size
• ✅ Works with Material for MkDocs theme

Result

After merging, the homepage will properly display:

• 🚀 Deploy perfSONAR
• 🔧 Troubleshoot Network Issues
• 🔭 Understand the System

Documentation

• PyMdown Extensions - Emoji
• Material for MkDocs - Icons & Emojis