柒迹

这个站怎么用

2026-11-12

这个站不住在任何服务器上,它就是这台电脑里的一个文件夹。你看到的网页,是拿文件夹里的东西生成出来的。

三步更新

第一步,写内容。 文章都是 content 目录里的纯文本文件,用 Markdown 写。新建一个文件,开头先写这几行:

---
title: 文章标题
date: 2026-11-12
slug: my-post
desc: 一句话摘要,会显示在列表里
---

三个横线中间叫「头信息」,它告诉程序这叫什么、什么时候发的。slug 是网址里用的英文短名,随便起,别重复。

头信息下面就是正文。常用的写法只有几个:

  • ## 二级标题 出一个大标题
  • - 开头 是圆点列表
  • **两边两个星号** 是加粗
  • [文字](https://某个网址) 是链接
  • ![说明](图片地址) 是插图

第二步,放图片和文件。

  • 图片放进 assets/img,会自动出现在「图片」页
  • 资料(PDF、压缩包、Word)放进 assets/files,会自动出现在「资料」页

第三步,生成。

在 个人网站 这个文件夹里运行一句命令:

node build.mjs

它会把所有内容吐进 site 文件夹。双击 site\index.html 就能在自己电脑上先看效果,不用联网。

确认没问题了,再把 site 文件夹整个拖到发布页面的上传区。网站就更新了,几十秒的事。

几条经验

  • 每次改完都要重新运行 node build.mjs,否则网站还是旧的
  • 文件名建议用日期开头,比如 2026-11-12-标题.md,这样排序自然就对了
  • 想撤掉某篇文章,把 draft 写成 true,它就不出现在网站上了,文件还留着
  • 中文文件名没问题,但 slug 建议用英文,网址会干净一些