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
目录
相关文章
|
8月前
|
JavaScript 前端开发 Go
8 大博客引擎 jekyll/hugo/Hexo/Pelican/Gatsby/VuePress/Nuxt.js/Middleman 对比
探索各类博客引擎:Jekyll、Hugo、Hexo、Pelican、Gatsby、VuePress、Nuxt.js和Middleman的对比,包括语言、模板引擎、速度、社区活跃度等。了解每种引擎的优缺点,助你选择合适的博客构建工具。查看详细文章以获取更多实战和安装指南。
|
JavaScript 安全 前端开发
给Hexo添加说说功能
给Hexo添加说说功能
|
JSON Linux 数据格式
Hugo教程#1配置开发环境
前段时间我把我的博客的生成器从Jekyll换到了Gatsby后来发现并不好用,又想回到Jekyll,最后由于ruby的gem安装老是出错,所以我试了一下Hugo
195 0
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
256 0
Hexo、Jekyll、Sphinx、mkdocs、docsify等静态博文档汇总
|
机器人
gitbook 插件 阅读更多
gitbook 插件 阅读更多
|
Ruby Windows
windows安装jekyll步骤及问题
windows安装jekyll步骤及问题
226 0
windows安装jekyll步骤及问题
|
开发工具 git Ruby
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
329 0
【Jekyll搭建GITHUB个人博客】安装Ruby 环境、包管理器 RubyGems、Jekyll与错误解决
|
开发工具
适合个人建站的免费开源网站主题汇总(hexo&jekyll&hugo&wordpress&typecho)
适合个人建站的免费开源网站主题汇总(hexo&jekyll&hugo&wordpress&typecho)
1151 0
|
JavaScript Go Ruby
将博客从Hexo迁移至Hugo
自从了解了Github Pages这种静态博客后,开始喜欢上这种技术人员才能鼓捣明白的协作方式。自己的博客系统也从最初的Octopress,切换到Hexo,直到最近看到Hugo这种号称全球最快的静态博客系统,被适合技术人员的风格样式所吸引。于是在经历了三天的折腾后,顺利的将Hexo迁移至Hugo中。
482 0
将博客从Hexo迁移至Hugo
|
监控 前端开发 搜索推荐