为SyntaxHighlighter添加新语言的方法

因为经常要在博客里贴一些Lua代码,但是所使用的SyntaxHighlighter插件默认不支持Lua语言,所以去研究了一下如何为SyntaxHighlighter添加并激活一个新的语言,这里将过程和有同样需求的童鞋分享。

上网搜索了一下相关的文章不少,大同小异,本人一直使用的是CKeditor的文字编辑器,所以偿试使用网上很多网友介绍的SyntaxHighlighter配合CKEditor插件的方式实现。可能是因为SyntaxHighlighter和CKEditor版本不同,过程中遇到了一些问题,解决的同时也根据个人理解做部分调整,所以本文所描述的方法仅供参考。
一、SyntaxHighlighter简介
SyntaxHighlighter是一套在浏览器上对各种代码进行语法着色的独立JavaScript库。
下载网站:
脚本之家下载:本文使用的版本是3.0.83版,下载后只需要syntaxhighlighter文件夹下的“scripts”和“styles”文件夹内的文件,在代码语法着色高亮显示的页面引用“styles/shCore.css”样式文件,“scripts/shCore.js”JS文件,因为每一种代码语言都要引用各自的JS文件,为了降低HTTP请求,把所有代码语言的JS文件内容都放到一个“scripts/shBrushSeaYee.js”JS文件里,把所代码写成一行,优化一下。
例如: 复制代码 代码如下: link
rel=”stylesheet” type=”text/css”
href=”/syntaxhighlighter/styles/shCoreDefault.css” / script
language=”javascript” type=”text/javascript”
src=”/syntaxhighlighter/scripts/shCore.js”/script script
language=”javascript” type=”text/javascript”
src=”/syntaxhighlighter/scripts/shBrushSeaYee.js”/script
二、CKEditor简介
CKeditor是一个专门使用在网页上属于开放源代码的所见即所得文字编辑器。它志于轻量化,不需要太复杂的安装步骤即可使用。它可和PHP、JavaScript、ASP、ASP.NET、ColdFusion、Java、以及ABAP等不同的编程语言相结合。它原名FCKEditor,在2009年发布更新到3.0,并改名为CKEditor。原来叫FCK,是因为最初的开发者叫Frederico
Calderia Knabben;现在叫CK,意指”Content and
Knowledge”。据官方的解释,CKEditor是对FCKEditor的代码的完全重写,而且此项工作从2007年就开始了,更新包括:新的用户界面,一个支持Plug-in的Javascript
API,并提供对视觉障碍者的使用支持。 下载网站:
本文使用的版本是3.5.3版,安装配置都比较简单,本文不再赘述。
三、CKEditor代码语法着色高亮显示的插件开发
1、在”ckeditor/plugins/”目录下新建一个”insertcode”目录,然后在”insertcode”目录下新建一个”plugin.js”,输入以下代码:
复制代码 代码如下:
CKEDITOR.plugins.add(‘insertcode’, { init: function(editor) { //plugin
code goes here var pluginName = ‘Insertcode’;
CKEDITOR.dialog.add(pluginName, this.path + ‘insertcode.js’);
editor.config.flv_path = editor.config.flv_path || (this.path);
editor.addCommand(pluginName, new CKEDITOR.dialogCommand(pluginName));
editor.ui.addButton(‘Insertcode’, { label: ‘插入代码’, command:
pluginName, icon: this.path + ‘insertcode.gif’ }); } });
注:第1行代码中“insertcode”必须与文件夹名称相同且区分大小写字母,因为在Linux系统的Web服务器中,路径是区分大小写字母的。
2、”insertcode”目录下放入一个”insertcode.gif”16*16大小的图片,可自己做或上网找。
3、”insertcode”目录下新建一个”insertcode.js”,输入如下代码: 复制代码 代码如下:
CKEDITOR.dialog.add(‘Insertcode’, function(editor){ var escape =
function(value){return value;}; return{ title: ‘插入代码’, resizable:
CKEDITOR.DIALOG_RESIZE_BOTH, minWidth: 720, minHeight: 520, contents:
[{ id: ‘cb’, name: ‘cb’, label: ‘cb’, title: ‘cb’, elements: [{ type:
‘select’, label: ‘Language’, id: ‘lang’, required: true, ‘default’:
‘csharp’, items: [[‘ActionScript3’, ‘as3’]澳门新葡亰娱乐官网,, [‘Bash/shell’, ‘bash’],
[‘ColdFusion’, ‘cf’], [‘C#’, ‘csharp’], [‘C++’, ‘cpp’], [‘CSS’,
‘css’], [‘Delphi’, ‘delphi’], [‘Diff’, ‘diff’], [‘Groovy’,
‘groovy’], [‘JavaScript’, ‘js’], [‘Java’, ‘java’], [‘JavaFX’,
‘jfx’], [‘Perl’, ‘perl’], [‘PHP’, ‘php’], [‘Plain Text’,
‘plain’], [‘PowerShell’, ‘ps’], [‘Python’, ‘py’], [‘Ruby’,
‘rails’], [‘Scala’, ‘scala’], [‘SQL’, ‘sql’], [‘Visual Basic’,
‘vb’], [‘XML’, ‘xml’]] }, { type: ‘textarea’, style:
‘width:718px;height:450px’, label: ‘Code’, id: ‘code’, rows: 31,
‘default’: ” }] }], onOk: function(){ code = this.getValueOf(‘cb’,
‘code’); lang = this.getValueOf(‘cb’, ‘lang’); html = ” + escape(code)

帝国编辑器(FCK)默认是没有插入代码这一功能的,所以一般在添加代码的时候习惯用引用这个功能,可是,这也太不专业了吧?那咋整?就给FCK加一个插件呗。下面就是很有名的SyntaxHighlighter了。

  1. 从这篇博客里寻找所需要的语言:; 2.
    下载对应的shBrushXXX.js脚本,比如我下载的是shBrushLua.js,它看起来像这样:
  • ”; editor.insertHtml(“pre class=/”brush:” + lang + “;/”” + html +
    “/pre”); }, onLoad: function(){} }; });
    4、在”ckeditor/”目录下找到“config.js”文件,这是CKEditor的配置文件,添加如下代码:
    复制代码 代码如下:config.extraPlugins =
    ‘insertcode’;
    注:代码中“insertcode”也必须与文件夹名称相同,区分大小写字母。
    要在CKEditor工具栏添加按钮就在此配置文件中添加上“,Insertcode”,依然要注意区分大小写字母。至此就大功造成了。

