文章编号规则
设计原则
编号不绑定目录结构,支持文章在分类间迁移而不改变编号。采用日期 + 序号的灵活方案。
推荐格式(主要)
YYYYMMDD-NNYYYYMMDD:创建日期(如20240701)NN:当日序号(01-99),按创建时间递增
示例:20240701-01、20240701-02、20240715-01
备用格式
以下格式也可使用,只要全局唯一即可:
| 格式 | 示例 | 适用场景 |
|---|---|---|
| 日期 + 序号 | 20240701-01 | 推荐,日常文档 |
| 短标识 + 序号 | FLINK-01 | 特定项目文档 |
| 纯序号 | DOC-001 | 不想暴露日期信息 |
| 自由编号 | ARCH-OVERVIEW | 入口页、系列首页 |
唯一约束:articleId 在仓库内全局唯一,不重复即可。
编号规则
- 全局唯一:同一
articleId不会出现在两篇文档中 - 创建即分配:新建文档时分配编号
- 不绑定分类:文章迁移到其他目录时编号保持不变
- 编号不回收:删除或废弃的文档,编号保留
使用方式
在文档 Front Matter 中添加 articleId 字段:
yaml
---
title: Flink 架构原理
articleId: 20240701-01
category: bigdata
status: published
---编号索引
可通过编号快速定位文档:
| 编号 | 文档 | 分类 |
|---|---|---|
| 20240701-01 | Flink 架构原理 | bigdata |
| 20240701-02 | Flink Checkpoint 机制 | bigdata |
| 20240701-03 | Kubernetes 架构原理 | cloud-native |
| 20240701-04 | 系统设计方法论 | architecture |