在 MkDocs 代码块中显示应用程序源代码文件

Question

如何在 MkDocs 中显示现有源代码文件？我想将来自另一个 GitHub 存储库的文件直接包含在代码块中，而不重新格式化它们，以便更新的文件将显示在 MkDocs 文档中。

样本代码.py

    def fn():
        pass

Answer 1

将MkDocs与Snippets 扩展一起使用。片段和/或离线处理要求文件在本地可用，这在 Pro Git 书籍Git Tools Submodules 部分中进行了解释。

1. 包括完整的文件路径，即使文件位于同一文件夹中：

索引.md

.
```python
--8<-- "docs/sample_code.py"
```
.

2. 创建源代码文件：

样本代码.py

def fn():
    pass

3. 将扩展名添加到 mkdocs 配置文件：

mkdocs.yml

site_name: Demo

markdown_extensions:
    - pymdownx.snippets:

nav:
    - Demo: index.md

输出

。

def fn():
    pass

。