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。我试过了
- 正在替换所有样式表和模板布局文件
- 正在重新检查配置文件。
- 从另一台计算机上的不同帐户重新克隆 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 并且如果您的回购协议现在看起来不错,请准备好它们将来无法正确呈现。
我希望这可以帮助其他人处理迁移问题!由于各种原因,我也不得不调整我的一些代码块样式。
这是一个非常奇怪的 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。我试过了
- 正在替换所有样式表和模板布局文件
- 正在重新检查配置文件。
- 从另一台计算机上的不同帐户重新克隆 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 并且如果您的回购协议现在看起来不错,请准备好它们将来无法正确呈现。
我希望这可以帮助其他人处理迁移问题!由于各种原因,我也不得不调整我的一些代码块样式。