Github Pages-使用Jekyll渲染页面时遇到麻烦

时间:2020-04-26 16:56:59

标签: jekyll github-pages

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

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

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

remote_theme: antonostrovsky/tale

该模板已成功呈现,我可以在索引页面(https://antonostrovsky.github.io/test_site/)上看到该模板,并且Contact链接无处指向,从而导致“未找到”错误。

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

提前谢谢

2 个答案:

答案 0 :(得分:1)

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

派生您的仓库并将baseurl: "/tale"重新添加到_config.yml文件中,可以为我修复联系页面链接。

更新:

尽管上述方法使页面像叉子一样工作,但不能作为要求者使用的远程模板。

test_site具有主题并且可以构建,但是没有内容。 test_site存储库中没有页面。

如果您将主题模板存储库中的contact.md页面复制到测试站点存储库中的pages/contact.md中,然后进行重建,则您的链接现在应该可以使用了。

注意:文件和文件夹都不能以测试站点存储库中的_开头,因为它会被jekyll跳过。

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

答案 1 :(得分:1)

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

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

assets/allposts.html

最重要的事情

---
permalink: allposts.html
---

这将导致

 _site/allposts.html

正在生成文件。

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