Перейти к содержанию

Иконки

Иконки и эмодзи

Используйте визуальные элементы для улучшения восприятия текста.


⚙ Настройка

В mkdocs.yml:

markdown_extensions:
  - attr_list       # Добавление классов
  - pymdownx.emoji  # Поддержка эмодзи и иконок


🧩 Использование

Эмодзи

:smile: :heart: :rocket:
Результат:
😄 ❤ 🚀


Иконки

:fontawesome-regular-face-smile:  
:material-star:  
:octicons-heart-24:  
Результат:



Стилизация

  1. Цвет:

    :simple-youtube:{ .youtube } <!-- Красный цвет -->
    
    /* extra.css */
    .youtube { color: #EE0F0F; }
    

  2. Анимация:

    :octicons-heart-fill-24:{ .heart }
    
    /* extra.css */
    @keyframes pulse {
      0%, 100% { transform: scale(1); }
      50% { transform: scale(1.2); }
    }
    .heart { animation: pulse 1s infinite; }
    

Результат:


💡 Особенности

  • Работают в заголовках и боковых панелях
  • Поддерживают все встроенные наборы:
  • Material Design ()
  • FontAwesome ()
  • Octicons ()
  • Simple Icons ()
  • Совместимы с темной/светлой темой

🛠 Кастомизация

Добавьте свои иконки:
1. Поместите SVG-файл в docs/images/icons/
2. Используйте в разметке:

:custom-my-icon:

В шаблонах Jinja:

<span class="twemoji">
  {% include ".icons/custom/my-icon.svg" %}
</span>