带有 markdown_include.include 的 mkdocs 中的相对链接到标题

问题描述

我不确定是否有可能解决这个问题 - 但我还是想问:

我正在使用 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 显示为文档的概述页面

我现在遇到的问题是在 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 (将#修改为@)

相关问答

Selenium Web驱动程序和Java。元素在(x,y)点处不可单击。其...
Python-如何使用点“。” 访问字典成员?
Java 字符串是不可变的。到底是什么意思?
Java中的“ final”关键字如何工作?(我仍然可以修改对象。...
“loop:”在Java代码中。这是什么,为什么要编译?
java.lang.ClassNotFoundException:sun.jdbc.odbc.JdbcOdbc...