Github页面无法正确显示降价

时间:2016-02-15 09:29:53

标签: github markdown jekyll github-pages

我正在使用github pages + jekyll来建立我的博客。

在推送我的最新提交之前它已正常工作。此提交添加了一个cname文件,只是编辑了一些单词而没有对我的站点的体系结构进行任何更改。

-    <h3 class="description">aaaaaaaaaa</h3>
+    <h3 class="description">bbbbbbbbbb</h3>

之后,降价显示不正确。

当我写#head1时。它没有出现标题head1,它只是直接出现#head1。

enter image description here

但是,如果我在localhost:4000中使用jekyll serve build,它会正确显示 enter image description here

这是我的_config.yml:

  减价:kramdown
  markdown_ext:markdown,mkd,mkdn,md
  textile_ext:纺织品   荧光笔:pygments

任何想法导致此错误的原因是什么?

3 个答案:

答案 0 :(得分:2)

已更新!

这很可能是由Jekyll 3 upgrade上的GitHub Pages造成的。

从2016年5月1日起,GitHub将不再支持rdiscountredcarpet。此外,自2月1日起,GitHub Pages仅支持rouge

  

从2016年5月1日开始,GitHub Pages仅支持kramdown,   Jekyll的默认Markdown引擎。

     

GitHub页面现在只支持   胭脂。

您可以查看here

为了处理它,请按以下步骤操作:

首先,按照answer的说明进行尝试。而不是#Heading,你会写# Heading

其次,调整您的_config.yml:更改highlightermarkdown

highlighter: rouge
markdown: kramdown
kramdown:
  input: GFM

第三,要在本地构建您的网站,请使用Bundler方法recommended by GitHub

  1. 安装Bundler:

    gem install bundler
    
  2. 然后运行bundle update - 如果您已经在本地安装了此gem,这将更新您的所有宝石,包括github-pages

  3. 然后,使用以下内容创建Gemfile(不带任何文件扩展名):

    source 'https://rubygems.org' 
    gem 'github-pages'
    
  4. 将其保存到项目的根目录。

    1. 然后,在项目上运行bundle install。这将创建一个名为Gemfile.lock的文件,并安装所有必需的宝石及其依赖项

    2. 最后,运行bundle exec jekyll serve --watch,您就可以在本地查看您的网站,就像您在线查看一样(在GitHub上托管时)。

    3. 到那时你应该没问题!

      PS。如果您的项目需要更多宝石,例如jekyll-paginatejekyll-mentions,则需要将它们添加到Gemfile,例如:

      source 'https://rubygems.org' 
      gem 'github-pages'
      gem 'jekyll-paginate'
      

      另外,将它们添加到项目的_config.yml

      gems:
        - jekyll-paginate
        - jekyll-mentions
      

      在这里,您会看到gem versions currently supported by GitHub Pages的列表。在这里,您可以阅读Upgrading Jekyll 2 to 3

      希望有所帮助!

答案 1 :(得分:1)

运行我自己的Jekyll驱动的github页面博客,

表示标题大小的#与标题文本之间的空格很重要,否则标记将不会按预期显示。因此,在您的示例中,我会将我的降价标题显示为

# 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

答案 2 :(得分:0)

GitHub支持降价以及jekyll 首先使用 .md 扩展程序

重命名您的文件

如果您的文件夹中有.nojekyll,则禁用 njekyll。

确认您没有这是您的文件夹。

阅读docs&amp;&amp; GitHub relevant doc关于如何准备和部署

  

正在运行Jekyll

     

使用命令git checkout切换到GitHub Pages构建服务器用于生成站点的默认分支。您切换到的默认分支取决于您正在构建的GitHub页面站点的类型。

     

对于Project Pages网站,请切换到gh-pages。   对于用户页面或组织页面站点,切换到主站点。有关详细信息,请参阅“用户,组织和项目页面”。

     

使用命令bundle exec jekyll serve在您的存储库的根目录中运行带有Bundler的GitHub Pages构建服务器。

     

捆绑exec jekyll发球   导航至http://localhost:4000以查看您的本地网站。