python-3.x - Sphinx 和 Markdown .md 链接

Question

我正在尝试使用 Sphinx 将 Markdown 文件转换为 html，但无法获取 [links](another.md)翻译成<a href="another.html">links</a> , 而目标的扩展仍然是原来的 .md并显示为 <a href="another.md">links</a> .

我创建了一个简单的例子......

测试.md

[Test link](https://www.stackoverflow.com)

[Another Markdown doc](another.md)

另一个.md

# Another test markdown

这两个文件都位于顶级目录中，我运行 sphinx-quickstart创建 conf.py ，接受默认值。然后我修改 conf.py具有...

from recommonmark.parser import CommonMarkParser
extensions = [
    'sphinx.ext.autodoc',
]
source_suffix = ['.rst', '.md']
source_parsers = {
    '.md': CommonMarkParser,
}

生成的 html 文件已生成，但链接来自 test.html至 another.html不正确，显示为...

test.html

...
<p><a class="reference external" href="https://thefloow.com">Test link</a></p>
<p><a class="reference external" href="another.md">A real test</a></p>
...

...并指向 another.md而不是 another.html .几天前我问过，并指出使用recommonmark的 AutoStructify (参见线程 here )但这没有用，在进一步挖掘/阅读后发现 enable_auto_doc_ref is now deprecated和 .md links are added as :any: and should be handled by Sphinx .

但我不明白为什么这不起作用或我应该做些什么来解决它。任何建议将不胜感激。

编辑

版本如下

狮身人面像 1.8.0

推荐 0.4.0

Answer 1

recommonmark==0.5.0.dev0解决了这个问题。
conf.py配置

extensions = [
    # other
    'recommonmark',
]

source_suffix = ['.rst', '.md']

pip配置 ( requirements.txt )

sphinx==1.8.2
# recommonmark==0.5.0.dev0
git+https://github.com/rtfd/recommonmark

请引用 https://www.sphinx-doc.org/en/master/usage/markdown.html如果您需要更多详细信息。