首先大家可以去官网下载最新版,但是下载下来并不是就能用,还要进行一些配置,对新手来说是比较有难度的。这里可以直接使用恨雪提供的已经配置好的版本(2.1.382版本),本教程也是依据该版本而进行。

复制代码
代码如下:SyntaxHighlighter.brushes.Lua = function(){var keywords =’break
do end else elseif function if local nil not or repeat return and then
until while this’;var funcs = ‘math//.//w+ string//.//w+ os//.//w+
debug//.//w+ io//.//w+ error fopen dofile coroutine//.//w+ arg
getmetatable ipairs loadfile loadlib loadstring longjmp print rawget
rawset seek setmetatable assert tonumber tostring’;

 下载地址:

this.regexList = [{ regex: new
RegExp(‘–//[//[[//s//S]*//]//]–‘, ‘gm’),css: ‘comments’ },{
regex: new RegExp(‘–[^//[]{2}.*$’, ‘gm’), css: ‘comments’ },// one
line comments{ regex: SyntaxHighlighter.regexLib.doubleQuotedString,
css: ‘string’ }, // strings{ regex:
SyntaxHighlighter.regexLib.singleQuotedString, css: ‘string’ }, //
strings{ regex: new RegExp(this.getKeywords(keywords), ‘gm’),css:
‘keyword’ },// keyword{ regex: new RegExp(this.getKeywords(funcs),
‘gm’), css: ‘func’ },// functions];}

下载解压后是两个文件夹:

SyntaxHighlighter.brushes.Lua.prototype= new
SyntaxHighlighter.Highlighter();SyntaxHighlighter.brushes.Lua.aliases =
[‘lua’];

澳门新葡亰娱乐官网 1

3.
使用FTP工具登陆到WordPress空间,进入到wp-content/plugins目录,新建一个目录,取一个有意义的名字,比如syntaxhighlighter-lua;4.
将shBrushLua.js上传到新创建的目录;5.
在该目录创建一个另一个shBrushLua.php文件,添加如下内容:

第一,上传SyntaxHighlighter2.1.382这个文件夹到网站根目录,或者其他你喜欢的地方,也可以重命名该文件夹,但是在后面模板文件中调用CSS和js的时候路径要对,这里我就传到根目录吧。

复制代码 代码如下:?php/*Plugin Name:
SyntaxHighlighter Evolved: Lua Description: Adds support for the Lua
language to the SyntaxHighlighter Evolved plugin.Author: Benny Version:
1.0.0*/// SyntaxHighlighter Evolved doesn’t do anything until early in
the “init” hook, so best to wait until after thatadd_action( ‘init’,
‘syntaxhighlighter_lua_regscript’ );// Tell SyntaxHighlighter Evolved
about this new language/brushadd_filter( ‘syntaxhighlighter_brushes’,
‘syntaxhighlighter_lua_addlang’ );// Register the brush file with
WordPressfunction syntaxhighlighter_lua_regscript() {
wp_register_script( ‘syntaxhighlighter-brush-lua’, plugins_url(
‘shBrushLua.js’, __FILE__ ), array(‘syntaxhighlighter-core’),
‘1.1.1’ );}// Filter SyntaxHighlighter Evolved’s language arrayfunction
syntaxhighlighter_lua_addlang( $brushes ) { $brushes[‘lua’] = ‘lua’;
return $brushes;}?

第二,把以下代码加到内容模板,这里就要注意第一步了。

6.
文件都准备完了,OK,进入到WordPress后台管理的Plugins下,应该能看到新添加的一项syntaxhighlighter-lua,激活它。

复制代码代码如下:

Done! It should work now!

值得一提的是,上面的这些shBrushSql.js之类的JS,并不是固定要调用这些的。这些JS都有其含义(brushes),可以看官方的文档。因为我比较经常用到css、html、php、sql,所以我就只写上面所示的js即可。当然,如果你愿意,你可以把全部的都调用上去。但是那样会很慢哦。但是,假设你没有调用php的,当你在插入代码的时候,语言选择php,那么在前台,会提示错误。(shCore.js一定要有,不然前台会没有效果)

其实新添加的js和php文件也可以放到SyntaxHighlighter插件本身的目录下,但是让它独立成插件的好处是,当SyntaxHighlighter升级时,你的个人配置不会因为覆盖而丢失。

第三,把“syntaxhighlight2”这个文件夹传到“e/admin/ecmseditor/infoeditor/editor/plugins”目录下,也就是说,这是FCK编辑器的一个插件。

第四,修改一下FCK编辑器的配置文件,需要编辑器添加一下插件和按钮。

1,后台配置文件路径:/e/admin/ecmseditor/infoeditor/fckconfig.js

2,前台配置文件路径:/e/data/ecmseditor/infoeditor/fckconfig.js

找到FCKConfig.PluginsPath = FCKConfig.BasePath + ‘plugins/’ ;     
大概在51行

在下面插入

复制代码代码如下:
FCKConfig.Plugins.Add(‘syntaxhighlight2′,’zh-cn’);
// default language options:
c++,csharp,css,delphi,java,jscript,php,python,ruby,sql,vb,xhtml
FCKConfig.SyntaxHighlight2LangDefault =’c++’;

然后找到’InsertTBr’],在  ‘InsertTBr’  后面输入   ,’SyntaxHighLight2’。

这样就算是完成了,编辑器的界面大致如下:

澳门新葡亰娱乐官网 2

前台效果大致如下:

澳门新葡亰娱乐官网 3

You can leave a response, or trackback from your own site.

Leave a Reply

网站地图xml地图