Firefly 简单使用指南
Firefly 简单使用指南
722 字4 分钟
这篇指南介绍基于 Astro 的 Firefly 博客模板的简单使用方法，重点说明文章 Front-matter 的配置项，包括标题、发布日期、更新日期、置顶、描述、封面图片路径、标签、分类、语言、许可证、作者、来源链接、草稿、评论、slug、密码及密码提示等字段的含义。文章还说明文章文件应放在 src/content/posts/ 目录，可建子目录组织内容，并讲解自定义文章 URL 的 slug 用法、示例、命名建议及注意事项。适用于使用该模板撰写和整理博客文章的场景。
由 DeepSeek 生成 · 本文章版本使用已保存摘要
这个博客模板是基于 Astro 构建的。对于本指南中未提及的内容，您可以在 Astro 文档 中找到答案。
文章的 Front-matter
---title: 我的第一篇博客文章published: 2023-09-09description: 这是我新 Astro 博客的第一篇文章。image: ./cover.jpgtags: [前端, 开发]category: 前端开发draft: false---| 属性 | 描述 |
|---|---|
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/ 目录中。您也可以创建子目录来更好地组织您的文章和资源。
src/content/posts/├── post-1.md└── post-2/ ├── cover.png └── index.md自定义文章 URL (Slug)
什么是 Slug？
Slug 是文章 URL 路径的自定义部分。如果不设置 slug，系统将使用文件名作为 URL。
Slug 使用示例
示例 1：使用文件名作为 URL
---title: 我的第一篇博客文章published: 2023-09-09---文件：src/content/posts/my-first-blog-post.md
URL：/posts/my-first-blog-post
示例 2：自定义 Slug
---title: 我的第一篇博客文章published: 2023-09-09slug: hello-world---文件：src/content/posts/my-first-blog-post.md
URL：/posts/hello-world
示例 3：其他语言文件名使用Slug
---title: 如何使用 Firefly 博客主题published: 2023-09-09slug: how-to-use-firefly-blog-theme---文件：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 会自动转换为小写
评论区
评论加载中…