PukiWiki/自作プラグイン/prettify

prettify.inc.php †

目次 †

• 概要
• サンプル
• インストール
• 使い方
• 設定
• ライセンス
• ダウンロード
• 更新履歴
• 備考

概要 †

• 様々な言語のソースコードを構文ハイライトして表示します
• 内部で google-code-prettify を利用しています
• C や Bash や XML に構文が似た多くの言語に対応しています
• オリジナルの google-code-prettify が Internet Explorer でうまく動作しないのを修正してあります *1
• PukiWiki の本体やスキンを書き換える必要はありません

すべての整形済みテキストが自動的にハイライトされるよう、PukiWiki を改造する方法もあるようですが、

• PukiWiki 本体を書き換えずに使いたい
• 整形済みテキストのうち一部だけハイライトさせたい

といった場合には有用だと思います。

サンプル †

PHP のコードを構文ハイライトして表示した例を以下に示します。

<?php

/**
 * phphighlight.inc.php - Syntax highlighting using highlight_string() function
 *
 * @author      revulo
 * @licence     http://www.gnu.org/licenses/gpl.html  GPLv2
 * @link        http://www.revulo.com/PukiWiki/Plugin/PHPHighlight.html
 */

function plugin_phphighlight_convert()
{
    $args   = func_get_args();
    $source = rtrim(end($args));
    $html   = highlight_string($source, true);

    $before = array(
        ">\n<",
        '<font color="',
        'font>',
        'code>',
    );
    $after = array(
        '><',
        '<span style="color: ',
        'span>',
        'pre>',
    );
    return str_replace($before, $after, $html);
}

?>

インストール †

prettify.inc.php プラグインのアーカイブファイルをダウンロードし、 PukiWiki をインストールしてあるディレクトリで展開します。

$ tar xvfz prettify-1.0.tar.gz

次に、不具合を修正した google-code-prettify を作りましたので、これもダウンロードして下さい。 展開して出てきたファイルは、PukiWiki の skin/prettify ディレクトリにコピーして下さい。

$ cd skin/prettify
$ unzip prettify-14-Jul-2008_revulo.zip

あとは pukiwiki.ini.php の設定を以下のように変更して下さい。

define('PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK', 0);

使い方 †

書式は次のようになっています。

#prettify{{
  ……
  ソースコード
  ……
}}

これで google-code-prettify が、 何の言語のコードなのかを自動的に識別し、構文ハイライトして表示してくれます。

設定 †

prettify.inc.php の先頭部分で以下の値を設定することで、カスタマイズができます。

PLUGIN_PRETTIFY_LIB_URI

google-code-prettify がインストールされているディレクトリ

また、skin/prettify/prettify.css ファイルを書き換えれば、表示される色を変更できます。

ライセンス †

• プラグイン本体: GPL
• google-code-prettify: Apache License 2.0

ダウンロード †

• プラグイン本体
  • prettify-1.0.tar.gz

• IE での不具合を修正した google-code-prettify
  • prettify-14-Jul-2008_revulo.zip

更新履歴 †

• Version 1.0 (2008/11/02)
  • 初公開

備考 †

同様の機能を持つプラグインが他にもあるのでまとめておきます。

最新の20件

     

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.3.29. HTML convert time: 0.044 sec.

Skin by YEAR OF THE CAT