Code Syntax Highlighter Plugin for TiddlyWiki

最近要给 PHPRPC 站做文档，打算使用 Wiki 系统，为了便于网站搬家和方便用户下载文档，所以选择了 TiddlyWiki，TiddlyWiki 是一个纯 HTML 的 Wiki 系统，而且支持插件，超级棒！不过从网上找了 2 天，也没有找到合适的代码加亮插件，有一个 Plugin: Syntaxify 只支持 css，js 和 xml，而且效果还不是很理想。正好想到有个 dp.SyntaxHighlighter 项目是纯 js 实现的代码加亮库，于是就决定用它来做一个 TiddlyWiki 的代码加亮插件了。我搜集了目前我能找到的所有支持用 dp.SyntaxHighlighter 加亮的语言文件（shBrush*.js），所以这个插件支持的语言比 dp.SyntaxHighlighter官方提供的还要多，支持的语言（包含别名）有：

as, as3, actionscript, bash, sh, batch, dos, coldfusion, cf, cpp, c, c++, c#, c-sharp, csharp, css, delphi, pascal, java, js, jscript, javascript, lua, mxml, perl, php, py, python, ruby, rails, ror, sql, vb, vb.net, xml, xhtml, xslt, html

下载：syntaxhighlighterplugin.zip

安装方法很简单：

1、把 clipboard.swf 放到跟 TiddlyWiki 页面同一个目录下。
2、在 TiddlyWiki 中建立一个新的文章(Tiddler)，命名为：StyleSheetSyntaxHighlighter，将 SyntaxHighlighter.css 文件内容复制进去，保存。
3、打开主题为 StyleSheet 的文章（就在你刚建立的文章上可以看到链接）编辑，将 [[StyleSheetSyntaxHighlighter]] 加到这篇文章中保存。
4、再新建一篇文章，命名为：SyntaxHighlighterPlugin，将 shPlugin.js 中的内容复制进去保存，就可以看到插件的效果了。
5、最后不要忘记保存变更，否则你做的一切工作就白费了。

插件安装后的效果：


用法很简单，用

语法：

 

<code options>
your code
</code>

就可以了。

其中 options 为语言和显示选项，其中语言必须放在第一位，后面的选项用:分割，支持的选项有nocontrols，collapse，showcolumns 和 firstline，其中 firstline 选项用 [num] 来指定开始行号。例如：

示例：

 

<code java:showcolumns:firstline[10]>
public class HelloWorld {
    public static void main(String args[]) {
        System.out.println("HelloWorld!");
    }
}
</code>

就表示，以 Java 语言格式加亮，显示横标尺，并且行号从 10 开始。