Code Syntax Highlighter Plugin for TiddlyWiki

落日映苍穹つ 2022-06-18 01:19 81阅读 0赞

最近要给 PHPRPC 站做文档，打算使用 Wiki 系统，为了便于网站搬家和方便用户下载文档，所以选择了 TiddlyWiki，TiddlyWiki 是一个纯 HTML 的 Wiki 系统，而且支持插件，超级棒！不过从网上找了 2 天，也没有找到合适的代码加亮插件，有一个 [Plugin: Syntaxify][Plugin_ Syntaxify] 只支持 css，js 和 xml，而且效果还不是很理想。正好想到有个 [dp.SyntaxHighlighter ][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、最后不要忘记保存变更，否则你做的一切工作就白费了。  
  
插件安装后的效果：  
  
  
用法很简单，用

语法：

1.  <code options>  
2.  your code  
3.  </code>

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

示例：

1.  <code java:showcolumns:firstline\[10\]>    
2.  public class HelloWorld \{    
3.      public static void main(String args\[\]) \{    
4.          System.out.println("HelloWorld!");    
5.      \}    
6.  \}    
7.  </code>

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

[Plugin_ Syntaxify]: http://bob.mcelrath.org/syntaxify.html
[dp.SyntaxHighlighter]: http://code.google.com/p/syntaxhighlighter/
[syntaxhighlighterplugin.zip]: http://coolcode.org/attachment.php?id=8