使用 conf.py 的主题更改现在在导入时忽略我的 toctree 的 .md 文件

Question

我正在从 GitHub/gitbook 移出一份技术文档并在 RTD 上使用 Sphinx，默认导入在 index.rst 之外没有 sphinx 文件用于创建 toctree 和 RTD 中的默认设置它工作正常, 显示效果很好，看起来比以前好多了，但是颜色不对。当我将主题选项的 conf.py 添加到我的 GitHub 项目中（让 master 查找索引）然后重建到 RTD 中时，构建成功并具有漂亮的颜色但现在忽略了我的 .md 文件所以没有 toctree 内容。没有 conf.py 我的布局很好，但颜色不对。

我觉得我已经尝试了所有方法，从回到基础 conf.py 到在 toctree 中留空到一个文件，我已经将文件扩展名更改为 .rst，它可以工作但不会重新格式化.md.它似乎只是忽略了 .md 文件

*仅从 conf.py 更改了下面的代码，索引与工作时的文档相同

master_doc = 'index'
html_theme = "classic"
"rightsidebar": False,
"stickysidebar": True,
"collapsiblesidebar": True,
"externalrefs": True,
"footerbgcolor": 'white',
"footertextcolor ": 'darkslategrey',
"sidebarbgcolor": 'white',
"sidebarbtncolor": 'darkslategrey',
collapsiblesidebar is True).
"sidebartextcolor": 'darkgreen',
"sidebarlinkcolor":'green',
"relbarbgcolor": 'darkslategrey',
"relbartextcolor": 'white',
"relbarlinkcolor": 'white',
"bgcolor": 'white',
"textcolor": 'black',
"linkcolor": 'darkgreen',
"visitedlinkcolor": 'darkgreen',
"headbgcolor": 'white',*

我想要实现的是导入我的 .md 文件，它们来自实时文档，让它们使用带有自定义颜色的经典主题输出。

Answer 1

您必须在 conf.py:

中声明 source_suffix

source_suffix = {
    '.rst': 'restructuredtext',
    '.txt': 'restructuredtext',
    '.md': 'markdown',
}

您可能还需要安装和配置 recommonmark. RTD supports it natively。

使用 conf.py 的主题更改现在在导入时忽略我的 toctree 的 .md 文件

Theme change using conf.py now ignores my .md files for the toctree when importing

python

python-sphinx

read-the-docs