记录回忆,知识和畅想的地方
以 Nólëbase 为名,读作 nole-base,取自意为「知识」的昆雅语 nólë 和意为「基础」的英文 base,即「知识库」
- 🌈 多样的主题和内容:
- 本知识库和所生成的页面均由创作者们维护,涉及到生活中各方面知识和内容,也不乏我们的回忆和畅想。
- 📃 皆为 Markdown:
- 使用 Markdown 和 Markdown 拓展语法编写和记录笔记,每一个页面都是 Markdown 文件。
- 🚀 由 VitePress 驱动:
- 基于 Vite 的强大静态文档页面生成器,它生成了我们知识库的页面,提供了简单易用的主题和工具。
- 🗃 由 Obsidian 驱动:
- 强大的知识库管理工具,支持花样繁多的插件和拓展,让知识管理变得更加简单。
由于很多时候需要重复编排和调整文档的结构和注解以适应和满足使用者的阅读习惯或是文档叙述的内容需求,以及说明使用的 API 的版本号和破坏性更新说明,可能会导致在以上或是更多外部因素的影响下导致文档结构混乱不一,查询造成困难,或是索引和快速查阅文档的时候需要花费大量的时间和精力去了解文章结构和内容,以下提出了一个较为完善(任需商议)的知识库结构、使用规范的提案。 该提案包含:
- 对文档结构的说明
- 对文档的版本控制和兼容性注释
- 关于如何正确使用脚注和参考资料给文档提供更多相关联信息的指南
一般,文档需要有以下结构(按照从上到下排列):
- 使用一级标题的标题(一般为文件名本身)
- 使用正文格式的作者
- 非强制 · 标签(如果有的话,方便搜索和索引)
- 非强制 · 使用五级标题的 文档兼容性 (仅针对涉及了不同软件或是 API 的指南和操作文档)
- 非强制 · 使用五级标题的 Archive 信息 (仅针对 📃 Archives 目录下的所有文档)
- 非强制 · 使用二级标题的概述(仅针对超大型文档,提供概述可以提高检索和快速查阅的效率)
- 使用二级标题的目录
- 使用二级标题的说明
- 有完善标题分级和注解、甚至是脚注的正文
- 非强制 · 使用二级标题的延伸阅读或是参考资料(仅针对如果引用了文章、网页的绝大多数内容;没有实际引用到文档内但是值得参考和阅读的文章、网页的内容;查阅资料时遇到的(非强关联,但是也有关系的)相关内容时需要添加)
- 非强制 · 不使用标题的脚注(如果有的话,通过使用脚注插件 Footnote shortcu(参考🔌 知识库插件列表 )创建,可以避免过多的引用和链接出现在正文里)
每一项的内容和说明都会在下方的文档中一一说明
标题一般为文件名本身,方便查询和记忆。
#标题
标签不易于展示渲染后效果,此处不再赘述。
标签可以使得文档易于检索和串联在一起,也可以使得在阅读一篇文档之后再去阅读相关标签的其他文档时变得方便检索和寻找。
通常使用 # 作为开头:
#知识库
对于存放在 📃 Archives 目录中的文件(包括文档、静态资源),都应添加 Archive 信息 显著的标记其来源,创建时间、以及原始资源的信息等内容。 这将确保我们在 Archive 文档或静态资源时可以保留其作者的信息和采集信息,方便未来的资料查证、资料溯源等变成可能。 另外需要注意的是,我们在进行 Archive 采集时都应该注意创作者所使用的共享协议,如果不允许转载,则不能进行 Archive 采集。
该字段填写该文档或者静态资源的采集来源,该字段的值需要匹配该文档或者静态资源于 📃 Archives 目录和分类目录下的目录名称。
比如放置在 📃 Archives/📖 文章/Medium
目录下的文档或者静态资源都应该在该字段中填写 Medium
,如果可能,可以使用链接来撰写来源,这在多种同名来源的情况下将会变得非常有用。
当前支持的来源有:
Archive 自 |
---|
微信公众号文章 |
CSDN |
ADDitude |
The Verge |
知乎 |
该字段填写该文档或者静态资源的采集时间。
该字段填写该文档或者静态资源的分类该字段的值需要匹配该文档或者静态资源于 📃 Archives 目录下的目录名称。
比如放置在 📃 Archives/📖 文章/Medium
目录下的文档或者静态资源都应该在该字段中填写 文章
。
该字段填写该文档或者静态资源的原始作者,如果网页没有提供原始作者的信息,比如新闻类、资讯类网站,我们则可以填写采集来源作为该字段的值。
该字段填写被采集的文档或是静态资源的原始地址。
该字段填写被采集的文档或是静态资源的原始创建时间。
该字段填写被采集的文档或是静态资源的原始更新时间。如果网页没有提供更新时间,我们则可以填写原始资源创建时间作为该字段的值。
##### Archive 信息
| Archive 自 | Archive 创建于 | 分类 | 原始作者 | 原始地址 | 原始资源创建时间 | 原始资源更新时间 |
| ---------- | ------------ | ---- | ------- | ------- | ------------- | ------------- |
| Medium | 2022-10-29 16:30 | 文章 | 作者 Alpha | [链接](https://example.com) | 2022-10-29 16:30 | 2022-10-29 16:30 |
对于涉及到软件和 API 的讲解和教程文档,应该提供文档兼容性部分以详细描述该文档所适配的软件或 API 版本,如此一来就可以方便我们排查破坏性更新或是兼容性导致的软件或 API 与文档中叙述的行为不一致导致的问题。
软件名称,或是 API 名称,如果是 HTTP Restful API,可以填写完整的 URI 地址。
此处的版本号不需要遵循文档版本中提到的语义化版本 2.0.0 规范,应该直接填写应用程序或是 API 的版本。
如果有对应的文档,则应该把对应版本的文档地址或者是参考文件地址粘贴到该字段中方便查阅。
### 文档兼容性
| 主体 | 版本号 | 文档地址(如果有) |
| -- | -- | -- |
| NebulaGraph | v2.6.1 | https://docs.nebula-graph.com.cn/2.6.1/ |
概述仅针对超大型文档,即目录、说明、正文的文本阅读时间超过了 30 分钟的文档。在该部分中需要提供类似于 TL;DR 的精简化说明,可能的情况下可以直接给出结论。
文档所引入的外部资料、外部说明都应该有详细的来源链接可供参考。
对于值得继续阅读以探究文档所讨论的、描述的主题所相关的链接和外部资源,这些链接或是外部资源应当放置到 ## 延伸阅读
部分。
对于撰写文档所参考的资料,这些链接或是外部资源应当放置到 ## 参考资料
部分,或是脚注的部分。值得补充的是,对于可能年久失修、来源网站不稳定、审查过强的链接和外部资源,我们可以预先把这些链接和外部资源采集并放置到 📃 Archives 中方便引用。
本仓库代码以 MIT License 协议发布
本仓库除 笔记/📃 Archives
目录以外的文档、图片和其引用的资源均以 CC BY-NC-SA 4.0 协议发布