zhouzhongping/wiki
1
0
Fork 0
Code

项目：Wiki 管理规范

Browse Source
This commit is contained in:
周中平 2024-10-12 17:55:58 +08:00
parent 2a94570e9e
commit 65f753dfb4
Signed by: zhouzhongping
GPG Key ID: 6666822800008000
1 changed files with 76 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

189
Obsidian/References/Wiki 管理规范.md
View File

@ -1,23 +1,28 @@
---
title: Wiki 管理规范
description: 描述
description: Wiki管理规范文档提供了知识库的目录结构、排序规则、标签系统、知识管理方法论、Graph View应用、插件自动化支持和审计维护策略。文档强调了简洁有序的目录结构、清晰的排序规则、有效的标签管理、Zettelkasten方法的应用、Graph View的优化使用、插件的高效利用以及定期审计和维护的重要性。
keywords:
- 关键字
- Wiki管理规范
- 目录结构
- 排序规则
- 标签系统
- 插件自动化
- 审计维护
tags:
- 标签
- Obsidian/References
author: 仲平
date: 2024-10-12
---
### Wiki 管理规范
## Wiki 管理规范
### 一、目录结构
## 一、目录结构
目录结构必须既简洁有序，又具备灵活性，能够应对不同领域和交叉领域的知识需求。
#### 1. 一级目录
### 1. 一级目录
**一级目录代表知识库的最顶层分类，主要按照领域或知识类型进行划分。**以下是一级目录的基本分类和命名规则：
**一级目录代表知识库的最顶层分类，主要按照领域或知识类型进行划分。** 以下是一级目录的基本分类和命名规则：
- **目录数量**：控制在 7 个顶层目录，确保结构不复杂，同时覆盖全面。
- **命名原则**：使用简洁、通用的领域名称，避免使用过于细分的概念。
@ -33,21 +38,21 @@ date: 2024-10-12
| Professional | 职业发展 | 工作技能、项目、公司信息 |
| SocialSciences | 社会科学 | 经济学、社会学、政治学等 |
#### 2. 二级目录
### 2. 二级目录
**二级目录是一级目录下的进一步细分，按领域或主题对知识库进行更具体的分类。**每个二级目录要确保与一级目录的逻辑一致，并对内容进行合理组织。
**二级目录是一级目录下的进一步细分，按领域或主题对知识库进行更具体的分类。** 每个二级目录要确保与一级目录的逻辑一致，并对内容进行合理组织。
- **命名规则**：应为一级领域内的核心分支，使用学科或主题名称，不要过于细致。
- **层次数量**：二级目录数量不宜过多，一般每个一级目录下不超过 10 个二级目录。
- **分类依据**：根据领域中的主要内容或核心学科进行分类。
##### Archive
#### Archive
| 文件名 | 领域 | 备注 |
| ------ | -------- | ---------- |
| 2023 | 全部领域 | 归档的年份 |
##### FormalSciences
#### FormalSciences
| 文件名 | 领域 | 备注 |
| ----------------- | ---------- | ---------------------------- |
@ -57,7 +62,7 @@ date: 2024-10-12
| Mathematics | 数学 | 代数、几何、数学基础等 |
| Statistics | 统计学 | 数据分析、概率论、推断统计等 |
##### NaturalSciences
#### NaturalSciences
| 文件名 | 领域 | 备注 |
| --------- | ------ | ------------------------ |
@ -67,16 +72,16 @@ date: 2024-10-12
| Geology | 地质学 | 地球结构、矿物等研究 |
| Physics | 物理学 | 力学、电磁学、量子物理等 |
##### Obsidian
#### Obsidian
| 文件名 | 领域 | 备注 |
| ---------- | ---------- | ------------------------ |
| Canvas | Canvas文件 | Obsidian Canvas 工作文件 |
| Canvas | Canvas 文件 | Obsidian Canvas 工作文件 |
| References | 参考文档 | 管理规范、系统说明等 |
| Static | 静态资源 | JS文件、静态数据等 |
| Static | 静态资源 | JS 文件、静态数据等 |
| Templates | 模板 | 博客、日志、项目等模板 |
##### Personal
#### Personal
| 文件名 | 领域 | 备注 |
| ----------- | ---- | ------------------------ |
@ -88,7 +93,7 @@ date: 2024-10-12
| Photography | 摄影 | 摄影项目与技术笔记 |
| Writing | 写作 | 散文、小说创作等 |
##### Professional
#### Professional
| 文件名 | 领域 | 备注 |
| -------------- | -------- | ------------------------ |
@ -99,7 +104,7 @@ date: 2024-10-12
| Skills | 职业技能 | 领导力、沟通、项目管理等 |
| Work | 专业技能 | 工作专业技能等 |
##### SocialSciences
#### SocialSciences
| 文件名 | 领域 | 备注 |
| ---------------------- | -------- | ---------------------- |
@ -113,28 +118,28 @@ date: 2024-10-12
| Politics | 政治学 | 国际政治、国际关系等 |
| Sociology | 社会学 | 社会理论、人类学等 |
#### 3. 三级目录
### 3. 三级目录
**三级目录进一步细分具体的知识点或领域，通常与实际的学习内容、项目细节或子主题相关。**在三级目录层次，应确保分类简洁，避免过度细分。
**三级目录进一步细分具体的知识点或领域，通常与实际的学习内容、项目细节或子主题相关。** 在三级目录层次，应确保分类简洁，避免过度细分。
- **命名规则**：使用具体的知识点、技术名称或项目名称进行分类。
- **避免过度细分**：三级目录的层次应适度控制，**不宜再深入建立四级或五级目录**，尽量在三级目录中整理好内容。
- **分类依据**：根据具体的知识点、课程章节、项目阶段等进行划分。
### 二、排序规则
## 二、排序规则
为了确保知识库内的内容顺序一致性、逻辑清晰，制定以下文件和文件夹的排序规则。该规则涵盖了数字化排序、时间排序以及特定场景下的分类方法，确保无论是中文、英文还是时间敏感型笔记都能被准确检索。
#### 1. **数字化排序**
### 1. **数字化排序**
数字化排序通过 **数字前缀法** 和 **日期前缀法** 来确保文件夹和文件按预期顺序排列，避免因中文和英文混排引起的排序问题。
##### 文件夹排序
#### 文件夹排序
- **英文文件夹**：默认按 A-Z(a-z) 排序。
- **中文文件夹**：为了避免混乱，中文文件夹必须加上数字前缀，例如 `01-日记`，`02-博客`。
##### 文件排序
#### 文件排序
- **时间排序**：时间敏感的文件（如日志、日记、项目文档）使用 `YYYY-MM-DD` 的日期前缀，确保文件按时间顺序排列。
@ -148,28 +153,28 @@ date: 2024-10-12
- `01-2024-项目需求分析.md`。这种方法确保任务按优先级或时间顺序排列。
```
#### 2. **日期前缀法**
### 2. **日期前缀法**
日期前缀法适用于日记、日志、项目记录等需要按时间顺序管理的内容。此方法帮助你快速找到某一特定日期的笔记。
- 日期格式：使用 `YYYY-MM-DD`格式，具体到年、月、日。例如：
- 日期格式：使用 `YYYY-MM-DD` 格式，具体到年、月、日。例如：
```markdown
- 日记文件：`2024-01-01-新年计划.md`
- 项目文件：`2024-03-15-项目设计讨论.md`
```
- 按月或年排列：如果只需要按月份或年份排列，可以简化为 `YYYY-MM` 或 `YYYY`格式。
- 按月或年排列：如果只需要按月份或年份排列，可以简化为 `YYYY-MM` 或 `YYYY` 格式。
```markdown
- `2024-01-总结报告.md` 表示 2024 年 1 月的总结。
```
#### 3. **数字前缀法**
### 3. **数字前缀法**
数字前缀法适用于需要按逻辑顺序排列的文件或文件夹，特别是在任务、项目、章节等情境下。数字前缀确保无论文件名中使用什么语言，都能按照预期顺序展示。
- 格式：`XX-文件名`，`XX`为两位数字，确保从 `01`到 `99`之间的顺序排列。
- 格式：`XX-文件名`，`XX` 为两位数字，确保从 `01` 到 `99` 之间的顺序排列。
```
- `01-项目启动.md`
@ -177,14 +182,14 @@ date: 2024-10-12
- `03-开发计划.md`
```
#### 4. **自定义前缀法**
### 4. **自定义前缀法**
针对非时间、任务类文件，可以根据内容特点设计自定义前缀，确保分类逻辑明确。例如：
- **书籍笔记**：`书名-章节编号-章节标题` 格式，例如 `经济学原理-01-需求与供给.md`，便于根据章节顺序查阅。
- **项目文档**：`项目名-任务编号-任务标题`，如 `Nginx-02-系统设计.md`。
#### 5. **排序示例**
### 5. **排序示例**
```markdown
Professional
@ -197,7 +202,7 @@ Professional
│ └── 03-2024-测试报告.md
```
#### 6. **特殊情况说明**
### 6. **特殊情况说明**
- **多层级文件夹**：对于多层级文件夹，建议每层级文件夹均使用数字前缀法进行排序，确保整体层级顺序一致。
@ -213,9 +218,9 @@ Professional
- **项目文件**：对于复杂项目中的文档，可以根据任务和时间结合进行排序，以便清晰了解项目进展情况。
### 三、标签系统
## 三、标签系统
#### 1. **标签命名规范**
### 1. **标签命名规范**
标签是知识管理中的多维度检索工具，继续保留 **二级标签系统**，同时引入 **标签管理策略**，以避免标签的混乱或冗余。
@ -231,54 +236,54 @@ Professional
| 文献标签 | `#文献/书籍`, `#文献/论文` | 用于标记笔记引用的文献类型，如书籍、论文等。 |
| 工具标签 | `#工具/Obsidian`, `#工具/Notion` | 表示使用的工具，适用于记录与工具相关的工作流程。 |
#### 2. **标签管理策略**
### 2. **标签管理策略**
为保持标签系统的整洁性，建议每季度进行一次标签审查，清理或合并冗余标签，并确保标签的创建和命名符合规范。
为了保持标签系统的整洁和高效，建议每季度进行一次标签审查，清理或合并冗余标签，确保标签的创建和命名符合规范。
##### 2.1 标签创建流程
#### 2.1 标签创建流程
1. **优先使用现有标签**：创建新标签时，先检查是否已有类似标签，避免重复和相似标签。
2. **保持命名统一**：使用一致的命名格式，避免多种形式表达相同含义（如 `#状态/草稿` 与 `#状态/初稿`）。
3. **层次化设计**：使用二级标签系统，确保标签层次清晰，如 `#领域/技术`、`#状态/草稿`。
##### 2.2 标签审查与维护
#### 2.2 标签审查与维护
1. **定期审查**：每季度使用 `Dataview` 插件生成标签使用报告，查看标签使用频率，识别不常用或冗余标签。
2. **清理与合并**：合并重复或类似功能的标签，删除不必要的低频标签。
3. **建立参考文档**：记录现有标签及其用途，供用户参考，避免重复创建。
##### 2.3 标签优化策略
#### 2.3 标签优化策略
1. **跨项目统一**：一些常用标签（如状态、时间）可跨项目使用，避免重复创建类似标签。
2. **持续优化**：随着知识库的扩展，定期评估并调整标签结构，增加必要的新标签，确保系统灵活扩展。
##### 3. 标签应用示例
#### 3. 标签应用示例
```markdown
tags:
- #领域/技术
- #状态/完善中
- #项目/网站重构
- #时间/2024年
- #类型/技术文档
- 领域/技术
- 状态/完善中
- 项目/网站重构
- 时间/2024年
- 类型/技术文档
```
### 四、知识管理方法论应用
## 四、知识管理方法论应用
#### 1. **Zettelkasten 方法**
### 1. **Zettelkasten 方法**
为保持笔记的互联性，继续采用 Zettelkasten 方法的原子笔记和双向链接机制，但需更加细化其应用场景。
- **原子笔记**：每个笔记只承载一个核心知识点，避免冗长笔记的出现，便于后续链接和扩展。
- **双向链接**：通过 `[[笔记名称]]` 建立笔记之间的动态关联，特别是在 `CrossDiscipline` 中，跨领域笔记应当积极利用双向链接增强联系。
#### 2. **知识生命周期管理**
### 2. **知识生命周期管理**
对每个笔记的生命周期进行系统管理，并通过插件和日程工具确保知识能够按周期得到回顾和更新。
##### 2.1 状态管理
#### 2.1 状态管理
| 标签名 | 标签示例 | 说明 |
| ------------ | -------------------- | ---------------------------------------------------------- |
@ -291,100 +296,58 @@ tags:
| 优先处理 | `#状态/优先处理` | 标记为需要优先处理的笔记或任务，提示用户尽快完成相关内容。 |
| 需要补充资料 | `#状态/需要补充资料` | 表示笔记需要额外查找、添加相关的资料或数据支持。 |
##### 2.2 定期复盘
#### 2.2 定期复盘
- 每季度通过 `Dataview` 插件生成草稿笔记列表，确保所有未完成的笔记都能得到回顾与完善。
- 结合 `Calendar` 插件设定提醒，以推动知识从“草稿”状态向“完善中”或“已完成”转变。
### 五、Graph View 的应用
## 五、Graph View 的应用
**Graph View** 可以帮助你直观了解知识库中各个笔记之间的联系，发现孤立或缺少链接的笔记。
#### 1. **Graph View 使用建议**
### 1. **Graph View 使用建议**
- **定期检查知识网络**：使用 Graph View 每季度检查一次，识别那些缺乏双向链接的孤立笔记，并通过补充关联信息增强知识网络。
- **主题聚焦**：通过 Obsidian Graph View 中的 **Local Graph** 功能，集中查看某个主题的知识点关联，便于发现知识盲点。
#### 2. **Graph View 优化步骤**
### 2. **Graph View 优化步骤**
- 对比知识密集度和孤立笔记的分布，找出薄弱环节。
- 定期为孤立笔记添加双向链接，提升知识库的整体联通性。
### 六、插件自动化支持与使用指南
## 六、插件自动化支持与使用指南
为了进一步提升 Obsidian 的效率，通过插件可以实现一些自动化功能，减少手动操作，提升工作流的简洁性和高效性。
#### 1. **Dataview 插件**
| 插件名称 | 作用 | 主要用法 |
| -------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------- |
| **Dataview 插件** | 从笔记中自动提取数据，生成动态列表、查询结果等。 | 生成草稿列表，查询状态为“完善中”的笔记，并动态展示。 |
| **QuickAdd 插件** | 通过快捷键或模板快速生成符合命名规则的笔记。 | 快速创建日志、项目笔记，减少手动操作时间。 |
| **Tasks 插件** | 任务管理工具，用于追踪任务的进度和完成情况。 | 任务追踪和生成任务清单，根据任务状态显示待办和已完成任务。 |
| **Templater 插件** | 创建动态模板，自动生成带变量的笔记，支持复杂工作流。 | 为日记、项目等创建模板，自动插入日期、时间等变量。 |
| **Calendar 插件** | 通过日历可视化日志、任务等，结合任务管理插件进行时间管理。 | 管理日记，结合 `Tasks` 显示任务到期日期。 |
| **Excalidraw 插件** | 绘制图表和草图，便于视觉化内容的表达。 | 使用 Excalidraw 进行思维导图、流程图、草图的绘制。 |
| **Hider 插件** | 隐藏 Obsidian 中的 UI 元素，使界面更加简洁。 | 隐藏标题栏、侧边栏等不常用的 UI 元素，提升界面整洁度。 |
| **Linter 插件** | 自动格式化和规范化笔记内容，保持文档的一致性。 | 通过 Linter 插件自动修正语法、排版等，保持格式统一。 |
| **Minimal Theme Settings** | 自定义 Minimal 主题外观和样式。 | 调整 Minimal 主题的布局、颜色和字体等个性化设置。 |
| **Periodic Notes 插件** | 自动生成周期性的笔记，如日记、周记等。 | 自动生成每日、每周、每月笔记，帮助定期记录和规划。 |
| **Weread 插件** | 从 WeRead 中导入阅读笔记，方便整理和管理。 | 自动同步和导入 WeRead 上的阅读笔记，进行知识积累。 |
- **作用**：Dataview 插件允许你从笔记中自动提取数据并动态生成列表、查询结果等。这对于追踪笔记的进度、审查标签、生成特定时间段的笔记回顾等非常有效。
- 主要用法：
- **生成动态列表**：自动生成当前所有 “草稿” 状态的笔记清单，帮助你定期回顾未完成的笔记。
- **状态查询**：查询所有标记为 `#状态/完善中` 的笔记，并将其整理到一个动态视图中，便于集中处理。
**Dataview 查询示例**：
```
dataview复制代码table status as "状态", created as "创建时间"
from "Personal"
where contains(status, "草稿")
sort file.name asc
```
- 该查询将生成一个动态表，列出所有状态为草稿的笔记，并按名称排序。
#### 2. **QuickAdd 插件**
- **作用**：QuickAdd 插件通过创建快捷键或模板按钮，快速生成符合命名规则的新笔记，减少手动操作的麻烦。
- 主要用法：
- **快速创建日志**：通过预设模板，创建符合日期前缀规则的日记文件，如 `YYYY-MM-DD-日志.md`，确保命名一致性。
- **快速项目笔记创建**：为项目笔记创建按钮，按既定格式（如 `项目名-任务-日期.md`）生成文件，减少手动输入时间。
#### 3. **Tasks 插件**
- **作用**：Tasks 插件帮助你在 Obsidian 中进行任务管理，它可以为你提供简单的任务管理功能，并追踪任务进度。
- 主要用法：
- **任务追踪**：你可以为项目笔记或个人日记中嵌入任务（如 `- [ ] 任务名称`），并使用 Tasks 插件自动追踪这些任务的完成情况。
- **任务清单**：根据任务状态生成清单，查看哪些任务仍然待办，哪些任务已经完成。
**Tasks 查询示例**：
```
tasks复制代码not done
due after 2023-12-01
```
- 该查询将列出所有未完成且在指定日期之后到期的任务。
#### 4. **Templater 插件**
- **作用**：Templater 插件允许你创建动态模板并嵌入变量。这对于自动生成日常模板或复杂项目笔记非常有用。
- 主要用法：
- **模板创建**：你可以为日记、项目、博客等不同类型的笔记创建模板，并在模板中加入日期、时间等动态变量，确保新建文件的格式一致。
- **自动化脚本**：通过 Templater 的脚本功能，你可以实现更复杂的自动化工作流。例如，自动插入当日日期，自动生成项目模板等。
#### 5. **Calendar 插件**
- **作用**：Calendar 插件用于将你的日志、任务等内容以日历形式可视化，便于直观管理。
- 主要用法：
- **日记管理**：结合你的 `Journal` 目录，通过 Calendar 插件可以直观地查看每月或每年的日记，帮助你回顾过往的记录。
- **时间管理**：将 Calendar 插件与 `Tasks` 插件结合，自动显示任务的到期日期，形成日历化的任务管理系统。
### 七、审计与维护策略
## 七、审计与维护策略
为了确保知识库的持续优化和高效运行，建议定期进行系统审计和维护，确保知识库符合既定的管理规范。
#### 1. **定期审查**
### 1. **定期审查**
- **标签审查**：每季度对所有标签进行一次审查，查看是否有冗余或重复的标签。通过 Dataview 生成标签使用情况的报告，确保标签系统清晰有序。
- **知识状态审查**：定期检查笔记的状态，确保“草稿”笔记不会长期处于未完成状态，推动其向“完善中”或“已完成”状态转变。
#### 2. **长期归档与内容清理**
### 2. **长期归档与内容清理**
- **过时项目**：每半年对知识库进行一次归档，将已完成或不再活跃的项目笔记和知识移入 `Archive` 文件夹，以保持主目录的简洁。
- **自动处理：**使用 Dataview 自动生成需要归档的内容列表，并手动或自动移动到归档文件夹。
- **自动处理：** 使用 Dataview 自动生成需要归档的内容列表，并手动或自动移动到归档文件夹。
#### 3. 归档文件夹
### 3. 归档文件夹
在 **Archive** 文件夹，集中管理已归档的笔记，确保主目录保持简洁。