问题描述
我不确定是否有可能解决这个问题 - 但我还是想问:
我正在使用 mkdocs 作为文档处理 Python 项目。
项目结构(简化)大致如下:
./
|-- docs
|-- index.md
|-- page2.md
└-- [other documentation stuff]
|-- [the actual program stuff]
|-- README.md
└-- mkdocs.yml
我正在使用 markdown_extensions markdown_include.include
(在 mkdocs.yml 中声明),
并且 index.md 仅包含行 {!README.md!}
以在此处包含降价文件。
我现在遇到的问题是在 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 创建的文档中无效。
解决方法
暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!
如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。
小编邮箱:dio#foxmail.com (将#修改为@)