Github页面无法正确显示标记
我正在使用github pages+jekyll建立我的博客 在推送我的最新提交之前,它工作正常。这个提交添加了一个cname文件,只编辑了一些单词,没有对我的站点的架构进行任何修改Github页面无法正确显示标记,github,markdown,jekyll,github-pages,Github,Markdown,Jekyll,Github Pages,我正在使用github pages+jekyll建立我的博客 在推送我的最新提交之前,它工作正常。这个提交添加了一个cname文件,只编辑了一些单词,没有对我的站点的架构进行任何修改 - <h3 class="description">aaaaaaaaaa</h3> + <h3 class="description">bbbbbbbbbb</h3> -aaaaaaaaaa +bbbbbbbbbbbb 之后,降价不会正确显示 当我写#
- <h3 class="description">aaaaaaaaaa</h3>
+ <h3 class="description">bbbbbbbbbb</h3>
-aaaaaaaaaa
+bbbbbbbbbbbb
之后,降价不会正确显示
当我写#头1。它不显示标题head1,而是直接显示#head1
但是,如果我在localhost:4000中使用jekyll serve build,则显示正确。这是我的_config.yml: 降价:克拉姆敦
降价\外部:降价,mkd,mkdn,md
纺织品外部:纺织品
荧光笔:pygments
知道是什么导致了这个错误吗?GitHub支持降价以及jekyll。
首先,使用
.md
扩展名重命名文件
如果文件夹中有.nojekyll
,它将禁用njekyll
确认您没有此文件夹
阅读关于如何准备和部署的&&说明
跑杰基尔 使用git checkout命令切换到GitHub页面生成服务器用于生成站点的默认分支。您切换到的默认分支取决于您正在构建的GitHub页面站点的类型 对于项目页面站点,切换到gh页面。 对于用户页面或组织页面站点,切换到master。有关更多信息,请参阅“用户、组织和项目页面” 使用存储库根目录中的命令bundle exec jekyll serve,使用Bundler运行GitHub页面构建服务器 捆绑执行杰基尔服务 导航到以查看您的本地站点 更新 这很可能是由于打开了 从2016年5月1日起,GitHub将不再支持
rdisont
或红地毯。此外,自2月1日起,GitHub页面仅支持胭脂rouge
:
从2016年5月1日开始,GitHub页面将只支持kramdown,
杰基尔的默认降价引擎
GitHub页面现在只支持
胭脂
你可以看看这个
要处理此问题,请执行以下操作:
首先,试着像上面解释的那样。您将编写#Heading
,而不是#Heading
第二,调整您的\u config.yml
:更改您的荧光灯
和标记
highlighter: rouge
markdown: kramdown
kramdown:
input: GFM
第三,要在本地构建站点,请使用以下方法:
安装捆绑程序:
gem install bundler
然后运行bundle update
-这将更新您的所有gem,如果您已经在本地安装了此gem,则包括
然后,创建一个包含以下内容的Gemfile
(不带任何文件扩展名):
source 'https://rubygems.org'
gem 'github-pages'
将其保存到项目的根目录中
然后,在项目上运行bundle install
。这将创建一个名为Gemfile.lock
的文件,并将安装所有必需的gems及其依赖项
最后,运行bundle-exec-jekyll-serve--watch
,您将能够在本地查看您的网站,就像在线查看一样(在GitHub上托管时)
那时你应该没事了
注:如果您的项目需要更多宝石,如
jekyll paginate
或jekyll提到的
,您需要将它们添加到Gemfile
,例如:
source 'https://rubygems.org'
gem 'github-pages'
gem 'jekyll-paginate'
另外,将它们添加到项目的\u config.yml
:
gems:
- jekyll-paginate
- jekyll-mentions
在这里,您将看到一个列表。这是你读到的
希望有帮助 在我自己的Jekyll-powered github-pages博客上的一点观察 表示标题大小的#和标题文本之间的空格很重要,否则标记将无法按预期显示。因此,以您的示例为例,我会将我的降价标题显示为
# Zookeeper Atomic Broadcast for heading 1
## Zookeeper Atomic Broadcast for heading 2
### Zookeeper Atomic Broadcast for heading 3
#### Zookeeper Atomic Broadcast for heading 4
##### Zookeeper Atomic Broadcast for heading 5
谢谢你回答我的问题。所有文件都已以
md
扩展名结束,我确信我的文件夹中没有.nojekyll
。它仍然不起作用。我计划仔细阅读所有关于github页面和jekyll的文档。酷,我会尽我所能帮助你,谢谢你的回答。我在#和标题之间添加了一个空格,作为第一步中的描述。我编辑了我的config.yml。然而,它仍然不起作用。我不完全理解您的第三步,只需使用gem update jekyll
更新我的jekyll即可。(现在是jekyll版本3.1.1)。在localhost 4000中,它仍然有效。我发现除了标记文件中的标题标记(如##########之外,一切都很好。我将编辑答案以使您更清楚。:)@卢卢卢很抱歉耽搁了,我以前没时间这么做。但现在我相信答案是完整的。让我知道进展如何,好吗?哦,我忘了提一下:当你说你运行了gem update-jekyll
但不起作用时,这是因为jekyll不是唯一需要更新的gemgithub页面
gem是这个案例中最重要的部分。此外,当您在项目中运行bundle install
时,它将需要与GH Pages当前使用的jekyll版本相同的版本(现在是)。不时更新您的所有gem非常重要,这样您就不会遇到麻烦:运行bundle update
。很抱歉我延迟了一周。我在MacOSX中遇到了ruby的问题。幸运的是,我解决了这个问题。之后,我在github中删除我的博客存储库并重新创建它。然后,我完全按照您的回答中的步骤和关于github页面的文档说明重新建立了我的博客。它工作!!!虽然我还没有找到这个问题的确切原因,但我会努力找出原因。非常感谢你,你的回答对我很有帮助。我将采纳它。