PrimeEdge 主题教程

笔记

创建短内容笔记

笔记

笔记是 PrimeEdge 的轻量级内容类型,适合快速记录短内容、想法和片段。

特点

  • 简洁快速: 无需复杂 Front Matter
  • 轻量发布: 适合短内容、碎碎念
  • 时间线展示: 按时间倒序排列
  • 无目录: 页面更简洁

创建笔记

hugo new content notes/my-note.md

笔记 Front Matter

---
title: "笔记标题"
date: 2024-01-15T10:00:00+08:00
categories: ["技术笔记"]
tags: ["想法", "随笔"]
toc: false
---

笔记的 Front Matter 比文章更简洁:

字段必填说明
title笔记标题
date发布时间
categories分类(支持子分类目录)
tags标签
toc是否显示目录,默认 false
draft草稿状态

与文章的区别

特性笔记文章
长度短内容长文
目录
封面图
评论可选默认开启
摘要全文自动生成
布局紧凑完整

适用场景

  • 日常想法记录
  • 技术片段备忘
  • 阅读摘抄
  • 待办事项
  • 灵感记录
  • 生活随笔

笔记模板

创建 archetypes/notes.md

---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: false
tags: []
---

笔记列表页

笔记列表页自动按时间倒序展示所有笔记。

创建列表页

创建 content/notes/_index.md

---
title: "笔记"
description: "随想随记,记录点滴"
---

笔记写作建议

  1. 保持简短: 笔记适合 500 字以内的内容
  2. 及时记录: 有想法立即记录,不要拖延
  3. 添加标签: 方便后续检索和分类
  4. 定期整理: 将成熟的笔记扩展为文章

示例笔记

---
title: "Hugo 常用命令备忘"
date: 2024-01-15T10:00:00+08:00
tags: ["hugo", "备忘"]
---

常用 Hugo 命令:

```bash
# 新建站点
hugo new site myblog

# 新建文章
hugo new content posts/hello.md

# 本地预览
hugo server -D

# 构建
hugo --minify

记得加上 -D 参数才能预览草稿。


## 笔记归档

笔记支持按分类子目录组织:

content/notes/
├── _index.md
├── 技术笔记/
│ ├── _index.md
│ └── note-1.md
├── 学习记录/
│ ├── _index.md
│ └── note-2.md
└── 随手记/
├── _index.md
└── note-3.md


每个子目录需要一个 `_index.md` 文件:

```yaml
---
title: "技术笔记"
---

后台管理

如果部署了 PrimeEdge Admin,可以在后台管理笔记:

  • 表格列表展示(标题、日期、分类)
  • 支持分类筛选和关键词搜索
  • Markdown 编辑器 + 实时预览
  • 可选择发布时间、分类、目录开关

详见 后台管理教程

从笔记到文章

当笔记内容逐渐丰富,可以扩展为正式文章:

  1. 复制笔记内容到 posts/ 目录
  2. 完善 Front Matter(添加 description、cover 等)
  3. 扩展内容,添加更多细节
  4. 添加目录结构
  5. 发布文章后,可以保留或删除原笔记

下一步

评论

0%