README.ru.md

Firefly

Свежий и красивый шаблон темы блога Astro

QQ交流群：1087127207

---

📖 README: 简体中文 | 繁體中文 | English | 日本語 | Русский

🚀 Быстрое руководство: 🖥️Демо / 📝Документация / 🍀Мой блог

⚡ Генерация статического сайта: Сверхбыстрая загрузка и SEO-оптимизация на основе Astro

🎨 Современный дизайн: Чистый и красивый интерфейс с настраиваемыми цветами темы

📱 Мобильная адаптация: Идеальный адаптивный опыт с оптимизацией для мобильных устройств

🔧 Высокая настраиваемость: Большинство функций можно настроить через конфигурационные файлы

Tip

Firefly — это свежая и красивая тема для персонального блога на основе фреймворка Astro и шаблона Fuwari, разработанная для энтузиастов технологий и создателей контента. Эта тема интегрирует современные веб-технологические стеки, предоставляет богатые функциональные модули и высококастомизируемые интерфейсы, позволяя легко создать профессиональный и красивый веб-сайт персонального блога.

В важных макетах Firefly инновационно добавляет двойные боковые панели, сеточный макет статей (многоколонный), макет Masonry, включает статистику сайта, календарный компонент, оглавление статей и другие виджеты для обогащения боковой панели, при этом сохраняется система макетов fuwari, свободно переключаемая в конфигурационном файле.

Подробнее о настройках макета и демонстрациях см.: Детали системы макетов Firefly

Firefly поддерживает переключение языков i18n, но кроме упрощенного китайского, другие языки переведены с помощью ИИ. Если есть ошибки, пожалуйста, отправьте Pull Request для исправления.

✨ Возможности

Основные функции

• Astro + Tailwind CSS - Сверхбыстрая генерация статических сайтов на основе современного технологического стека
• Плавная анимация - Анимация переходов между страницами Swup для шелковисто-плавного просмотра
• Адаптивный дизайн - Идеальная адаптация для настольных компьютеров, планшетов и мобильных устройств
• Многоязычная поддержка - Интернационализация i18n, поддержка упрощенного китайского, традиционного китайского, английского, японского, русского
• Полнотекстовый поиск - Клиентский поиск на основе Pagefind, поддержка индексации содержимого статей.

Персонализация

• Динамическая боковая панель - Поддержка одиночной и двойной боковой панели
• Макет статей - Поддержка списка (один столбец) и сетки (многоколонный/Masonry)
• Управление шрифтами - Поддержка пользовательских шрифтов с богатым выбором шрифтов
• Настройка подвала - Внедрение HTML-контента, полная настраиваемость
• Режим света и тьмы - Поддержка светлого/темного/системного режимов
• Настройка навигации - Логотип, заголовок, ссылки полностью настраиваются
• Переключение режимов обоев - Баннерные обои, полноэкранные обои, однотонный фон
• Настройка цвета темы - Регулировка оттенка на 360°

Если у вас есть полезные функции и оптимизации, пожалуйста, отправьте Pull Request

🚀 Быстрый старт

Требования

• Node.js ≥ 22
• pnpm ≥ 9

Локальная разработка

1. Клонировать репозиторий:

   git clone https://github.com/Cuteleaf/Firefly.git
   cd Firefly

   Сначала создайте Fork в свой репозиторий, затем клонируйте (рекомендуется). Не забудьте нажать Star перед Fork!

   git clone https://github.com/you-github-name/Firefly.git
   cd Firefly

2. Установить зависимости:

   # Установите pnpm, если еще не установлен
   npm install -g pnpm
   
   # Установить зависимости проекта
   pnpm install

3. Настроить блог:

   • Отредактируйте конфигурационные файлы в каталоге src/config/ для настройки блога

4. Запустить сервер разработки:

   pnpm dev

   Блог будет доступен по адресу http://localhost:4321

Развертывание на платформе хостинга

• См. официальное руководство для развертывания блога на Vercel, Netlify, Cloudflare Pages, EdgeOne Pages и т.д.

• Vercel, Netlify и другие популярные платформы поддерживают автоматическое развертывание и автоматически выбирают подходящий адаптер в зависимости от окружения.

  Пресет фреймворка: Astro

  Корневой каталог: ./

  Каталог вывода: dist

  Команда сборки: pnpm run build

  Команда установки: pnpm install

  

📖 Настройка

📚 Подробная документация по настройке: См. документацию Firefly для полного руководства по настройке

Установка языка сайта

Чтобы установить язык по умолчанию для вашего блога, отредактируйте файл src/config/siteConfig.ts:

// Определить язык сайта
const SITE_LANG = "zh_CN";

