jekyll 漂亮的永久链接给了我 WEBrick 错误

Question

我正在使用 Jekyll（3.0.0 测试版）开发我的博客，目前在本地主机上，

当我尝试实现漂亮的永久链接并尝试访问帖子时，它显示 WEBrick 错误。

如果我应用 /:year/:month/:day/:title.html 它工作正常你知道为什么它不能与漂亮的永久链接一起工作吗？

这是我得到的错误：

/2015/08/03/are-permas-working.html' not found. WEBrick/1.3.1 (Ruby/2.1.6/2015-04-13) at localhost:4000

Answer 1

一旦你在_config.yml 中将 Jekyll 永久链接设置为 pretty，如下所示：

permalink : pretty

... 并重新启动您的 WEBrick 服务器（使用 jekyll serve 或 bundle exec jekyll serve [如果关注 GitHub] 重新启动服务器实例需要新值生效，您的永久链接将不再采用YYYY/MM/DD/title-slug.html 的格式，因为它们现在是“漂亮的”。您的链接的新格式将是/:categories/:year/:month/:day/:title/。这与定义的漂亮变量here in the documentation 确定的格式一致。

这对您意味着什么是您的“永久有效”帖子的原始链接不再位于 localhost:4000/2015/08/03/are-permas-working.html，而是现在位于 localhost:4000/2015/08/03/are-permas-working/，因为您没有category 已定义。

您遇到此错误，因为在您进行更改并重新启动服务器后，您很可能没有从您的主页导航到帖子（这将拥有指向帖子的新链接），而不是您只是刷新浏览器上的页面，这将引发404，因为该页面不再存在。

奖励，Jekyll 通过创建文件夹 2015 -> 08 -> 03，然后为该特定帖子创建一个文件夹，其中包含 index.html，从而使帖子变得漂亮。

另外，如果您想要没有日期的“漂亮”链接，您需要手动指定：

permalink: "/:categories/:title"

此确保将隐藏 .html 扩展名并删除日期值。

编辑：在 cmets 中，我表示使用 /:title 进行永久链接可能不起作用，因为与非帖子页面存在冲突，我已得到纠正。如果你想要像user.github.io/title-of-blog-post/ 这样的短永久链接，你只需要设置permalink : /:title 就可以了。 但是，如果您有非帖子页面，例如 about 页面、credits 页面，您应该明确将这些页面上的永久链接设置为 /about和 /credits 在 YAML frontmatter 上，以避免出现标题为 about 的博客帖子并意外覆盖非帖子页面的极端情况。