📖 README: 简体中文
⚡ 静态站点生成:基于 Astro 的超快加载速度和 SEO 优化
🎨 现代化设计:简洁美观的界面,支持自定义主题色
📱 移动友好:完美的响应式体验,移动端专项优化
🔧 高度可配置:大部分功能模块均可通过配置文件自定义
Cyrene 由 Firefly 开发而来,在核心功能层面,两者保持高度一致,确保您能获得同样成熟、完善的博客体验,故不在此重复列举。(对比Firefly更改看板娘模型和新增一个音乐播放器现为双音乐播放器)
您可查阅 Firefly 仓库 了解详细特性(仅为参考)。
- 更换看板娘模型
- 更多功能持续完善中...
如果你有好用的功能和优化,请提交 Pull Request
- Node.js >= 20
- pnpm >= 8
- 克隆仓库:
git clone https://github.com/qwc-ch/Cyrene.git
cd Cyrene先 Fork 到自己仓库再克隆(推荐,想把博客布署到github的话要把仓库名改为"用户名.github.io")
git clone https://github.com/you-github-name/Cyrene.git
cd Cyrene- 安装依赖:
# 如果没有安装 pnpm,先安装
npm install -g pnpm
# 安装项目依赖
pnpm install- 配置博客:
- 编辑
src/config/目录下的配置文件自定义博客设置
- 启动开发服务器:
pnpm dev博客将在 http://localhost:4321 可用
- 参考官方指南将博客部署至 Vercel, Netlify, GitHub Pages, Cloudflare Pages, EdgeOne Pages 等。
框架预设:
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# 站点基础配置
│├── 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# 友链配置
│├── sponsorConfig.ts # 赞助配置
│└── coverImageConfig.ts # 文章封面图配置
---
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` 中的网站语言不同时需要设置
---| Command | Action |
|---|---|
pnpm install |
安装项目依赖 |
pnpm add sharp |
安装 Sharp 图像处理库(用于图片优化) |
pnpm dev |
在 localhost:4321 启动本地开发服务器 |
pnpm build |
构建网站至 ./dist/ 目录 |
pnpm preview |
本地预览已构建的网站 |
pnpm new-post <filename> |
创建一篇新文章 |
pnpm astro ... |
执行 astro add, astro check 等 Astro 指令 |
pnpm astro --help |
显示 Astro CLI 帮助信息 |
- 非常感谢 CuteLeaf 开发的 Firefly 模板,Cyrene 就是基于这个模板二次开发
- 同时也感谢 saicaca 开发了 Fuwari 模板,为后续许多优秀项目奠定了坚实基础。
- 感谢 matsuzaka-yuki 模板,Cyrene 用了此项目的音乐播放器
- 图标来自 Iconify
- 昔涟部分相关图片素材版权归游戏 《崩坏:星穹铁道》 开发商 米哈游 所有
本项目遵循 MIT license 开源协议,详细查看 LICENSE 文件, 最初 Fork 自 CuteLeaf,感谢原作者的贡献,原项目采用 MIT license。
