Jekyll kramdown配置

简介:

之前博客是使用的redcarpet的markdown语法,其在_config.yml中的配置方式为:

markdown: redcarpet
redcarpet:
    extensions: [ "fenced_code_blocks", "hard_wrap","autolink", "tables", "strikethrough", "superscript", "with_toc_data", "highlight", "prettify","no_intra_emphasis"]

这种配置支持使用 ~~~ 高亮代码块、自动链接、表格等特性。

现在,想尝试使用karkdown的语法。kramdown是一个Markdown解析器,它能够正确解释公式内部的符号,不会与Markdown语法冲突,比如不会将^符号变成标签。

kramdown支持MathJax,见Jekyll中使用MathJax

kramdown默认是支持TOC,你可以进一步设置TOC相关的参数,见 为 Octopress 添加 TOC

安装kramdown:

$ gem install kramdown

在_config.yml中的配置方式为:

markdown: kramdown
kramdown:
  input:  GFM
  use_coderay: true

在编写文章时,插入下面代码,渲染之后就可以生成TOC了:

* TOC
{:toc}

krmadown支持和github一样的语法高亮,用三个 ~~~,但是需要安装coderay,而github pages上不支持coderay,所以该方式无法搞定,可行的解决方法是上传本地编译好的html。如果是本地或者自己的空间,可以安装coderay。

$ gem install coderay

使用 ~~~ 引用代码块:

class AdView (object):
    def __init__ (self, name = None):
        self.name = name

    def test (self):
        if self.name == 'admin':
            return False
        else
            return True

更多语法,见kramdown语法小记

最后的配置为:

kramdown:
  input: GFM
  extensions:
    - autolink
    - footnotes
    - smart
  use_coderay: true
  syntax_highlighter: rouge
  coderay:
    coderay_line_numbers:  nil

coderay支持的语言有限,并且rouge兼容Pygments,故这里使用rouge:

$ gem install rouge
目录
相关文章
|
JSON Linux 数据格式
Hugo教程#1配置开发环境
前段时间我把我的博客的生成器从Jekyll换到了Gatsby后来发现并不好用,又想回到Jekyll,最后由于ruby的gem安装老是出错,所以我试了一下Hugo
185 0
|
机器人
gitbook 插件 阅读更多
gitbook 插件 阅读更多
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
232 0
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
|
Ruby Windows
windows安装jekyll步骤及问题
windows安装jekyll步骤及问题
206 0
windows安装jekyll步骤及问题
|
JavaScript 开发工具 git
用Hexo搭建本地静态博客
用Hexo搭建本地静态博客
155 0
|
开发工具 git Ruby
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
319 0
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
|
应用服务中间件 nginx
Docsify和Github&Nginx部署博客书
Docsify和Github&Nginx部署博客书
559 0
Docsify和Github&Nginx部署博客书
Gitbook官方使用手册
Gitbook官方使用手册
179 0
|
监控 前端开发 搜索推荐