Github Jekyll网站在本地构建但忽略在线标题标记

时间:2016-02-05 02:12:56

标签: github jekyll github-pages

这是一个非常好奇的Jekyll github问题,我无法弄明白。

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

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

如果您在线访问,您会注意到_posts目录中的markdown帖子的标题如下所示

#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. 从另一台计算机上的其他帐户重新克隆回购,以查看构建是否使用##呈现标题标记,而不是使用标题样式。它在当地仍然很好。
  4. 另一个怪癖 - 如果你去上课 - 例如

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

    注意代码块中的行间距很宽 - 本地行间距很小,看起来好多了。那么css被部分忽略了吗?

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

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

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

    非常感谢任何想法。 利亚

1 个答案:

答案 0 :(得分:6)

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

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

此迁移正在影响降价 - 转移到更严格的Kramdown版本,该版本不会将标题呈现为

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

而是在#

之后需要一个空格
# Header One Renders as a header (h1) tag

简而言之,Kramdown曾经接受过#header语法但不再接受。我注意到我的repos,我一直在使用#Header语法渲染错误。我没有澄清为什么它影响了一些而不是全部。我也不清楚为什么事情在当地变得很好。简而言之,就是 - 在#IN之后添加一个空格,如果您的回购现在看起来很好,请为将来做好准备做好准备。

我希望这有助于其他人处理迁移问题!我还必须出于各种原因调整一些代码块样式。