# Sanhe KB

> Sanhe 的个人中文技术知识库的总目录, 列出所有主题。是知识库的首页。

Each link below is a document's raw source (Markdown, reStructuredText or a Jupyter notebook) at https://kb.sanhe.me/_sources/<path>. The web page of a source is the same path without /_sources and without the file extension. A {ref}`<doc_id>` mark in a source links to another document: https://kb.sanhe.me/p/<doc_id>.md redirects to its raw source, https://kb.sanhe.me/p/<doc_id> to its web page.

- [功能演示](https://kb.sanhe.me/_sources/01-feature-demo/README.md): 逐项演示知识库依赖的 Sphinx 功能, 每个功能一篇文档。是功能演示部分的目录页。
  - [MyST Markdown 基础](https://kb.sanhe.me/_sources/01-feature-demo/01-myst-markdown/README.md): 讲解 MyST Markdown 的跨文件引用、小节锚点、admonition、代码块、表格和数学公式。是一篇 MyST 写法的演示文档。
  - [sphinx-design 组件](https://kb.sanhe.me/_sources/01-feature-demo/02-sphinx-design/README.md): 展示 sphinx-design 的 card、grid、tab、dropdown、badge 和 button 在 MyST 里的写法。是一篇组件演示文档。
  - [mermaid 和 SVG](https://kb.sanhe.me/_sources/01-feature-demo/03-mermaid-and-svg/README.md): 展示在 MyST Markdown 里嵌入 mermaid 图、SVG 文件和内联 SVG。是一篇画图功能的演示文档。
  - [Jupyter Notebook](https://kb.sanhe.me/_sources/01-feature-demo/04-jupyter-notebook/README.ipynb): 展示 notebook 文档里的代码输出、跨文件引用、admonition 和 mermaid。是一篇 Jupyter Notebook 演示文档。
  - [reStructuredText 文档](https://kb.sanhe.me/_sources/01-feature-demo/05-restructuredtext/README.rst): 说明旧的 reStructuredText 文档如何和 MyST 文档共存并互相引用。是一篇 reST 兼容性演示文档。
  - [Jinja 模板渲染数据](https://kb.sanhe.me/_sources/01-feature-demo/06-jinja-template/README.md): 用 sphinx-jinja 把 Python 数据渲染成 Markdown 表格和 list-table。是一篇模板渲染的演示文档。
  - [literalinclude: 引用文件的一部分](https://kb.sanhe.me/_sources/01-feature-demo/07-literal-include/README.md): 用 literalinclude 按注释标记或函数名引用 Python 文件的一部分。是一篇代码引用的演示文档。
- [多级目录](https://kb.sanhe.me/_sources/02-deep-nesting/README.md): 说明目录树只负责导航, doc_id 负责身份, 目录深度不限。是多级目录演示部分的目录页。
  - [第二级](https://kb.sanhe.me/_sources/02-deep-nesting/01-level-2/README.md): 多级目录演示的第二级。是一个只含下级目录的导航页。
    - [第三级](https://kb.sanhe.me/_sources/02-deep-nesting/01-level-2/01-level-3/README.md): 多级目录演示的第三级, 包含一个被跨文件引用的小节。是一个导航页。
      - [第四级](https://kb.sanhe.me/_sources/02-deep-nesting/01-level-2/01-level-3/01-level-4/README.md): 多级目录演示的第四级, 链接回首页。是一篇最深一级的示例文档。