当我们使用 Hugo 搭建博客的时候,一般都需要经过创作文章 -> 本地生成静态文件 -> Push 站点等多个步骤,如何高效一体化这个过程,让我们的精力主要集中在博客创作上?在借鉴前人的基础上,这里为大家整理下我个人的一个创作实践。
I. 前提条件
本文不涉及 Hugo 博客搭建,可参考如下搭建教程:
参考1 👉 Hugo 静态网站部署 | Mortal
参考2 👉 Hugo PaperMod 安装与配置 | Mortal
II. 相关应用
1.1 Obsidian
Obsidian 是一款免费非开源的 Markdown 创作工具,借助其丰富的插件市场,可一体完成从文章创作到部署的全过程。
1.2 相关插件
💡 Tips : 某些地区“社区插件市场”可能无法直接访问,请自行解决科学上网问题。
- 打开 Obsidian ⚙️(选项) -> 第三方插件 -> 关闭安全模式(首次安装需关闭) -> 社区插件市场,搜索并安装以下插件:
名称 | 用途 |
---|---|
QuickAdd | 使用自定义模板快速创建文章 |
Linter | 自动生成创建时间,自动更新编辑时间 |
Git | 在 Obsidian 中自动提交、拉取、推送并查看更改 |
- 安装插件后记得启用插件。
III. 一体化实践
参考1👉 Obsidian+github+clouflarepages的Hugo一体式发布流程 | Drifting Boats
参考2👉 把 Obsidian 变为 Hugo 博客的集成管理平台 | 胡说
3.1 创建 Posts 模板
在 Obsidian 仓库根目录创建一个“模板文件夹”,如:templates
,在模板文件夹下创建 2 个模板文件,参考如下:
文章模板:add_posts.md
1---
2title: {{name}}
3slug:
4url:
5categories:
6tags:
7draft: true
8date:
9lastmod:
10---
说说模板:add_moments.md
1---
2title: {{name}}
3slug:
4tags:
5date:
6lastmod:
7---
💡 Tips : 可按需增减
frontmatter
字段。
3.2 创建 QuickAdd 模版
3.2.1 添加模板
配置说明:
- 指定模板文件夹路径:与 3.1 节模板文夹路径一致。
- 输入模板名称。
- 添加至列表。
- 点亮闪电图标(启用模板)。
- 配置模板。
3.2.2 配置模板
3.2.2.1 模板 1
文章目录结构 1 :
1├── content/
2│ ├── posts/
3| ├── post1.md
4|
5| ...
6|
7| ├── post2.md
8| ├── _index.md
配置参考:
配置说明:
6. Template Path : 与 3.1 节模板文路径一致。
7. File Name Format : 启用✅
8. File Name : {{name}}
9. Create in folder : 启用✅
10. Choose Folder when creating a new note : 启用✅
其它项按需配置,在这样的配置下,使用名为 add post
模板,QuickAdd 将在你选择的目录下创建一个 {{name}}.md
文件,其中 {{name}}
为使用 QuickAdd 时输入的文件名。
3.2.2.2 模板 2
文章目录结构 2 :
1├── content/
2│ ├── posts/
3| ├── post1/
4| ├── index.md
5| ├── pic1.png
6| ├── pic2.jpg
7|
8| ...
9|
10| ├── post2/
11| ├── index.md
12| ├── _index.md
配置参考:
配置说明:
6. Template Path : 与 3.1 节模板文路径一致。
7. File Name Format : 启用✅
8. File Name : {{name}}/index
9. Create in folder : 启用✅
10. 输入文章存储路径,如:content/posts
11. 添加路径。
其它项按需配置,在这样的配置下,使用名为 add post
模板,QuickAdd 将在指定目录 content/posts/{{name}}
下创建 index.md
文件,其中 {{name}}
为使用 QuickAdd 时输入的文件名。
3.2.3 设置快捷键(可选)
添加 QuickAdd: Run QuickAdd 快捷键。
3.3 配置 Linter
3.3.1 基础配置
根据个人习惯,选择“保存时格式化文件”,或“文件修改时格式化文件”,或两者同时选择。
📢 注意:建议把“模板文件夹”加入忽略文件夹,这样在修改模板文件时就不会自动更新模板文件中的日期元数据。
3.3.2 时间戳配置
在 YAML 标签中,找到 “YAML 时间戳”并启用:
- 创建日期键名:date
- 修改日期键名:lastmod
- 格式:(删除默认值,留空)
3.4 新建 Posts
新建“文章”或“说说”,并修改相关的 frontmatter
信息。
3.5 配置 Git (可选)
根据需要配置 Git 自动提交、同步间隔、启动拉取等。
3.6 自动部署
Git 推送后,等待托管平台自动部署完成(前提:已完成相关平台自动部署配置)。