Github Jekyll 站点在本地构建但忽略 header 在线标签

Github Jekyll site builds locally but ignores header tags online

这是一个非常奇怪的 Jekyll github 问题,我无法弄清楚。

我在这里有一个 repo,我正在开发教程

https://github.com/NEONInc/NEON-DataSkills-Lesson-Development

如果你去网上看,你会注意到虽然 _posts 目录中有 markdown 帖子 headers 如下

#Header One
##Header Two

它们不在线呈现。请注意,即使是着陆页:

http://neoninc.github.io/NEON-DataSkills-Lesson-Development/

将顶部标题呈现为

##Welcome to the NEON #WorkWithData Portal!

而不是

欢迎来到 NEON #WorkWithData 门户!

这是最奇怪的部分 - 当我进行“jekyll”构建时,它在本地呈现 FINE。我试过了

  1. 正在替换所有样式表和模板布局文件
  2. 正在重新检查配置文件。
  3. 从另一台计算机上的不同帐户重新克隆 repo,以查看构建是否使用 ## 而不是使用标题样式来呈现标题标签。它在本地仍然呈现良好。

另一个怪癖 - 如果你去上课 - 例如

http://neoninc.github.io/NEON-DataSkills-Lesson-Development/R/EML

注意代码块中的行间距很宽-局部行间距较小,看起来好多了。所以有人 css 被部分忽略了?

我不确定还有什么可以尝试让事物正确呈现 - 或者在 github 在线和本地构建之间呈现一致。特别是考虑到我无法在本地复制该问题。关于我还可以尝试解决此渲染问题的任何指导吗?

注意:这个相同的 repo 皮肤用于其他 repos 并在线呈现 JUST FINE。所以这个问题特定于这个特定的回购协议。

示例:http://neoninc.github.io/NEONDS-Template-Repository/

非常感谢任何想法。 利亚

感谢您的反馈。在与 GitHub 交谈后,我想 post 解决这个问题。 Github 正如评论中指出的那样正在迁移到 Jekyll 3.0! (谢谢!)

https://github.com/blog/2100-github-pages-now-faster-and-simpler-with-jekyll-3-0

此迁移正在影响 markdown - 转向更严格的 Kramdown 版本,该版本不会将 headers 呈现为

#Header One Will render as a paragraph rather than a header

如果在#

之后需要 space
# Header One Renders as a header (h1) tag

简而言之,Kramdown 曾经接受 #header 语法,但现在不再接受了。我注意到我一直在使用 #Header 语法的存储库一个一个地错误呈现。我没有澄清为什么它会影响一些而不是全部。我也不清楚为什么事情在当地变得很好。简而言之,解决方案是 - 在您的 # 之后添加一个 space 并且如果您的回购协议现在看起来不错,请准备好它们将来无法正确呈现。

我希望这可以帮助其他人处理迁移问题!由于各种原因,我也不得不调整我的一些代码块样式。