Документация Xingluo
Xingluo — это современная CMS для блогов, созданная на Astro с визуальным стилем shadcn/ui. Она обеспечивает более современный визуальный опыт благодаря плоским элегантным компонентам shadcn и цветовой системе OKLCH, а также включает систему комментариев, опциональную поддержку MDX и аудио/видеоплееры.
Содержание документации
| Документ | Содержание |
|---|---|
| Начало работы | Требования, установка, локальная разработка, сборка и предпросмотр |
| Руководство по настройке | Полная справка по xingluo.config.ts |
| Создание контента | Frontmatter постов, синтаксис Markdown/MDX, блоки кода, callouts, улучшения |
| Интернационализация | Многоязычная маршрутизация, строки UI, перевод на уровне контента, добавление языка |
| Обзор архитектуры | Структура каталогов, поток конфигурации, поток рендеринга, конвейер сборки |
| Тема и стили | Переменные темы shadcn, OKLCH, Tailwind v4, темный режим |
| Система комментариев | Выбор и настройка giscus / twikoo / waline |
| Медиаплееры | Использование APlayer / DPlayer в Markdown и MDX |
| SEO | OG-изображения, RSS, карта сайта, hreflang, canonical, структурированные данные |
| Поиск | Интеграция полнотекстового поиска Flexsearch |
| Развертывание | Статический хостинг, GitHub Pages, переменные окружения, Docker |
Основные возможности
- Производительность высшего уровня: статическая генерация Astro, встроенные SVG-иконки во время сборки (ноль JS во время выполнения), ленивая загрузка комментариев и плееров, очистка orphan-ассетов
- Современный внешний вид: компоненты shadcn/ui new-york, цветовое пространство OKLCH, плавный темный режим (защита FOUC)
- Многоязычность: перевод на уровне UI и контента, маршрутизация
prefixDefaultLocale: false, SEO-объявления hreflang и x-default - Улучшение контента: опциональный MDX, подсветка кода Shiki с двойной темой, callouts, сворачиваемое оглавление, прокручиваемые таблицы
- Время чтения: интеллектуальная оценка (CJK по количеству символов, латиница по количеству слов), отображается на карточках и страницах деталей
- Связанные посты: автоматически рекомендуются по общим тегам
- Категории постов: назначаются через frontmatter, с отдельными страницами категорий и навигацией
- Фиксированная боковая панель TOC: фиксированное оглавление справа на больших экранах, отслеживание прокрутки IntersectionObserver
- Система комментариев: giscus / twikoo / waline, с учетом темы, ленивая загрузка
- Медиаплееры: аудио APlayer и видео DPlayer, с точками входа MD fence и компонента MDX
- Поиск: полнотекстовый поиск Flexsearch, индексы по языкам, сохранение состояния View Transitions
- Полное SEO: динамические OG-изображения (satori + sharp), RSS, карта сайта, структурированные данные JSON-LD (BlogPosting + BreadcrumbList), нормализация canonical
Технологический стек
| Категория | Технология |
|---|---|
| Фреймворк | Astro 6.x |
| Стилизация | Tailwind CSS v4, компоненты в стиле shadcn/ui, @tailwindcss/typography |
| Иконки | astro-icon + Font Awesome |
| Контент | Astro Content Collections, MDX, цепочка плагинов remark/rehype |
| Подсветка кода | Shiki |
| Поиск | Flexsearch |
| OG-изображения | satori + sharp |
| Комментарии | giscus / twikoo / waline |
| Плееры | APlayer / DPlayer |
| Дата | dayjs |
| Менеджер пакетов | pnpm |
| Язык | TypeScript |
Лицензия
AGPL-3.0
Поделиться статьёй: Поделиться в X Поделиться в Facebook Поделиться в Telegram Поделиться в Weibo Поделиться по email
Похожие статьи
Развертывание
2 мин чтенияРуководство по развертыванию Xingluo, охватывающее платформы статического хостинга (Netlify/Vercel/GitHub Pages), самостоятельный хостинг Nginx, Docker и переменные окружения.
Поиск
1 мин чтенияРуководство по поиску Xingluo, охватывающее интеграцию полнотекстового поиска Flexsearch, генерацию индексов, UI, многоязычный поиск и производительность.