一个博客的起点,可以是一篇简单的 Markdown 文章。Hugo 负责把文字生成网页,PaperMod 提供简洁的页面样式,让写作和发布都更轻松。

为什么使用静态博客

静态博客会在构建时生成 HTML、CSS 等文件,访问时直接由服务器提供这些文件。对于以文字为主的个人博客,这种方式有几个实用的优点:

  • 页面结构简单,加载速度快。
  • 文章以 Markdown 文件保存,便于迁移和备份。
  • 可以通过 Git 记录每次修改。
  • 部署平台可以在代码更新后自动构建网站。

创建一篇文章

在博客目录中执行:

hugo new content posts/my-next-post.md

新文章开头的配置用于设置标题、日期和发布状态。添加 categories: ["技术"],文章就会出现在技术分类中;添加标签,则可以进一步标记文章的主题。

默认生成的文章是草稿。写完后,把 draft: true 改为 draft: false,并确认文章日期没有设在未来,正式构建时才会收录。

在本地预览

hugo server -D

打开终端提示的本地地址,就能查看效果。保存文章后,预览页面会自动刷新。这里的 -D 表示同时显示草稿,方便检查尚未发布的内容。

发布前也可以运行一次普通构建:

hugo

这次构建默认不包含草稿,更接近正式网站的结果。

让内容慢慢积累

先记录一个解决过的问题、一条学习笔记,或一次值得复盘的经历。文章不必很长,把背景、过程和结论写清楚,就能为以后的自己留下一份有用的参考。