python - 在 Django 项目中的 URL 中托管使用​​ mkdocs 生成的 API 文档

标签 python django mkdocs

我倾向于使用 Markdown 编写 API 文档并使用 MkDocs 生成静态站点。但是,我想在其上托管文档的站点是 Django 站点。所以我的问题是,我似乎无法找到答案谷歌搜索,我将如何在 /api/v1/docs 之类的位置托管 MkDocs 静态生成的站点文件并拥有可在该 URL 上查看的静态站点?

更新: 我应该指出我确实在 Apache 下提供所有静态文件并且不使用 runserver 或 Debug模式来提供静态文件,这太疯狂了。该站点已完全构建并可与 REST API 一起使用。

我的问题很简单,我如何让 Django(或者我应该说 Apache)为 MkDocs 在特定 URL 下生成的静态站点(用于我的 API 文档)提供服务。我了解如何为站点提供媒体和静态文件,但不一定了解如何提供 MkDocs 生成的内容。它生成一个完全静态的“站点”目录,其中包含 HTML 和 Assets 文件。

最佳答案

Django 只是一个框架,您需要它来托管静态文件并使用 Nginx 或 Apache 等工具为它们提供服务。

关于python - 在 Django 项目中的 URL 中托管使用​​ mkdocs 生成的 API 文档,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/32511575/

相关文章:

python - Opencv:如何在不删除任何其他字符的情况下删除矩形黑框

python - 用 Python 绘制变形的二维网格

python - 在带加量词的字符范围后,负前瞻不起作用

python - 你如何找到一段 Python 的 CPU 消耗?

javascript - 将脚本标签添加到 Markdown 文件

python - GridSearchCV(sklearn) 中的多个估计器

python - 在测试期间,Pickle 无法将对象存储在 django locmem 缓存中?

python - 在 Django 中将用户传递给foreignkey时出错

markdown - MkDocs - 如何从 index.md 中的 mkdocs.yml 创建目录

python - 我在运行 mkdocs serve 命令时遇到问题