Индекс всех страниц блога сайта повязок

При каждом переходе на страницу блога, сайт запрашивает актуальный файл index.json из репозитория для отображения его на сайте.

Страницы

Все страницы блога располагаются в директории pages.
Каждая страница представлена отдельной вложенной директорией, которая содержит файл контента page.md и файл метаданных страницы meta.json.

Метаданные страницы

Файл meta.json должен иметь правильную схему для корректной индексации.

Пример схемы:

{
    "title": "Hello world",
    "description": "Description",
    "category": "Категория", // Опционально
    "pinned": false, // Опционально
    "override_author": "Andcool" // Опционально
}

Автоиндекс

При каждом пуше в репозиторий запускается GitHub Action, который получает список изменений, которые были внесены с момента последнего индекса. В процессе он проверяет все страницы, которые были затронуты, валидирует их метаданные по схеме и составляет новый index.json с новыми данными. После выполняется пуш нового индекса в ветку.

Формат страниц

Контент, который находится в файлах page.md может иметь полноценный формат Markdown с некоторыми дополнениями.

Информационный блоки

<Note>Контент</Note>

будет преобразован в

Note

Контент

И так далее с Warn и Tip соответственно.

Эмоуты

Чтобы использовать эмоуты, добавьте блок <Emote name="emote-name"></Emote> на свою страницу.

Ассеты

Если вам нужно использовать какие-либо статические ассеты (картинки, видео, аудио), НЕ ИСПОЛЬЗУЙТЕ СТОРОННИЕ ЗАГРУЗЧИКИ! Весь статический контент должен находиться внутри директории /images. Парсер сам преобразовывает пути внутри репозитория в корректный URL. Например, ![image](/images/blog-page/image.png) и так далее.

---

Created by AndcoolSystems, 21 August, 2025