Firefly 简单使用指南

Fri, 02 Jan 1970 00:00:00 GMT

这个博客模板是基于 Astro 构建的。对于本指南中未提及的内容，您可以在 Astro 文档中找到答案。

文章的 Front-matter#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
description: 这是我新 Astro 博客的第一篇文章。
5
image: ./cover.jpg
6
tags: [前端, 开发]
7
category: 前端开发
8
draft: false
9
---

属性	描述
`title`	文章标题。
`published`	文章发布日期。
`updated`	文章更新日期。如果未设置，将默认使用发布日期。
`pinned`	是否将此文章置顶在文章列表顶部。
`description`	文章的简短描述。显示在首页上。
`image`	文章封面图片路径。 1. 以 `http://` 或 `https://` 开头：使用网络图片 2. 以 `/` 开头：`public` 目录中的图片 3. 不带任何前缀：相对于 markdown 文件的路径
`tags`	文章标签。
`category`	文章分类。
`lang`	文章语言代码（如 `zh-CN`）。仅当文章语言与站点默认语言不同时设置。
`licenseName`	文章内容的许可证名称。
`licenseUrl`	文章内容的许可证链接。
`author`	文章作者。
`sourceLink`	文章内容的来源链接或参考。
`draft`	如果这篇文章仍是草稿，则不会显示。
`comment`	是否启用此文章的评论功能。默认为 `true`。
`slug`	自定义文章 URL 路径。如果不设置，将使用文件名作为 URL。
`password`	文章密码。设置后文章内容将被 AES-256-GCM 加密，访客需输入密码才能查看。
`passwordHint`	密码提示。显示在密码输入框上方，帮助访客回忆密码，也可以不加。

文章文件的放置位置#

您的文章文件应放置在 src/content/posts/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。

1
src/content/posts/
2
├── post-1.md
3
└── post-2/
4
    ├── cover.png
5
    └── index.md

自定义文章 URL (Slug)#

什么是 Slug？#

Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。

Slug 使用示例#

示例 1：使用文件名作为 URL#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/my-first-blog-post

示例 2：自定义 Slug#

1
---
2
title: 我的第一篇博客文章
3
published: 2023-09-09
4
slug: hello-world
5
---

文件：src/content/posts/my-first-blog-post.md

URL：/posts/hello-world

示例 3：其他语言文件名使用Slug#

1
---
2
title: 如何使用 Firefly 博客主题
3
published: 2023-09-09
4
slug: how-to-use-firefly-blog-theme
5
---

文件：src/content/posts/如何使用Firefly博客主题.md

URL：/posts/how-to-use-firefly-blog-theme

Slug 使用建议#

使用英文和连字符：my-awesome-post 而不是 my awesome post
保持简洁：避免过长的 slug
具有描述性：让 URL 能够反映文章内容
避免特殊字符：只使用字母、数字和连字符
保持一致性：在整个博客中使用相似的命名模式

注意事项#

Slug 一旦设置并发布，建议不要随意更改，以免影响 SEO 和已存在的链接
如果多个文章使用相同的 slug，后面的文章会覆盖前面的
Slug 会自动转换为小写

关于“我”

Tue, 16 Jun 2026 00:00:00 GMT

这是一个介绍我自己的文章，也是一个测试文章；如果你能在网页上看到这篇文章，也就证明此博客的功能走向正常了。

突然有点不知道些什么好，自己即将走向成年，无论线上线下也认识了不少的人。想在一篇文章中写完又关我的全部，未免有点天方夜谭了。

既然如此，就从现状说起吧。

0.写在前面#

如果你在线上比较了解我（其实只要看到了这个博客就可以知道），我显然是一个流萤厨。

也因此，你能看到我所有和技术有关的工作大多数以流萤为动力展开。例如这个服务器，一开始（包括现在也是）就是为了运行QQbot而诞生的。

目前的技术栈主要集中在后端（python），但是就像你所看到的博客一样；目前正在一边用一边学Node.js，主要是用来构建前端。

1.个人项目#

1开始就写个人项目，是不是有点过于心急了？（但是好像没什么好说的啊？）

用户输入管理插件一个好用（自认为）并且我一直在用的AstrBot插件，主要用于输入审核，解决了很多传统审核的痛点，也是我个人开发走向成熟的标志。
bilibili直播适配器也是一个AstrBot插件，可以让bot介入bilibili直播，开发中…
AstrBot虽然不是我自己的项目，但是以上两个项目都依赖这个运行，本人也是众多贡献者之一。

话说回来，我的鬼点子很多，但是真正能落地的少之又少，以上项目只是能拿出手的，其他有意思但是不好意思拿出手的可以去github主页查看，我自己就不献丑了。

2.？？？#

作为一个测试文章，写到这里就够了，以后想到什么再补充吧。