让 Markdown 负责内容
为这个小站整理内容时,选择了按文件保存文章的方式。每篇记录独立放在内容目录里,文件名也就是文章地址的一部分。
一篇记录的组成
文件开头是少量信息,后面是普通 Markdown 正文。标题和日期交给页面模板显示,正文从段落或二级标题开始写即可。
title: 一次小调整
description: 用一两句话介绍这次调整。
date: 2026-11-08
description 用作文章页面的描述信息。文章列表只列出标题,具体内容在打开文章后再显示。
写好再发布
暂时没有完成的文字可以标记为草稿。构建时会过滤草稿,既不放进首页列表,也不生成可以访问的文章页面。
文件名尽量在发布前确定。后续修改标题不会改变地址,但修改文件名会产生一个新地址,因此尽量保持已经发布的文件名不变。
够用的目录结构
当前所有记录放在同一个目录里,文章列表按日期排序,最多展示五篇。文章数量较少时,这样就足够了,暂时没有增加分类和标签页面。