微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

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

如何解决由炊具文件夹混淆制作的 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 举报,一经查实,本站将立刻删除。