Mkdocs 站点打开不正确答案

【问题标题】：Mkdocs site is opened incorrectlyMkdocs 站点打开不正确
【发布时间】：2018-10-15 14:48:21
【问题描述】：

我有 mkdocs.yml 文件，看起来像：

site_name: blabla
pages:
  - One page: page2.md
  - Second page: page2.md
  - Navigation: Navigation.md

当我打开它时，网址是这样的：http://10.2.0.8/blabla/master/Navigation.md 并且不起作用，我收到 404 Not Found nginx/1.14.0 (Ubuntu) 错误。如果我在 url 的末尾删除 .md 就可以了。

但是，在本地打开它就像http://127.0.0.1:8000/Navigation/ 有谁知道这是什么问题？

【问题讨论】：

你得到了正确的行为。你不应该在生成的站点中有.md 文件。 “当我打开它时，网址是这样的”是什么意思？是您正在输入的 URL，还是您点击了将您带到该 URL 的内容？如果有，是什么？
您在哪个网络服务器（Apache、nginx、...）上使用 mkdocs 部署文件？

标签： mkdocs

【解决方案1】：

如official mkdocs documentation 中所述，预期行为是http://10.2.0.8/blabla/master/Navigation.md 不存在，而是http://10.2.0.8/blabla/master/Navigation 作为http://10.2.0.8/blabla/master/Navigation/ 的快捷方式。

在您的情况下，可能出现问题的是 HTML 和 CSS 文件的部署。假设您的降价源位于~/blabla，则该目录中的mkdocs build --clean 将创建一个子目录~/blabla/site/，然后您必须将其部署在相应的目录中，例如/var/www/html/blabla/。在 Linux 下，我建议使用rsync -r --delete-before ~/blabla/site/* /var/www/html/blabbla/。换句话说：问题也可能是您根本没有部署整个站点或在不同的地方。

【讨论】：