ホームページMacソフト欄造>外部ソフトウェア(アドオン)について

外部ソフトウェア(アドオン)について(ver.3)


【はじめに】

○欄造では、テキストデータの読み込み/書き出しに、外部ソフトウェア(以下、アドオン)を用いることが出来ます。
○欄造自身では対応していない、例えば、vCard,iCalendar,exif等を読み込んだり、htmlのTABLE形式で書き出したりすることができるようになります。
○アドオンは、ユーザレベルで自由に作成し、追加することも出来ます。
○本機能は、Mac OS X版のみの機能です。Mac OS 8/9版ではご利用いただけません。
○本機能(ver.3)は、欄造v.1.6以降でご利用になれます。


【利用方法】

○アドオンをインストールします。(注1)
○欄造を起動します。すると「アドオン」メニュー内に、追加したアドオンの名前が表示されるようになります。
○後は通常のテキスト読み込み/書き出しと同じ手順で処理を行います。
(アドオンはバックグラウンドで自動的に起動/終了します。)
注1)GREIF Software提供のアドオンは、専用インストーラにより自動的にセットできます。手動でセットする場合は「ユーザ/<ユーザ名>/ライブラリ/Application Support/欄造/Add-On/」フォルダ内に置きます。(欄造/Add-Onフォルダは初回に作成してください。)

【アドオン・ソフトウェア仕様】

○コンソールアプリケーション(unixターミナルから起動できるバッチ処理プログラム)であれば、形式は問いません。(awk,Perl等でも可)


【アドオン・入出力仕様(第3版)】

○コマンドラインのパラメータを指定しない場合はアドオンの情報を返す。書式は以下の通り。
 ソフトウェア名, バージョン, 種別(import | export), テキストエンコーディング(Shift-JIS | UTF-8 | UTF-16 | JIS | EUC)
(例:vcf2csv,1.0.0,import,UTF-8)
 注)情報が返ってこない場合は、import,Shift-JISとみなします。

<読み込み用アドオン>
○入力データの形式は任意とする。(アドオン側の仕様で決まります。)
○出力データは、
 ・形式はcsv形式とする。
 ・出力先は標準出力とする。(欄造は標準出力からデータを受け取ります。)
 ・テキストエンコーディングは任意とする。(アドオン情報の中で明示します。)
 ・ヘッダの有無は任意とする。(ただし、ドキュメント等に明示することが望ましい。)
○コマンドラインのパラメータは以下の通り。
 ・第1パラメータ:入力データのファイルパス(シェル形式)
 ・第2パラメータ:入力データのテキストエンコード形式
 (例:vcf2csv "/user/hoge/desktop/sample.vcf" "UTF-16")
 注)パラメータはアドオン起動時に欄造から渡されるものです。利用するかどうかはアドオン側で判断して下さい。

<書き出し用アドオン>
○入力データは、
 ・形式はcsv形式とする。
 ・入力元は標準入力とする。(欄造は標準入力にデータを渡します。その際、データの末尾にEOT(0x04)を付加します。)
 ・テキストエンコーディングは任意とする。(アドオン情報の中で明示します。)
 ・ヘッダの有無は任意とする。(ただし、ドキュメント等に明示することが望ましい。)
○出力データの形式は任意とする。(アドオン側の仕様で決まります。)
○コマンドラインのパラメータは以下の通り。
 ・第1パラメータ:出力データのファイルパス(シェル形式)
 ・第2パラメータ:出力データのテキストエンコード形式
 ・第3パラメータ:ヘッダ出力の有無("head":あり、"none":なし、のいずれか。省略時は"head")
 ・第4パラメータ:列の修飾情報(詳細は次項を参照。省略時は全パラメータが記述されない。)
 (例:csv2tbl "/user/hoge/desktop/sample.txt" "UTF-8" "head" "100;center;#FF0000;b;;u,100;left;#000000;;i;")
 注)第3、4パラメータを指定する場合は、それより前のパラメータを省略できません。
 注)パラメータはアドオン起動時に欄造から渡されるものです。利用するかどうかはアドオン側で判断して下さい。


【書き出し用アドオン・列の修飾情報詳細】

○一列分のパラメータの種別および順序は「列幅」「揃え」「文字色」「ボールド」「イタリック」「アンダーライン」
種別 記述形式 対応するタグ表現
列幅 ピクセル数で記述(例:100) WIDTH=
揃え left,center,rightのいずれか(left:左揃え、center:中央揃え、right:右揃え) ALIGN=
文字色 RGB形式で記述(例:#FF0000) <FONT COLOR=
ボールド bを記述 <B>
イタリック iを記述 <I>
アンダーライン uを記述 <U>
○上記パラメータはセミコロンで区切る。
○上記パラメータを省略したい(該当するタグを出力しない)場合は何も記述しない。(セミコロンが連続する)
○上記パラメータを列の数分だけ、カンマで区切って繰り返す。
○例:100;center;#FF0000;b;;u,100;left;#0000CC;;i;,;;#000000;;;


【公開中のアドオン】

vcf2csv
vcf2csv2
csv2tbl




[Home]  [MacSoft]  [Donation]  [History]