由炊具文件夹混淆制作的 Django sphinx 文档

问题描述

当使用 cookiecutter 启动一个全新的 Django 项目时,我对 sphinx 为其文档制作的文件夹结构感到有些困惑。 我在 docker 中设置了我的项目,按照说明,一切正常,我有以下文档文件夹结构。

Folder structure created on startup

当我在 docs 容器(或使用 docker-compose local.yml 文件)中运行命令 make html 时,我得到以下结构。

folder structure after "make html"

一个文件夹“html”被创建,它包含来自周围文件夹的所有内容。这样对吗?我是否正确理解了这个过程? 对我来说,某处的某个源文件夹看起来像是一些错误的设置。

我是一名经验丰富的 Python 开发人员,也熟悉 Docker,但我对 Django 和 sphinx 还是很陌生。 有人可以指导我走正确的道路,可能分享他们的 Django sphinx 文档工作流程吗?

非常感谢。

解决方法

暂无找到可以解决该程序问题的有效方法,小编努力寻找整理中!

如果你已经找到好的解决方法,欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@)