一个博客的起点,可以是一篇简单的 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
这次构建默认不包含草稿,更接近正式网站的结果。
让内容慢慢积累
先记录一个解决过的问题、一条学习笔记,或一次值得复盘的经历。文章不必很长,把背景、过程和结论写清楚,就能为以后的自己留下一份有用的参考。