Jekyll中的语法高亮:Pygments


在安装成功Jekyll环境的情况下.

一.安装Pygments

Jekyll 里默认的语法高亮插件是 Pygments。Pygments 支持多种语言高亮

一.1)如果你是linux

*1.安装 pygments

archlinux:

$ sudo pacman -S python2-pygments

或直接通过 pip 来安装

$ pip install pygments --user

*2.安装 pygments.rb

命令使用:

$ gem install pygments.rb

一.2)如果你是Windows

它需要安装 Python 并在网站的配置文件_config.yml 里将 highlighter 的值设置为pygments

不久之前,Jekyll 还添加另一个高亮引擎名为 Rouge

尽管暂时不如 Pygments 支持那么多的语言,但它是原生 Ruby 程序,而不需要使用 Python


*一.2)1.安装 Python

前往 http://www.python.org/download/
下载合适的 Python windows 安装包,如 Python 2.7.8 Windows Installer。

请注意,Python 2 可能会更合适,因为暂时 Python 3 可能不会正常工作。

安装

添加安装路径 (如: C:\Python27) 至 PATH。

检验 Python 安装是否成功

python –V

输出示例:

Python 2.7.8

*一.2)2.安装 ‘Easy Install’

浏览 https://pypi.python.org/pypi/setuptools#installation-instructions 来查看详细的安装指南。

对于 Windows 7 的机器,下载 ez_setup.py 并保存,例如,至C:\。 然后从命令行使用 Python 运行此文件:

python C:\ez_setup.py

添加 ‘Python Scripts’ 路径 (如: C:\Python27\Scripts) 至 PATH


*一.2)3.安装 Pygments

确保 easy_install 已经正确安装

easy_install --version

输出示例:

setuptools 7.0

使用 “easy_install” 来安装 Pygments

easy_install Pygments

二.配置


*1.配置_config.yml文件

在 Jekyll 的配置文件 _config.yml 中设置打开 Pygments

pygments: true
mardown: redcarpet

注意:新版本 Jekyll 中,pygments: true 替换为 highlighter: pygments


*2.生成css文件

进到我们的网站目录,运行下面代码生成 Pygments 样式

$ pygmentize -S default -f html > your/path/pygments.css

*3.导入css文件

生成的样式文件加到我们的网页中

<link rel="stylesheet" href="/your/path/pygments.css">

三. 使用


语法高亮的代码片段要放在标签对 `{% highlight language %}` 和 `{% endhighlight %}` 之间,
其中的 language 为[多种语言高亮](http://pygments.org/docs/lexers/)页面中的 Short names。


	{% highlight c %}
	/* hello world demo */
	#include 
	int main(int argc, char **argv)
	{
	    printf("Hello, World!\n");
	    return 0;
	}
	{% endhighlight %}

也可以采用这样的写法

1
2
3
4
5
6
7
/* hello world demo */
#include <stdio.h>
int main(int argc, char **argv)
{
printf("Hello, World!\n");
return 0;
}
三个"`"符号需要markdownx解释引擎,

markdown: redcarpet
redcarpet:
    extensions: ["fenced_code_blocks", "tables", "highlight", "strikethrough"]

生成的 html 高亮结果 以下结束是使用Pygments 样式的 default 与 vs 的并集样式

C

1
2
3
4
5
6
7
/* hello world demo */
#include <stdio.h>
int main(int argc, char **argv)
{
printf("Hello, World!\n");
return 0;
}

Java

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
package com.pexcn.activity.demo;
import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
public class MainActivity extends Activity {
private static final String TAG = "ActivityDemo";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
Log.e(TAG, "onCreate() start...");
}
}


四. Pygments 样式

Pygments 样式 默认提供了 monokai、manni、rrt、perldoc、borland、colorful、default 等等,多种的样式。

可以通过 Python Shell 中用以下命令列出当前 Pygments 支持的样式:

1
2
3
4
5
>>> from pygments.styles import STYLE_MAP
>>> STYLE_MAP.keys()
['manni', 'igor', 'xcode', 'vim', 'autumn', 'vs', 'rrt', 'native', 'perldoc', 'borland', 'tango', 'emacs', 'friendly', 'monokai', 'paraiso-dark', 'colorful', 'murphy', 'bw', 'pastie', 'paraiso-light', 'trac', 'default', 'fruity']
>>>
`

通过 -S 来选择,需要生成 monokai 的样式:

$ pygmentize -S monokai -f html > your/path/pygments.css

下面是 pygments 个各样式 show:

  • monokai

pygments-monokai

  • autumn

pygments-autumn

  • borland

pygments-borland

  • bw

pygments-bw

  • colorful

pygments-colorful

  • default

pygments-default

  • emacs

pygments-emacs

  • friendly

pygments-friendly

  • fruity

pygments-fruity

  • manni

pygments-manni

  • monokai

pygments-monokai

  • murphy

pygments-murphy

  • native

pygments-native

  • pastie

pygments-pastie

  • perldoc

pygments-perldoc

  • rrt

pygments-rrt

  • tango

pygments-tango

  • trac

pygments-trac

  • vim

pygments-vim

  • vs

pygments-vs

参考:

http://pygments.org/docs/cmdline/

热评文章