如何添加新笔记
概述
本指南将教你如何在猪京智库中添加新的博客文章或笔记。
文件位置
所有新的笔记应该放在 /root/blog/src/content/blog/ 目录下。
创建新文章
基本模板
创建一个新的 Markdown 文件，例如 my-note.md：
---
title: 文章标题
date: 2026-02-06
categories:
- 笔记 # 对应 categoryMap 里的键
tags:
- 标签1
- 标签2
description: 这篇笔记的简介
---
# 标题
正文内容...可用的分类
根据站点配置，当前支持以下分类（categoryMap 中的键）：
| 中文分类 | 英文标识 | 说明 |
|---|---|---|
| 随笔 | life | 生活随笔 |
| 笔记 | note | 学习笔记 |
| 工具 | tools | 工具分享 |
| 周刊 | weekly | 周期性刊物 |
| 前端 | front-end | 前端技术 |
| 数据分析 | data-analysis | 数据分析相关 |
| 因果推断 | causal-inference | 因果推断相关 |
注意事项：
categories中填写的是中文分类名称（如”笔记”、“前端”）- 系统会自动映射到英文标识（如
note、front-end） - 多个分类可以放在数组中，但通常一篇文档只属于一个主分类
Frontmatter 字段说明
必需字段
title: 文章标题（显示在列表页和详情页）date: 发布日期（格式：YYYY-MM-DD）
推荐字段
categories: 分类（使用中文分类名称）tags: 标签数组（可以添加多个标签）description: 文章简介（显示在列表页和 SEO）
可选字段
cover: 文章封面图片路径（如/img/cover/1.webp）slug: 自定义 URL（如不指定则使用文件名）highlightOnHome: 是否在首页高亮显示（默认true）
发布流程
- 创建文件：在
/root/blog/src/content/blog/目录下创建.md文件 - 编写内容：按照模板格式编写文章内容和 frontmatter
- 保存文件：保存 Markdown 文件
- 访问网站：刷新
http://148.135.34.81:18080即可看到新笔记
示例
示例 1：创建一篇学习笔记
文件名: /root/blog/src/content/blog/python-note.md
---
title: Python 学习笔记：列表推导式
date: 2026-02-06
categories:
- 笔记
tags:
- Python
- 编程基础
description: Python 列表推导式的使用方法和常见模式
---
# Python 学习笔记：列表推导式
列表推导式是 Python 中创建列表的简洁方式...
## 基本语法
```python
[expression for item in iterable]常见用法
…（正文内容）
### 示例 2：创建一篇工具分享
**文件名**: `/root/blog/src/content/blog/tool-share.md`
```markdown
---
title: VS Code 生产力插件推荐
date: 2026-02-06
categories:
- 工具
tags:
- VS Code
- 生产力
description: 提升编码效率的 VS Code 插件清单
---
# VS Code 生产力插件推荐
以下是我日常开发中必不可少的 VS Code 插件...
...（正文内容）注意事项
- 文件命名：建议使用英文、小写、连字符分隔（如
python-note.md） - 日期格式：必须使用
YYYY-MM-DD格式 - 分类匹配：确保
categories中的分类在categoryMap中有对应 - Markdown 语法：支持标准 Markdown 和一些扩展语法（如表格、代码块等）
相关文档
最后更新：2026-02-06