Поддерживаемые коды языков:

• zh_CN - Упрощенный китайский
• zh_TW - Традиционный китайский
• en - Английский
• ja - Японский
• ru - Русский

Структура конфигурационных файлов

src/
├── config/
│   ├── index.ts              # Индексный файл конфигурации
│   ├── siteConfig.ts         # Базовая конфигурация сайта
│   ├── backgroundWallpaper.ts # Конфигурация фоновых обоев
│   ├── profileConfig.ts      # Конфигурация профиля пользователя
│   ├── commentConfig.ts      # Конфигурация системы комментариев
│   ├── announcementConfig.ts # Конфигурация объявлений
│   ├── licenseConfig.ts      # Конфигурация лицензии
│   ├── footerConfig.ts       # Конфигурация подвала
│   ├── FooterConfig.html     # HTML-контент подвала
│   ├── expressiveCodeConfig.ts # Конфигурация подсветки кода
│   ├── sakuraConfig.ts       # Конфигурация эффекта сакуры
│   ├── fontConfig.ts         # Конфигурация шрифтов
│   ├── sidebarConfig.ts      # Конфигурация макета боковой панели
│   ├── navBarConfig.ts       # Конфигурация навигационной панели
│   ├── musicConfig.ts        # Конфигурация музыкального плеера
│   ├── pioConfig.ts          # Конфигурация маскота
│   ├── adConfig.ts           # Конфигурация рекламы
│   ├── friendsConfig.ts      # Конфигурация дружественных ссылок
│   ├── galleryConfig.ts      # Конфигурация галереи
│   ├── sponsorConfig.ts      # Конфигурация спонсоров
│   └── coverImageConfig.ts   # Конфигурация обложек статей

⚙️ Frontmatter статьи

---
title: My First Blog Post
published: 2023-09-09
description: This is the first post of my new Astro blog.
image: ./cover.jpg  # Или используйте "api" для включения случайных обложек
tags: [Foo, Bar]
category: Front-end
draft: false
lang: zh-CN      # Устанавливайте только если язык статьи отличается от языка сайта в `siteConfig.ts`
pinned: false    # Закрепить статью
comment: true    # Включить комментарии
---

📖 Расширения Markdown

Помимо поддержки GitHub Flavored Markdown по умолчанию в Astro, есть несколько дополнительных функций Markdown:

• Предупреждающие блоки (Admonitions) - Поддержка тем GitHub, Obsidian и VitePress (Предпросмотр и использование)
• Карточки репозиториев GitHub (Предпросмотр и использование)
• Улучшенные блоки кода на основе Expressive Code (Предпросмотр / Документация)

🧞 Команды

Все команды должны выполняться в корневом каталоге проекта:

Команда	Действие
pnpm install	Установить зависимости
pnpm dev	Запустить локальный сервер разработки на localhost:4321
pnpm build	Собрать сайт в ./dist/
pnpm preview	Локальный предварительный просмотр собранного сайта
pnpm check	Проверить код на наличие ошибок
pnpm format	Отформатировать код с помощью Biome
pnpm new-post <filename>	Создать новую статью
pnpm astro ...	Выполнить astro add, astro check и другие команды
pnpm astro --help	Показать справку Astro CLI

🙏 Благодарности

Особая благодарность saicaca за разработку шаблона fuwari, на котором Firefly основан для вторичной разработки.

Авторские права на изображения Firefly принадлежат компании miHoYo, разработчику игры "Honkai: Star Rail".

Технический стек

• Astro
• Tailwind CSS
• Iconify

Проекты вдохновения

• fuwari
• hexo-theme-shoka
• astro-koharu
• Mizuki

Другие ссылки

• Компонент страницы Bangumi Collection блогера 霞葉
• Q-версия Firefly Mascot Spine Model от создателя Bilibili 公公的日常

📝 Лицензия

Этот проект распространяется под лицензией MIT license, подробности см. в файле LICENSE.

Первоначально ветвлено из saicaca/fuwari. Благодарим автора оригинального проекта за вклад.

Уведомление об авторских правах:

• Copyright (c) 2024 saicaca - fuwari
• Copyright (c) 2025 CuteLeaf - Firefly

В соответствии с лицензией MIT вы можете свободно использовать, изменять и распространять код, но обязаны сохранять вышеуказанное уведомление об авторских правах.

🍀 Участники

Спасибо следующим участникам за их вклад в этот проект. Если у вас есть вопросы или предложения, пожалуйста, отправьте Issue или Pull Request.

Спасибо следующим участникам за их вклад в исходный проект fuwari, который заложил основу для этого проекта.

⭐ История звезд