``` [language] [title] [url] [link text]
  code snippet
  ```

 ```
 $sudo give me a hug
 ```

1

$sudo give me a hug

example2带有说明和连接

 ``` ruby Discover if a number is prime http://www.noulakaz.net/weblog/2007/03/18/a-regular-expression-to-check-for-prime-numbers/ Source Article
 class Fixnum
   def prime?
     ('1' * self) !~ /^1?$|^(11+?)\1+$/
   end
 end
 ```

产生的代码片段如下：

1
2
3
4
5

class Fixnum
  def prime?
    ('1' * self) !~ /^1?$|^(11+?)\1+$/
  end
end

Gist代码内嵌

当使用这种方式的代码高亮时，仅仅需要的是gist的id，对gist不了解的可以上google搜索下，个人的理解是，gist对每段用户上传的代码段都会有一个对应的id，当用户给出对应的代码的id后，将会从gist上面下载对应的已经高亮的html文件，最终在用户的页面上显示出来。

语法

 { % gist gist_id [filename] %}

example

 { % gist 996818 %}

上述代码的片段在Octopress中的markdown文件中输入之后，得到的效果如下：

如果一个gist的id对应有多个文件，这时需要对想要高亮的文件添加文件名，具体语法如下所示：

  { % gist 1059334 svg_bullets.rb %}
  { % gist 1059334 usage.scss %}

总体来说，gist代码高亮是很简单的，只是需要将代码上传到gist，然后获取相应的id然后按照上面的语法进行设置即可。只是每次在写博客时，都需要对博客文章中的代码拷贝到网址上生成，在没有网时，代码高亮比较麻烦。

从本地文件中引入代码

这种方式在Arch上面有个小问题，在Arch上的报错如下所示：

1
2
3
4
5

Building site: source -> public
  File "<string>", line 1
    import sys; print sys.executable
                        ^
SyntaxError: invalid syntax

上网搜索之后在该网址发现解决方法。
这种方式需要使用python2来完成代码高亮的操作，由于Arch的python指向的是python3，而python3无法完成该功能，因此需要在plugin文件夹中再添加一个新文件，指定在Octopress运行时使用的是python2，具体增加的文件内容如下所示，文件的名字为ruby_python_arch_linux_fix.rb

1
2

require 'rubypython'
    RubyPython.configure :python_exe => 'python2.7'

在完成该操作之后，仍然报错，得到如下错误：

1

LoadError: Could not open library 'lib.so': lib.so: cannot open shared object file: No such file or directory

参考该网址的由elidos提出的解决方法可以知道是rubypython自身的bug，需要修复，具体修改文件在Arch上面为/usr/lib/ruby/gems/1.9.1/gems/rubypython-0.5.3/lib/rubypython/pythonexec.rb，修改位置大概在126行左右，修改后的内容如下所示：

1
2

--126 %x(#{@python} -c "#{command}").chomp if @python
++126 %x("#{@python} -c #{command}").chomp if @python

完成该修改之后，便可以使用这种包含代码的方式来进行代码高亮。
使用这种方式的语法也参见octopress手册，此处不再进行详细说明，这种方式的代码是单独存放成一个文件保存在本地系统下，当代码长度较长，又不想放在博客的正文中时，使用该方法比较好。
简单记录下这种方式的语法如下所示：（目前不知道为什么，在octopress中输入{ %的方式都会进行代码解析，所以上面的{ %都进行了添加了来取消，在实际文章中输入的时候，将取消掉）

{ % include_code [title] [lang:language] path/to/file %}

其中的中括号的内容是可选的，具体语言便是这种方式，当需要强制高亮时，需要指定lang:这个参数，很好用。

使用Code Block的方式

目前自己的博客这种方式用的比较多，前面写的文章目前全部修改成为了这种方式，感觉这种方式和pygnment的方式差不多，之前全部采用的是pygnment的方式，利用正则表达式把所有文章的代码高亮全部改成了使用code block。它的具体语法如下所示：（与pygnment很相似，指定语言即可）

  { % codeblock [title] [lang:language] [url] [link text] %}
  code snippet
  { % endcodeblock %}

和之前描述的类似，中括号的内容是可选的。

使用正则表达式替换

这种方式可以替换博客内容，使得博客中所有文章的代码高亮使用Code Block。自己使用的是sed来完成的操作，似乎都没有用到正则表达式，只是简单的替换，做个简单的记录吧。

替换方法

进入到source/_posts目录下，在终端输入如下代码：

1

sed -n 's/\(\ highlight\ \)/\1/p' *

上面将会把当前目录下的含有{\% highlight的文件的那行都显示出来，中间会将含有该特殊字符的行都打印出来，中间可以看到自己的博客内容都用到了哪些类型文件的语法高亮，将对应的代码高亮进行替换即可。
其实这种方式就是简单的搜索替换，应该算不上使用正则表达式了，只是写下来做下笔记了，防止以后再用具体操作如下所示：

1

sed -i 's/\(\ highlight\ bash %}\)/\ codeblock\ lang:bash\ %}/' *