用Python高亮org-mode代码块

Virtualenv 用于创建独立的Python环境，多个Python相互独立，互不影响，它能够：

1. 在没有权限的情况下安装新套件
2. 不同应用可以使用不同的套件版本
3. 套件升级不影响其他应用

安装： pip install virtualenv

创建： virtualenv /your/path/of/env ，默认情况下，虚拟环境会依赖系统环境中的 site packages ，就是说系统中已经安装好的第三方 package 也会安装在虚拟环境中，如果不想依赖这些package，那么可以加上参数 --no-site-packages 建立虚拟环境

启动虚拟环境： cd /your/path/of/env ， source ./bin/activate ，注意此时命令行会多一个 ENV ， ENV 为虚拟环境名称，接下来所有模块都只会安装到该目录中去。

退出虚拟环境： deactivate

Virtualenv很有用，但是操作较为麻烦（想想你需要来回切换多个ENV），因此可用 Virtualenvwrapper 简化操作：

1. 将所有虚拟环境整合在一个目录下
2. 管理（新增，删除，复制）虚拟环境
3. 切换虚拟环境
4. …

安装： pip install virtualenvwrapper

把下面的代码写入 .bashrc/.zshrc 中：

创建 $HOME/.virtualenvs 目录，以后可在里面创建新的Virtualenv，如果你的Virtualenv不想放在里面，也可以只建立符号链接。

使用：

• 列出虚拟环境列表： workon 或者 lsvirtualenv
• 新建虚拟环境： mkvirtualenv [虚拟环境名称]
• 启动/切换虚拟环境： workon [虚拟环境名称]
• 删除虚拟环境： rmvirtualenv [虚拟环境名称]
• 离开虚拟环境： deactivate

需要注意的是，当你进入ENV后，你所调用的python程序是在 ENV/bin 目录下，因此脚本开头的 #!/usr/bin/python 就没有用了，运行脚本时需要显式调用python解释器。

由于整个ENV目录不适合上传至 github page 的仓库(上传后出现各种 build page error )。 所以我写了个安装ENV的Shell脚本：

切记此脚本只能用 source 运行，不能当成可执行文件运行。因为source是直接在当前shell环境中执行，而可执行文件方式只会在新的子shell下执行（执行到source部份就会出错）

UnicodeEncodeError: 'ascii' codec can't encode characters blalbla

import sys
reload(sys)
sys.setdefaultencoding('utf8')

if len(sys.argv)==1:
print 'No Arguments!'else:
for file in sys.argv[1:]:
if '.html' in file:
hightlight_instance = Pygments_Html(file)
hightlight_instance.colorize()

初始化函数

filename 为代处理的html文件，而 language_dict 则为 org-mode 支持的语言名到 pygments 支持的语言名的映射（因为两者会有细微差异），若org-mode中的语言不为pygments所支持，则映射至 text ，以纯文本方式输出。

注： org-mode 所支持的语言可用 ls /usr/share/emacs/site-lisp/org-mode/ob-* 看到，而 pygments 支持的可在pygments.org/docs/lexers 上看到

高亮函数，对 filename 文件所包含的代码块进行高亮。

Read file：

先读入对应文件流至 file_read ：

RE：

然后从 file_read 提取出包含在 <div class="org-src-container">...</div> 内的html代码：

提取是利用 re 模块进行，正则表达式中 .*? 代表 惰性匹配 ，之所以说是惰性，是因为它会匹配尽可能少的字符，它从第一个字符开始找起，一旦符合条件，立刻保存到匹配集合中，然后继续进行查找。与之相反的是不加 ？ 的 贪婪匹配 。

re.S 是正则表达式的一个 flag ，因为需要寻找的文字跨越多行，若不加这个falg，python的re就只会一行一行地去匹配，若加了这个 flag ，表达式中的 .* 就会匹配包括 \n 在内的换行符。

BeautifulSoup：

接着便要开始对 src_html_list 里的每个元素做处理：

这里利用 BeautifulSoup 对 src_html 包含的html进行解析，这里 soup.find 使用了两个参数，前一个是需要寻找的 tag，后面的 class_ 是 tag 中 class 属性，返回符合这两个条件的一个 soup 对象―― src_soup 。代码块的语言保存在<pre> 的 class 属性中，把它提取出来存在 language 里。

将 language 映射至 pygments 所支持的语言名：

Pygments：

现在可以用 pygments 高亮代码了：

Pygments 是 python 一个用于高亮代码的模快

其中第7行中的 src_soup.text 可以将 soup 对象中的 html tags 全部去掉，只剩下纯文本的原生代码。

highlight 函数有三个参数：第一个是用于高亮的代码串;第二个是 lexer ，用于指定代码语言;第三个是 formatter ，用于指定输出样式。

在这里，指定 formatter 为 HtmlFormatter ，即输出为 html 代码，其中 cssclass 用于指定 div 的样式名字，linespans 指定为 line ，用于指定 <span> 的 id 前缀为 line ，可以用来输出行号 ，输出格式如下：

待会我会为 .hight 设计 CSS ，控制代码及行号样式。

Replace：

src_colorized 现在存储了pygments高亮html代码，需要替换掉原有的：

replace 有两个参数，第一个是需要被替换的旧文本，第二个是新文本。

Rewrite：

for 循环完成后，意味着所有代码已经高亮完毕，可以将新的html重写进去：

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

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

.highlight pre {
counter-reset: linenumbers;
}
.highlight pre > span:before {
font-size: .9em;
color: #aaa;
content: counter(linenumbers);
counter-increment: linenumbers;
text-align: center;
width: 2.5em;
left: -0.5em;
position: relative;
-webkit-touch-callout: none;
-webkit-user-select: none;
-khtml-user-select: none;
-webkit-user-select: none; /* Chrome all / Safari all */
-moz-user-select: none; /* Firefox all */
-ms-user-select: none; /* IE 10+ */
/* No support for these yet, use at own risk */
-o-user-select: none;
user-select: none;
}