Windows下运行jeklly,并在本地浏览Bootstrap文档

版权声明:本文为博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://blog.csdn.net/u012844814/article/details/28869997

1.在windows下安装jeklly

为了解决在windows下安装jeklly的繁琐步骤和繁重的工作,在这里我推荐直接采用Madhur Ahuja的portable Jekyll。( http://www.madhur.co.in/blog/2013/07/20/buildportablejekyll.html )下载完成后直接解压到任意路径即可。在管理员CMD下进入解压的portable Jekyll所对应的路径运行setpath.cmd即可。如果喜欢一步一步折腾安装的同学,这里也有方法可供参考。( http://www.madhur.co.in/blog/2011/09/01/runningjekyllwindows.html

2.在jeklly中运行bootstrap 3.X

根据官方文档( https://github.com/twbs/bootstrap#documentation ),进入bootstrap解压的根目录,然后输入命令jeklly serve;此时会出现一个错误。如下图所示。Deprecation: The 'pygments' configuration option has been renamed to 'highlighter'. Please update your config file accordingly. The allowed values are 'rouge', 'pygments' or null.  Generating...Liquid Exception: Failed to get header. in components.html

jeklly-Error

其实出现这个问题与Failed to get header无关,也就是说这根本就不是版本什么的不兼容的问题,而是我们下载下来的bootstrap的 _config.yml 配置文件的问题。在出现这个错误要么就是版本问题,要么就是配置文件的问题,经过多方Google之后,这个问题是由于一个语法高亮的插件(pygments.rb)引起的,导致编译错误。只需要在bootstrap文档中找到_config.yml,然后将其中的pygments: true修改为highlighter: pygments即可。然后即可正常运行jekyll serve

3.在浏览器中浏览bootstrap文档

jeklly-running

同样,_config.yml也定义了预览地址和端口。默认的端口为9001。我们直接在浏览器中输入 http://localhost:9001 即可预览。

展开阅读全文

没有更多推荐了,返回首页