現時点の実装仕様

プラグイン定義ファイル(plugin.def)

プラグイン定義ファイルはINIファイル形式で、以下の内容を含む。
文字コードセットはShift_JISまたはBOM付きUTF-8。文字コードセットはBOMの有無で判断する。
=の前後に空白は付けない。

■全プラグイン共通
[Plugin]
Id プラグイン識別子。最大UNICODE63文字の、世界でユニークな文字列。
使用できる文字は、半角英数と「{}._-」のみとする。「,」と「/」は厳禁。
例){A8E7CC0A-032D-11DF-9E9A-333D56D89593}, jp.co.google.foo.BarPlugin, etc..
Name プラグイン和名
Description 簡潔な説明
Type wsh / dll / ...
現在はwshのみ
Author 作者名。Copyright等。
Version バージョン。4個以内の数字を.でつなげたもの。
Url 配布元URL

[Plug]ジャックと呼び出すハンドラの対応表
ジャック名 ハンドラ
※一部のジャックには、Label属性を指定することができる。(Outline, SmartIndent等)
ジャック名.Label ラベル文字列

ジャック一覧参照
例) Outline=xxxxx      ←アウトライン解析時にxxxxxを実行する
   Outline.Label=yyy   ←タイプ別設定の選択肢にyyyが追加される

[Command]本体に追加するプラグインコマンドの定義
C[n] ハンドラ
C[n].Label コマンド名
C[n].Icon アイコンファイル(16x16のBMPファイル)
指定されなかった場合は規定のアイコンで表示される
 (n=1〜49。欠番があるとその後は読み込まれない)

[Option] プラグインオプションの定義
O[n].Section オプションファイル中のSection名(最初のみ必須)
未指定の場合には、直前の値を使用する。
O[n].Key オプションファイル中のKey名(必須)
O[n].Label 表示項目
未指定の場合には、Keyを使用する。
O[n].Type 型、以下に定義する。
未定義、未指定の場合には文字列型として処理する。

Str 文字列型(1024文字まで)
Dir ディレクトリ型(ボタンでディレクトリの指定が可能) (Ver.2.0.9.0以降)
Bool ブール型 True で 1 False で 0 をプラグインオプションに設定する。
Int 整数型(-2147483647〜2147483647、32bit符号付整数)
Sel 選択型(ドロップダウンリストで選択)
選択項目は Select で指定する。

O[n].Default デフォルト値を設定する。 (Ver.2.0.8.0以降)
O[n].Select 選択項目br> 各項目は | で区切り、項目の中で 表示 : 値 の様に設定する。
項目内に : が無かった場合には、項目の値を表示、値の両方に使用する。
例) O[3].Select=自動:0|XML固定:1|XML/XHTML検出:2|XHTML固定:3|HTML固定:6
 (n=1〜99。欠番があっても読み込む)

[String]文字列の定義(sakura 2.1.1.0以降)
S[n] 多言語化のための文字列の定義
 (n=1〜99。欠番があっても読み込む)

■WSHプラグイン固有
・Plug, Command セクションでのハンドラにはスクリプトファイル名を指定する。
 例)パスは個別フォルダ起点の相対パスとする。
  Outline=outline.js
[Wsh]
UseCache 1:ディスクから読み込んだスクリプトをメモリ上にキャッシュする
0:キャッシュしない

■DLLプラグイン固有
・現在未実装
・Plug, Command セクションでのハンドラにはDLLがエクスポートする関数名を指定する。
[DLL]
NameDLLファイル名

■localサブフォルダ内のplugin_<言語名>.def (sakura:2.1.1.0 以降)
・デフォルト言語は、「ja_JP」(local\plugin_ja_JP.def)です。
各定義を言語ごとに上書きすることができます。
 [Plugin]のName, Description, URL
 [Plug]のジャック名.Label
 [Command]のC[n].Label, C[n].Icon
 [Option]のO[n].Label, [n].Select
 [String]のS[n]
に適用されます。
適用する言語は、プロセスの起動時に決定されてエディタが終了するまでその言語のままになります。

ReadMeファイル(readme.txt等)

ファイル名は ReadMe.txt または 個別フォルダ名.txt とする。
プラグインに関する情報を記述する。
必須ではありません。
エディタの「共通設定」「プラグイン」で該当プラグインを選択し、[ReadMe]でこのファイルを表示する。

ZIPプラグイン(XP以降)

プラグイン開発後、plugins配下の個別フォルダを「圧縮(ZIP形式)フォルダー」へ「送る」を実行で配布形式が出来る(XP以降)。
拡張子はzipとする。
WindowsXP以降ではZIPファイルから導入できる。
導入はplugins配下にZIPファイルを置き「新規プラグインを追加」で行うか、
「ZIPプラグインを導入」でファイルを指定し行う。
Windows2000では plugins配下に解凍し導入する。

前へ<  >次へ