Skip to content

文章编号规则

设计原则

编号不绑定目录结构,支持文章在分类间迁移而不改变编号。采用日期 + 序号的灵活方案。

推荐格式(主要)

YYYYMMDD-NN
  • YYYYMMDD:创建日期(如 20240701
  • NN:当日序号(01-99),按创建时间递增

示例20240701-0120240701-0220240715-01

备用格式

以下格式也可使用,只要全局唯一即可:

格式示例适用场景
日期 + 序号20240701-01推荐,日常文档
短标识 + 序号FLINK-01特定项目文档
纯序号DOC-001不想暴露日期信息
自由编号ARCH-OVERVIEW入口页、系列首页

唯一约束articleId 在仓库内全局唯一,不重复即可。

编号规则

  1. 全局唯一:同一 articleId 不会出现在两篇文档中
  2. 创建即分配:新建文档时分配编号
  3. 不绑定分类:文章迁移到其他目录时编号保持不变
  4. 编号不回收:删除或废弃的文档,编号保留

使用方式

在文档 Front Matter 中添加 articleId 字段:

yaml
---
title: Flink 架构原理
articleId: 20240701-01
category: bigdata
status: published
---

编号索引

可通过编号快速定位文档:

编号文档分类
20240701-01Flink 架构原理bigdata
20240701-02Flink Checkpoint 机制bigdata
20240701-03Kubernetes 架构原理cloud-native
20240701-04系统设计方法论architecture

基于 VitePress 构建