我不确定是否有可能解决这个问题 - 但无论如何我会问:
\n我正在开发一个 python 项目,使用 mkdocs 作为文档。
\n项目结构(简化)大致如下:
./\n|-- docs\n |-- index.md\n |-- page2.md\n \xe2\x94\x94-- [other documentation stuff]\n|-- [the actual program stuff]\n|-- README.md\n\xe2\x94\x94-- mkdocs.yml\nRun Code Online (Sandbox Code Playgroud)\n我正在使用 markdown_extensions markdown_include.include(在 mkdocs.yml 中声明),\n并且 index.md 仅包含{!README.md!}在此位置包含 markdown 文件的行。
这很好用,将 README.md 显示为文档的概述页面。
\n我现在遇到的问题是,在 README.md 中,我想有一个声明“有关更多详细信息,请参阅 XY”,其中 XY 应该是指向page2.md文档中标题的链接。
使用 mkdocs,我可以简单地编写see [here](page2.md#heading2),并且在文档中完美运行。但是当我直接查看 README.md(例如在 github 上)时,结果是 404。
当我放置 时see [here](docs/page2.md/#heading2),它在 README.md 中起作用,但在 mkdocs 创建的文档中不起作用。
有什么好的方法可以解决这个问题吗?非常感谢您的帮助!
\n| 归档时间: |
|
| 查看次数: |
3771 次 |
| 最近记录: |