Github Pages - 使用 Jekyll 渲染页面时遇到问题

Question

在使用 Github 页面时，我无法让 Jekyll 呈现联系人页面。 我正在使用以下模板：https://github.com/antonostrovsky/tale

如果我将模板克隆到本地存储库并运行bundle exec jekyll serve，我会得到一个页面，其中包含我可以成功关注的联系人链接。生成的 _site 文件夹包含一个子文件夹“contact”，其中包含 index.html。

然后我在 Github 上创建一个空存储库 (https://github.com/antonostrovsky/test_site) 并在 _config.yml 中指定此模板：

remote_theme: antonostrovsky/tale

模板渲染成功，在索引页（https://antonostrovsky.github.io/test_site/）可以看到模板，Contact链接不通，导致“Not Found”错误。

1. 谁能帮助我了解如何解决此问题？ Jekyll 是否有任何可以放在 github 页面上的调试输出？
2. 有人知道出了什么问题吗？

提前谢谢你

Answer 1

我创建了一个diff between your repo and the template repo 并注意到在某个阶段您删除了_config.yml 文件中的baseurl 属性。

分叉您的回购并将baseurl: "/tale" 重新添加到_config.yml 文件为我修复了联系页面链接。

更新：

虽然上述内容使页面作为分叉工作，但它不能作为提问者所需要的远程模板工作。

test_site 有主题并且可以构建，但是它没有内容。 test_site repo 中没有页面。

如果您将您的contact.md 页面从主题模板存储库复制到测试站点存储库中的pages/contact.md，然后重新构建，那么您的链接现在应该可以工作了。

注意：在测试站点 repo 中，文件和文件夹都不能以 _ 开头，因为它会被 jekyll 跳过。

提示：打开开发控制台并禁用页面缓存，然后重新加载以更快地在 github 上查看您的更改。它还有助于添加更改某些页面内容，以便您知道您看到的是最新版本。

Answer 2

添加到接受的答案并解释这种奇怪的行为。设计中不包含来自远程主题的页面：

自定义主题文件可以放在：

assets/allposts.html

前题

---
permalink: allposts.html
---

导致

 _site/allposts.html

正在生成文件。

来源：https://github.com/benbalter/jekyll-remote-theme/issues/64