如何解决由炊具文件夹混淆制作的 Django sphinx 文档
当使用 cookiecutter 启动一个全新的 Django 项目时,我对 sphinx 为其文档制作的文件夹结构感到有些困惑。 我在 docker 中设置了我的项目,按照说明,一切正常,我有以下文档文件夹结构。
当我在 docs 容器(或使用 docker-compose local.yml 文件)中运行命令 make html
时,我得到以下结构。
一个新文件夹“html”被创建,它包含来自周围文件夹的所有内容。这样对吗?我是否正确理解了这个过程? 对我来说,某处的某个源文件夹看起来像是一些错误的设置。
我是一名经验丰富的 Python 开发人员,也熟悉 Docker,但我对 Django 和 sphinx 还是很陌生。 有人可以指导我走正确的道路,可能分享他们的 Django sphinx 文档工作流程吗?
非常感谢。
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。