はじめに

「SyntaxHighlighter TinyMCE Button」は、「ビジュアルエディター（TinyMCE）」のメニューに「SyntaxHighlighter」のための<pre>タグの入力を手助けするボタンを追加します。

ビジュアルエディター（TinyMCE）上でも、簡単にソースコードを<pre>タグでマークアップ出来るようになります。

= 特徴 =
・必要な操作は、ビジュアルエディターで完結できる。HTMLエディターを使う必要がない。
・２つの方法で、<pre>タグを「ビジュアルエディター」から簡単にソースコードに挿入する事が可能。
・<pre>タグでマークアップ済みのソースコードの言語やオプションの変更が可能。
・一度、<pre>タグでマークアップすれば、ソースコードをTABでインデント出来る。
・表示言語は、英語および日本語。

= 対応プラグイン =

動作の確認がとれた「SyntaxHighlighter」ベースのプラグインの一部です。

・WP SyntaxHighlighter http://wordpress.org/extend/plugins/wp-syntaxhighlighter
・Syntax Highlighter Compress http://wordpress.org/extend/plugins/syntax-highlighter-compress/
・Auto SyntaxHighlighter http://wordpress.org/extend/plugins/auto-syntaxhighlighter/
・Syntax Highlighter and Code Colorizer for WordPress http://wordpress.org/extend/plugins/syntax-highlighter-and-code-prettifier/
・Syntax Highlighter MT http://wordpress.org/extend/plugins/syntax-highlighter-mt/

※"WP SyntaxHighlighter"と"Syntax Highlighter Compress"に最適化された動作モードを設定画面で選択できます。

= ご注意 =

このプラグインは、Alex Gorbatchev氏が開発した「SyntaxHighlighter」ライブラリーのバージョン2.0以上に対応しています。

SyntaxHighlighter: http://alexgorbatchev.com/SyntaxHighlighter/

「SyntaxHighlighter」ライブラリーを使用するプラグインであっても、<pre>タグをサポートしていない場合があります。
このプラグインは、<pre>タグをサポートしないプラグインに対しては使用できません。

１．動作環境

・WordPress3.0以上

２．インストール

・ダウンロードしたファイルを解凍し、「sh-tinymce-button」フォルダごと、WordPressのプラグインディレクトリ（wp-content/plugins/）にアップロードします。
・WordPressの管理画面の「プラグイン」で、このプラグインを有効化します。
・WordPressの管理画面の「設定」にある「SH TinyMCE Button」という項目で設定を行います。
※「WP SyntaxHighlighter」または「Syntax Highlighter Compress」を使用している場合は、設定画面で設定を行ってください。

３．アップデート
・WordPressの管理画面で、「SyntaxHighlighter TinyMCE Button」を停止する。
・インストールの要領でファイルをサーバーにアップロードし、上書きする。
・WordPressの管理画面で、再度、プラグインを有効化する。

４．アンインストール

・WordPressの管理画面で、まずプラグインを停止。
・続いて、削除を実行する。

５．使い方

投稿やページ上に既にあるソースコードをハイライト表示させたい場合。

・ハイライト表示させるソースコードを選択し、反転表示させる。
・「pre」ボタンをクリックする。
・言語とオプションを選択する。
・「挿入」ボタンをクリックする。

ソースコードを投稿やページにペーストしたい場合。

・「CODE」ボタンをクリックする。
・言語とオプションを選択し、ソースコードをテキストボックスにペーストする。
・「挿入」ボタンをクリックする。

ハイライト表示済みのソースコードの言語やオプションを変更したい場合。

・設定を変更したいソースコードを選択し、反転表示させる。
・「pre」ボタンをクリックする。
・言語とオプションを変更する。
・「更新」ボタンをクリックする。

ソースコードをタブでインデントさせる場合

・単にTABを入力します。ただし、<pre>タグでマークアップ済みのソースコードでなければ、TABによるインデントは有効になりません。

６．よくある質問

Q.「pre」ボタンを使って言語とオプションを変更するため、コードを選択、反転表示しようとしましたが、コード全体が選択出来ません。

A.全体を選択する必要はありません。コードの最初の１行が選択出来れば十分です。

Q.バージョンアップしたところ、ボタンが正常に動作しなくなりました。

A.古いバージョンのJavaスクリプトファイルがキャッシュされている可能性があります。ブラウザのキャッシュを消去するか、キャッシュが保存されているフォルダから、古いJavaスクリプを削除して下さい。

Q.「html-scripts」オプションを使用したところ、エラーになりました。

A.「html-scripts」オプションは、「XML」ブラシに依存していますが、Alex Gorbatchev氏の「SyntaxHighlighter」をベースにしたプラグインの中には、デフォルトで「XML」ブラシを読み込んでいないものも存在します。このオプションを使用する必要がある場合は、「html-scripts」対応した「WP SyntaxHighlighter」の使用も検討して下さい。
WP SyntaxHighlighter http://wordpress.org/extend/plugins/wp-syntaxhighlighter/

Q.フルスクリーンモードで「pre」が動作しません。

A.フルスクリーンモードでは、「pre」ボタンは、言語とオプションの更新のためだけに使用出来ます。ソースコードの挿入は「CODE」ボタンで行って下さい。

７．ライセンス

GPL v2

８．このプラグインが気に入ったら

寄付は求めておりませんが、仙台の友人が手作りの手帳を制作していますので、こちらをご注文頂けたり、お友達に宣伝して頂けましたら助かります。

日本語: http://www.ab.auone-net.jp/~design.y/
英語: http://design-y.near-mint.com/

９．履歴

2011/5/21　バージョン0.4 リリース
 ※「WP SyntaxHighlighter」と「Syntax Highlighter Compress」に最適化された動作モードを追加。
 ※ポップアップウィンドウに新しいオプションを追加。
 ※フルスクリーンモードで「CODE」ボタンが動作しない問題を修正。

2011/5/16　バージョン0.3 リリース
 ※ポップアップウィンドウに新しいオプションを追加。

2011/5/13　バージョン0.2.2 リリース
 ※「Auto SyntaxHighlighter」との競合を避けるためフックの優先度を変更。

2011/5/12　バージョン0.2.1 リリース
 ※タブフォーカス関連のソースコードを整理。
 ※日本語の訳文を変更。（shtb_adv_lang-ja.moを修正。）
 ※ポップアップウィンドウ内に表示されるボタンラベルの翻訳を完成。
 ※ポップアップウィンドウ内に表示されるボタンの配置を変更。

2011/5/10　バージョン0.2 リリース
 ※タブを維持したままソースコードをペースト出来る「CODE」ボタンを追加。
 ※マークアップ済みソースコードの言語やオプションの変更が可能になった。

2011/5/1　バージョン0.1.1 リリース


Redcocker
http://www.near-mint.com/blog/