写自己的博客

命令行

确保已经执行 npm link。然后执行命令 haku，会显示如下的输出。

🌸 Haku Theme CLI
 
Usage:
  haku create     create a new blog article
  haku dev        start local dev server
  haku build      build the site for production
  haku preview    preview the production build locally
  haku deploy     deploy to remote repository
  haku update     update theme from upstream repository
  haku help       show this help message

help 是展示帮助信息，其他指令下面会讲解。update 指令请前往部署指南#更新主题

README 页面

默认首页会展示一个简短的 README。

在 src/content/main_page/index.md 修改 README。

创建新文章

haku create

它会使用问答来创建页面，一共两个问题。

? What is the article title? »
? What is the permalink? »

回答这两个问题即可，最终会在 src/content/articles 生成一个新的 markdown 文件，文件名就是第一个问题的回答。

打开文件，会找到这样的 YAML Front Matter。

title: "写自己的博客"
published: 2026-02-28
tags:
  - "Note"
draft: false
permalink: "write-blog"
description: ""
pin: 0

• title：文章标题。会在网站中作为博客的标题。
• published：发表日期。自动生成，除非要修改日期，否则不要动。
• tags：标签。需要保证严格的缩进。
• draft：是否是草稿，默认为 false。如果是草稿，只会在使用 haku dev 时展示，部署到网站时并不会展示。
• permalink：网站的 URL。比如这篇文章的 permalink 填写的是 write-blog，最终展示就会在 https://haku.karlbaey.top/articles/write-blog。
• description：文章简介。不填写则截取文章前五十字。
• pin：置顶优先级。数字越大，置顶优先级越高，最大为 99，最小为 0，为 0 时不置顶。

预览

两种途径。默认预览在 localhost:4321。

dev 服务器

haku dev

这样会展示所有的文章，包括草稿。

build 编译

haku build
haku preview

注意！ 需要等到输出 ✅ Build complete! 再执行 haku preview。

这样展示的效果与最终部署相同。

部署

使用 git。

git add .
git commit -m "填写在这里做了些什么"
haku deploy

然后等待，就能在你的 Netlify 网站上看到了！

分享

评论区