安装指令 - 小鱼钓猫🐱

🚀 快速开始#

环境要求#

Node.js ≥ 22
pnpm ≥ 9

本地开发部署#

克隆仓库：

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

先 Fork 到自己仓库在克隆（推荐），记得先点 Star 在 Fork 哦！

1
git clone https://github.com/yzg011/astro.git
2
cd astro

安装依赖：

1
# 如果没有安装 pnpm，先安装
2
npm install -g pnpm
3

4
# 安装项目依赖
5
pnpm install

配置博客：
- 编辑 src/config/ 目录下的配置文件自定义博客设置
启动开发服务器：
```
1
pnpm dev
```
博客将在 http://localhost:4321 可用

平台托管部署#

参考官方指南将博客部署至 Vercel, Netlify, Cloudflare Pages, EdgeOne Pages 等。
Vercel、Netlify 等主流平台自动部署，会根据环境自动选择适配器。

框架预设： Astro

根目录： ./

输出目录： dist

构建命令： pnpm run build

安装命令： pnpm install

Deploy with Vercel

Deploy to Netlify

📖 配置说明#

📚 详细配置文档: 查看 Firefly使用文档获取完整的配置指南

设置网站语言#

要设置博客的默认语言，请编辑 src/config/siteConfig.ts 文件：

1
// 定义站点语言
2
const SITE_LANG = "zh_CN";

支持的语言代码：

zh_CN - 简体中文
zh_TW - 繁体中文
en - 英文
ja - 日文
ru - 俄文

配置文件结构#

1
src/
2
├── config/
3
│   ├── index.ts              # 配置索引文件
4
│   ├── siteConfig.ts         # 站点基础配置
5
│   ├── backgroundWallpaper.ts # 背景壁纸配置
6
│   ├── profileConfig.ts      # 用户资料配置
7
│   ├── commentConfig.ts      # 评论系统配置
8
│   ├── announcementConfig.ts # 公告配置
9
│   ├── licenseConfig.ts      # 许可证配置
10
│   ├── footerConfig.ts       # 页脚配置
11
│   ├── FooterConfig.html     # 页脚HTML内容
12
│   ├── expressiveCodeConfig.ts # 代码高亮配置
13
│   ├── sakuraConfig.ts       # 樱花特效配置
14
│   ├── fontConfig.ts         # 字体配置
15
│   ├── sidebarConfig.ts      # 侧边栏布局配置
16
│   ├── navBarConfig.ts       # 导航栏配置
17
│   ├── musicConfig.ts        # 音乐播放器配置
18
│   ├── pioConfig.ts          # 看板娘配置
19
│   ├── adConfig.ts           # 广告配置
20
│   ├── friendsConfig.ts      # 友链配置
21
│   ├── galleryConfig.ts      # 相册配置
22
│   ├── sponsorConfig.ts      # 赞助配置
23
│   └── coverImageConfig.ts  # 文章封面图配置

⚙️ 文章 Frontmatter#

1
---
2
title: My First Blog Post
3
published: 2023-09-09
4
description: This is the first post of my new Astro blog.
5
image: ./cover.jpg  # 或使用 "api" 来启用随机封面图
6
tags: [Foo, Bar]
7
category: Front-end
8
draft: false
9
lang: zh-CN      # 仅当文章语言与 `siteConfig.ts` 中的网站语言不同时需要设置
10
pinned: false    # 置顶
11
comment: true    # 是否允许评论
12
---

🧩 Markdown 扩展语法#

除了 Astro 默认支持的 GitHub Flavored Markdown 之外，还包含了一些额外的 Markdown 功能：

提醒块（Admonitions） - 支持 GitHub, Obsidian, VitePress 三种风格主题配置 (预览和用法)
GitHub 仓库卡片 (预览和用法)
基于 Expressive Code 的增强代码块 (预览 / 文档)

🧞 指令#

下列指令均需要在项目根目录执行：

Command	Action
`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 帮助

音乐

音乐

🚀 快速开始#

环境要求#

本地开发部署#

平台托管部署#

📖 配置说明#

设置网站语言#

配置文件结构#

⚙️ 文章 Frontmatter#

🧩 Markdown 扩展语法#

🧞 指令#

支持与分享

评论区

音乐