轻松记录您
灵感和创意

在Markdown使用代码高亮SyntaxHighlighter

经过长达几个小时的折腾,在Markdown使用代码高亮SyntaxHighlighter,几乎不可行。最后使用Google Code Prettify,绕过该问题,详情见博文《在Markdown使用代码高亮Google Code Prettify》。

0. 写在前面

最近打算转到用Markdown写博文(因为Window Live Writer不跨平台,输入数学公式也不方便),Markdown插入代码块是用triple backticks,被解析成

,这与之前在WLW使用PreCode(基于SyntaxHighlighter,其格式形如

)不尽相同。最开始的想法是找到一种方法使两者能兼容,但遇到了不少困难,最后得知Markdown不会处理HTML块级元素(当然也包括

),以为可以直接在Markdown,以

的方式插入代码快。然而,SyntaxHighlighter要求所有在

间的<必须事先替换成HTML实体<,使得在Markdown直接以

…的方式插入代码快几乎不可能。

PROBLEMS: Major issue with this method is that all left angle brackets must be HTML escaped, eg all < must be replaced with < This will ensure correct rendering.

这是之前做的笔记。记录吧不用插件安装SyntaxHighlighter,在Markdown使用SyntaxHighlighter遇到的问题及可能的解决方法,并整理SyntaxHighlighter使用方法,方便日后查阅。

另,SyntaxHighlighter目前最新版本是3.0.9(我也是后来才知道,相对于3.0.83改动很大),整个项目搬到了GitHub,在这里。不过,本文用的是3.0.83(2010年,在这里)。

1. 无插件安装SyntaxHighlighter

可以直接安装wordpress插件SyntaxHighlighter Evolved(事实上,我之前也是这么做的),考虑到自己需要加一些不被该插件支持的语言(比如latex),于是决定手动安装SyntaxHighlighter。

步骤1:下载和定制

在SyntaxHighlighter官网下载,按自已需要将所需文件整理到一个文件夹(如sh),并上传到跟主题或者子主题同目录下(以我为例:themes/radiate-child-01/)。以下文件是必须的:

styles/目录下的shCore.css、shThemeFadeToGrey.css(选个自己喜欢的主题,可以在这里预览主题样式)

scripts/文件下的shCore.js、shAutoloader.js,还有所需语言的javascript(如Python:shBrushPython.js),更多语言的js,可以查看All available brushes(目前已无法访问)

另,默认的代码块,第一行和最后一行贴边框太紧,可以修改shCore.css中的样式,如下:

/** modified in sh/shCore.css directly **/.syntaxhighlighter table {    margin-top: 0.5em !important;    margin-bottom: 0.5em !important;}

步骤2:加载js和css

在functions.php添加必备css样式和js脚本,源代码如下(选个自己喜欢的主题):

function add_sh_styles_scripts() {    wp_enqueue_style( ‘shCore.css’, get_stylesheet_directory_uri() . ‘/sh/shCore.css’ );    wp_enqueue_style( ‘shThemeFadeToGrey.css’, get_stylesheet_directory_uri() . ‘/sh/shThemeFadeToGrey.css’ );     wp_enqueue_script( ‘shCore.js’,  get_stylesheet_directory_uri() . ‘/sh/shCore.js’, array(), false, false);    wp_enqueue_script( ‘shAutoloader.js’,  get_stylesheet_directory_uri() . ‘/sh/shAutoloader.js’, array(), false, false);}add_action( ‘wp_enqueue_scripts’, ‘add_sh_styles_scripts’ );

在footer.php的之前添加如下代码(需要根据所选的语言做一些调整):

值得注意的是,javascript的相对路径是基于当前页面,所以不能直接使用/sh/shBrushPython.js,因为会被解析成http://sparkandshine.net/sample-posts/sh/shBrushPython.js,报“not found”错误。另,如果不是用子主题,获取目录的函数get_stylesheet_directory_uri()可能需要改成get_template_directory_uri()。

2. SyntaxHighlighter配置及使用

(1)配置

可以在上述代码SyntaxHighlighter.all();前加入SyntaxHighlighter配置,详情见这里,举例如下:

SyntaxHighlighter.config.stripBrs = true; SyntaxHighlighter.defaults[‘gutter’] = false;SyntaxHighlighter.defaults[‘html-script’] = true;SyntaxHighlighter.defaults[‘toolbar’] = false; SyntaxHighlighter.all();

(2)使用

实际插入代码,选项hightlight可能会用到比较多,用逗号(遵循csv格式)将要突出的行号分隔开,并用中括号括起来,举例如下:

3. 遇到的问题

3.1 在Markdown使用SyntaxHighlighter

Markdown使用triple backticks插入代码会解析成

,SyntaxHighlighter无法正常解析,因为不符合SyntaxHighlighter的格式

要是直接在Markdown编辑器直接插入

,如果代码块包含<,SyntaxHighlighter也无法正常解析,因为SyntaxHighlighter要求

…间的所有左尖括号<必须先转化成HTML实体,否则会出现匪夷所思的结果(源于SyntaxHighlighter自动匹配左尖括号<),举例如下:

// 好端端的代码

private class MaxPropComparator implements Comparator{    …}

// 会解析成这样(多添加了)

private class MaxPropComparator implements Comparator{    …}

一个可能的方法是事先将所有<转换成<($str = str_replace(‘<‘, ‘<‘, $str);),这样尽管解决了代码高亮问题,但下次编辑博文,看到代码块散落的<,是不是想死的心都有了?

3.2 html-script不可用

将html-script设为true时(SyntaxHighlighter.defaults[‘html-script’] = true;),会提示如下错误:

TypeError: e.brushes.Xml is not a constructor    SyntaxHighlighter

未经允许不得转载:坚果云Markdown编辑器 » 在Markdown使用代码高亮SyntaxHighlighter
分享到: 更多 (0)

坚果云Markdown轻松记录您 灵感和创意

坚果云Markdown下载坚果云Markdown介绍