Test Paper1

Sun, 04 Oct 2026 22:11:17 +0800

这是第一篇测试博客

从这里开始

Sun, 04 Oct 2026 00:00:00 +0000

这是一篇示例文章，用来验证站点能正常构建。你可以删掉它，也可以直接改成自己的第一篇。

右侧栏那个随滚动高亮的分层目录，就是由下面这些标题自动生成的。

一、每篇文章顶部的元信息

开头两个 --- 之间的部分叫 front matter：

字段	作用
`title`	文章标题
`description`	列表页和搜索引擎显示的摘要
`date`	发布时间。不要填未来时间
`tags` / `categories`	标签与分类，会自动生成对应页面
`draft`	`true` 表示草稿，只有预览时可见
`comments`	是否允许评论（需先在配置里开启 giscus）
`image`	封面图，放在同目录下写文件名即可

目录是怎么来的

Hugo 会自动抓取正文里 ## 到 #### 的标题，生成层级目录：

## 一级标题
### 二级标题，会缩进嵌在上一级里面
#### 三级标题，再嵌一层

右侧栏的目录会跟随页面滚动自动高亮当前所在的小节，就是 Word 导航窗格那种感觉。

二、正文语法

代码块

带语言标记会自动高亮，右上角有复制按钮：

export function greet(name) {
 return `你好，${name}`;
}

图片

把图片放进 static/images/，然后这样引用：

![图片说明](/images/example.png)

提示框

主题内置了五种提示框，用引用块加标记即可：

📝 备注

这是一条备注。

💡 提示

这是一条提示。

⚠️ 警告

这是一条警告。

表格与清单

上面已经演示过表格。清单：

无序清单
支持嵌套
- 像这样

有序清单
第二项

第四级标题也会进目录

目录默认抓到第四级（####），所以更细的小节也能被定位到。你看到的这个「第四级标题也会进目录」就是第三层级的条目。

三、两种可见性

这是本站和普通博客最大的不同 —— 文章有两种状态：

状态	放哪个目录	谁能看到
公开	`content/post/`	所有人、搜索引擎
私密	`content-private/post/`	只有你（或被你在 Cloudflare 里授权的邮箱）

两种文章都写 Markdown，写法完全一样，区别只在放哪个目录。

为什么用两个目录而不是一个开关？ 因为公开站构建时使用的 content/ 目录里根本不存在私密文件 —— 不存在"忘了过滤结果泄露"的可能。这比用 draft 标记或者模板判断要可靠得多。

私密文章需要单独构建、单独部署，详见 DEPLOY.md。

四、日常流程

双击 新文章.bat（私密文章用 新私密文章.bat），输入英文文件名
用编辑器打开生成的文件开始写
双击 预览.bat 在浏览器里看效果，改字自动刷新
满意后把 draft 改成 false
双击 构建.bat，把生成的 public/ 上传到 Cloudflare Pages

就这样。没有数据库、没有后台、没有登录，写完就是几个 Markdown 文件。

首页 on XW的博客