Fuwari 写作指南 - 曦の休息处

622 字

3 分钟

Fuwari 写作指南

2024-04-01

Blog

Fuwari

封面图片来源：Source

本站基于 Astro 和 Fuwari 模板搭建。日常写文章时，主要需要关心文章文件放在哪里、frontmatter 怎么写，以及图片和草稿如何处理。

文章放在哪里#

所有文章都放在 src/content/posts/ 目录下。可以直接放一个 Markdown 文件，也可以为一篇文章建一个单独文件夹，用来存放封面和正文中引用的图片。

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

推荐给图片较多的文章单独建文件夹，例如 my-note/index.md 搭配 my-note/cover.png、my-note/example.png。这样迁移文章时不容易丢资源。

Frontmatter#

每篇文章开头都需要一段 frontmatter，用 --- 包起来。它决定文章标题、发布时间、封面、标签、分类等元信息。

1
---
2
title: 我的第一篇文章
3
published: 2024-04-01
4
description: 这是一段会显示在文章列表里的简短介绍。
5
image: ./cover.jpg
6
tags: [Markdown, Fuwari]
7
category: Blog
8
draft: false
9
series: "Fuwari官方文档"
10
---

字段	作用
`title`	文章标题，会显示在文章页和文章列表中。
`published`	发布时间，推荐使用 `YYYY-MM-DD`。
`updated`	可选，更新时间。文章更新后可以加上这个字段。
`description`	文章简介，会显示在首页、归档或分享预览中。
`image`	文章封面。可以是网络图片、`public` 目录下的绝对路径，或相对当前 Markdown 文件的路径。
`tags`	标签列表，用来描述文章主题。
`category`	文章分类，通常写一个主分类即可。
`draft`	是否为草稿。设为 `true` 后不会在正式构建中显示。
`series`	可选，文章所属系列。相同系列的文章会被归到一起。

图片路径#

image 和正文里的图片都支持几种写法。

1
image: https://example.com/cover.jpg
2
image: /images/cover.jpg
3
image: ./cover.jpg

写法	含义
`https://example.com/cover.jpg`	使用网络图片。
`/images/cover.jpg`	使用 `public/images/cover.jpg`。
`./cover.jpg`	使用当前 Markdown 文件旁边的图片。

正文中引用本地图片时，也推荐使用相对路径。