Peggy アクセサリ集

■ ユーザツールアクセサリ
　　・PeggyとLaTeXを使ってDestTopPublishing
　　・COBOL用リナンバスクリプト
　　・HTML文法チェッカ

■ ルネサス開発サポートツール用統合化開発環境
　　・TM V.3.10での設定例

■ ユーザツールアクセサリ

このコーナーでは、Peggy/PeggyProのユーザツールとして登録することでエディタ機能を拡張できる便利なプログラムやスクリプトを紹介します。

　PeggyとLaTeXを使ってDestTopPublishing

タイトル内容設定 Download
PeggyとLaTeXを使ってDestTopPublishing PeggyとフリーソフトでPDFファイルを生成する環境を作成する。
サンプルKITをダウンロードしてください。
PeggyとLaTeXを使って、Desk Top Publishing 環境を作成する方法です。
一般的にPDFファイルを生成するには、AdobeSystems社のAcrobat、Illustratorなどの製品をインストールする必要があります。しかしながら、個人のPCや、会社でも各自のPCにすべてAcrobatなどを導入することは経済的に難しいことと思います。市販のソフトウエアを使えばWYSIWYG環境でDTPが可能ですが、ここでは、各社から提供されているフリーソフトや、GNUを使い、最終的にPDFファイルを生成します。

● まずは準備 Peggy以外に以下のソフトウエアをインストールしてください。１：pLaTeX ２：GhostScript ３：dviout for Windows ４：Adobe Acrobat Reader Bitmapなどの図も扱いたい時は、以下もインストールします。４：GSView ５：Adobe PSプリンタドライバこれらに必要な環境変数の例です。 PATH = E:\usr\local\bin;E:\gs\gs6.50\bin;E:\dviout GS_LIB = E:/gs/gs6.50/lib;E:/gs/gs6.50/kanji;E:/gs/fonts TEXMFCNF = E:/usr/local/share/texmf/web2c TEXMFMAIN = E:/usr/local/share/texmf

これらソフトウエアは、以下のサイトや、他に多くのサイトで紹介されていますので、検索エンジンで検索・参照してください。 TeXに関する多くの情報が公開されています。

● 入手先 Ghostscript 6.50 + GSview 3.6 の日本語版 Kohsaku Hotta 氏 http://auemath.aichi-edu.ac.jp/~khotta/ghost/index.html pTeX の Win32版角藤亮(かくとうあきら)氏 http://www.fsci.fuk.kindai.ac.jp/~kakuto/ dviout for Windows Oshima Laboratory 氏 http://akagi.ms.u-tokyo.ac.jp/index-j.html PSプリンタドライバ AdobeSystems社 http://www.adobe.co.jp/products/printerdrivers/

【ヒント】 奥村晴彦氏著書「LaTeX2e 美文書作成入門」（技術評論社）には、インストーラ付きのCDが付録されています。また、LaTeXについて詳しく解説されていますので、LaTeXを始められる方はぜひとも入手したい一冊です。
奥村晴彦氏 http://oku.edu.mie-u.ac.jp/~okumura/

● Peggyのプロジェクト作成
１：サンプルの <sample.exe> をダウンロードしてください。（中に、Peggyのプロジェクトファイル、TeX文章ソース、サンプル画像や、実際に作成したPDFファイルが入っています。）
２：適当なフォルダで解凍してください。
３：Peggyを起動し、サンプルの <TeX.peg> を開いてください。
【注意】ファイル移動ダイアログボックスが表示されますので、[すべて移動先] を選択してください。

● 実行
１：プロジェクトウインドウに表示されている、<ex1.tex> をダブルクリックし、エディタ部に表示させます。
２：ユーザ定義ツールの２番に <tex2pdf.bat> が登録されていますので、ユーザ定義ツールの２番をクリックすれば、<ex1.tex> がコンパイルされ <ex1.dvi> が出力されます。その後 dviout が起動し、dvi ファイルとして表示されます。
platex -c-style-errors "%1.tex"
if errorlevel 1 exit 1
dviout "%1.dvi"
【注意】<tex2pdf.bat>への引数 %1 は、エディタ部でフォーカスを持っているファイルです。
【参照】<tex2pdf.bat>

３：dviout を終了すれば、自動的に続けて、dvipsk が起動し、 dviファイルを ps ファイルに変換、続けて ps2pdf が psファイルを pdfファイルに変換します。
dvipsk %1.dvi
ps2pdf %1.ps %1.pdf
【注意】ここでは、毎回PDFファイルまで作成していますが、必要に応じて<tex2pdf.bat>ファイルを編集してください。

４：エクスプローラ等で、生成された <ex1.pdf> をダブルクリックすれば、AcrobarReader が起動し、PDFファイルとして表示されます。
この手順で、<ex1.tex> をご自分の文章に置きかえれば、簡単にPDFファイルを作成できるようになります。後は、TeXの組版コマンドを自由に操れるようになればDTPソフトと同じように文章をデザインすることができます。

● フォントの問題
欧文を奇麗に表示するには、TeXソースのプリアンブル部におまじないとして
\usepackage{times}
\usepackage[T1]{fontenc}
\normalfont
\usepackage{mathptm}
【参照】サンプルの<ex1.tex>
と書いておけば問題ありません。最後のmathptmは、数学記述に対するもので通常は必要ありません。フォントの変更等詳しく知りたい方は該当サイトや著書等を参照してください。
日本語PDFにはベクタフォントが組み込まれないので、PDFファイルを大きく拡大すればぎざぎざが見えてしまいます。ただ、常識的な拡大率でPDFファイルを見る場合や、600DPI程度のプリンタで印刷する分には、まず問題ありません。
どうしても日本語フォントも奇麗に表示したければ、VECTORフォントをPDFファイルに組み込むか、または、ビットマップフォントの組み込みを避ければよいことになります。弊社で実験したところ、AdobeSystems社の Distiller を通して、 PSからPDFにすればフォントが組み込まれずにAcrobatReaderで見たところ、代替フォントで奇麗に表示されました。が、Distillerは、AcrobatなどのAdobe製品を購入しなければなりません。
● ビットマップなどの図を取り込む方法
TeXソースは、単純なテキストファイルですから、bmp、jpeg、giffなどの画像データをそのまま貼り付ける訳にはいきません。画像を扱うことに関しては、市販のWYSIWYG環境のソフトウエアのように簡単には行きません。コツを覚えれば意外と使えます。
１：まず、TeXソースのプリアンブル部に
\usepackage[dvips]{graphicx} と記述します。
【参照】サンプルの<ex1.tex>
２：ペイント（その他、Word、Excel、ドローソフトなど）で、目的のファイルを開きます。
３：印刷メニューを選択し、[Default PostScript Printer]を選択して、[プロパティ]を開きます。
４：[PostScriptオプション]の[PostScript出力オプション]で、[カプセル化されたPostScript(EPS形式)]を選択します。
５：[ファイルへ出力]をチェックして実行します。ファイル名は、の拡張子は、<xxx.ps> にします。
６：GSViewを実行し、<xxx.ps> を開きます。
７：マウスカーソルをトリミングする画像部の左下へ移動し、その座標値を記録します。同じく、必要な画像の右上へ移動し、その座標値を記録します。【例】左下(53,689),右上(266,788)
８：<xxx.ps>をエディタで開き、%%BoundingBox: を探し、そこにある数値を先ほど記録したトリミングする値に書き換え保存します。
【例】%%BoundingBox: 18 23 577 819 （この元々の値は、ファイルへ印刷したときの用紙サイズ、例えばA4など、の外接座標になっています。左下が(0,0) ）これを%%BoundingBox: 53 689 266 788 と書き換えます。
これで、必要な画像部分を指定したEPSファイルができています。
９：TeXソースの必要な部分に以下のコマンドでEPSファイルを取り込みます。
\includegraphics[clip]{xxx.ps}
サンプルKIT texsampl.exe

LaTeX言語サポートDLLは、対応言語一覧から

PeggyとLaTeXで作成したPDFの例 （実際のPDFファイルはここ）
文章中の商品名は、各社の商標、登録商標です。

　COBOL用リナンバスクリプト

タイトル内容記述言語設定 Download
COBOL用リナンバスクリプト COBOLソースのシーケンス番号を任意の初期値、ステップで番号を振り直す Perlスクリプト # Usage: perl.exe renum.pl ファイル名 [初期値 [増分]]

このスクリプトファイルのプロパティの[実行]ページを
以下のように設定することで、編集しているCOBOLソース
ファイルのリナンバを行う。

[実行方法]ページの設定
  コマンド: perl.exe
  実行フォルダ: $c
  引数: "$p"$b" $1 $2
  その他 [X] 実行後に変化したファイルを読み直す

アドホックパラメタの設定 (引数の右の [...] ボタンをクリック)
  タイトル: COBOLリナンバ
  $1ラベル: 初期値(&B):
  $1デフォルト値: 10
  $2ラベル: 増分(&I):
  $2デフォルト値: 10

あとは実行しやすいようにツールボタンへ割り当てておけば完璧。
COBOLのソースファイルを開いて、ボタンをクリックするだけ!! renum.pl

　HTML文法チェッカ

タイトル内容記述言語設定
HTML用文法チェックスクリプト Peggyで記述中のHTMLファイルの文法をチェックし、エラーがあればF4キーでタグジャンプできます。 Perlスクリプト
ここで紹介するHTML文法チェッカは、石野恵一郎さんがフリーで提供されている Another HTML-lint for Win です。

まず、Vectorなどからhtmllintをダウンロードします。
VectorのAnother HTML-lint for Win紹介ページ・ダウンロード
ダウンロードしたファイルを適当なフォルダに解凍します。
jcode.pl が必要ですが、もし、解凍ファイルに入っていなければ解凍ディレクトリにコピーしてください。（jcode.pl ダウンロード）
エクスプローラで、解凍フォルダの htmllint （拡張子なし）をPeggyのプロジェクトウインドウの適当な場所にドラッグ＆ドロップします。
htmllint のプロパティを開き以下のように設定します。

[ファイル]ページの設定
  タイプ: スクリプト
  ツールアクション: 適当な番号な番号を選んで、[実行する]を選択
[実行方法]ページの設定
  コマンド: perl.exe
  実行フォルダ:
  引数: "$p" -x html401t "$a"
-x のパラメータは、Another HTML-lint for Winを解凍したフォルダの <index.html> を見てください。 -x html401t は、HTML 4.01 でチェックします。

OKでプロパティを閉じます。
チェックしたいHTMLファイルを編集し、割り当てたボタンをクリックすれば、アウトプットウインドウに結果が出力されます。また、エラーがあれば、F4キーを押すことでタグジャンプできます。

チェック結果例（Peggyアウトプットウインドウ）

タイトル	内容	設定	Download
PeggyとLaTeXを使ってDestTopPublishing	PeggyとフリーソフトでPDFファイルを生成する環境を作成する。	サンプルKITをダウンロードしてください。 PeggyとLaTeXを使って、Desk Top Publishing 環境を作成する方法です。一般的にPDFファイルを生成するには、AdobeSystems社のAcrobat、Illustratorなどの製品をインストールする必要があります。しかしながら、個人のPCや、会社でも各自のPCにすべてAcrobatなどを導入することは経済的に難しいことと思います。市販のソフトウエアを使えばWYSIWYG環境でDTPが可能ですが、ここでは、各社から提供されているフリーソフトや、GNUを使い、最終的にPDFファイルを生成します。 ● まずは準備 Peggy以外に以下のソフトウエアをインストールしてください。１：pLaTeX ２：GhostScript ３：dviout for Windows ４：Adobe Acrobat Reader Bitmapなどの図も扱いたい時は、以下もインストールします。４：GSView ５：Adobe PSプリンタドライバこれらに必要な環境変数の例です。 `PATH = E:\usr\local\bin;E:\gs\gs6.50\bin;E:\dviout` `GS_LIB = E:/gs/gs6.50/lib;E:/gs/gs6.50/kanji;E:/gs/fonts` `TEXMFCNF = E:/usr/local/share/texmf/web2c` `TEXMFMAIN = E:/usr/local/share/texmf` これらソフトウエアは、以下のサイトや、他に多くのサイトで紹介されていますので、検索エンジンで検索・参照してください。 TeXに関する多くの情報が公開されています。 ● 入手先 Ghostscript 6.50 + GSview 3.6 の日本語版 Kohsaku Hotta 氏 http://auemath.aichi-edu.ac.jp/~khotta/ghost/index.html pTeX の Win32版角藤亮(かくとうあきら)氏 http://www.fsci.fuk.kindai.ac.jp/~kakuto/ dviout for Windows Oshima Laboratory 氏 http://akagi.ms.u-tokyo.ac.jp/index-j.html PSプリンタドライバ AdobeSystems社 http://www.adobe.co.jp/products/printerdrivers/ 【ヒント】奥村晴彦氏著書「LaTeX2e 美文書作成入門」（技術評論社）には、インストーラ付きのCDが付録されています。また、LaTeXについて詳しく解説されていますので、LaTeXを始められる方はぜひとも入手したい一冊です。奥村晴彦氏 http://oku.edu.mie-u.ac.jp/~okumura/ ● Peggyのプロジェクト作成１：サンプルの <`sample.exe`> をダウンロードしてください。（中に、Peggyのプロジェクトファイル、TeX文章ソース、サンプル画像や、実際に作成したPDFファイルが入っています。）２：適当なフォルダで解凍してください。３：Peggyを起動し、サンプルの <`TeX.peg`> を開いてください。【注意】ファイル移動ダイアログボックスが表示されますので、[すべて移動先] を選択してください。 ● 実行１：プロジェクトウインドウに表示されている、<`ex1.tex`> をダブルクリックし、エディタ部に表示させます。２：ユーザ定義ツールの２番に <`tex2pdf.bat`> が登録されていますので、ユーザ定義ツールの２番をクリックすれば、<`ex1.tex`> がコンパイルされ <`ex1.dvi`> が出力されます。その後 dviout が起動し、dvi ファイルとして表示されます。 `platex -c-style-errors "%1.tex"` `if errorlevel 1 exit 1` dviout "%1.dvi" 【注意】<`tex2pdf.bat`>への引数 `%1` は、エディタ部でフォーカスを持っているファイルです。【参照】<`tex2pdf.ba`t> ３：dviout を終了すれば、自動的に続けて、dvipsk が起動し、 dviファイルを ps ファイルに変換、続けて ps2pdf が psファイルを pdfファイルに変換します。 `dvipsk %1.dvi` `ps2pdf %1.ps %1.pdf` 【注意】ここでは、毎回PDFファイルまで作成していますが、必要に応じて<`tex2pdf.bat`>ファイルを編集してください。４：エクスプローラ等で、生成された <`ex1.pdf`> をダブルクリックすれば、AcrobarReader が起動し、PDFファイルとして表示されます。この手順で、<`ex1.tex`> をご自分の文章に置きかえれば、簡単にPDFファイルを作成できるようになります。後は、TeXの組版コマンドを自由に操れるようになればDTPソフトと同じように文章をデザインすることができます。 ● フォントの問題欧文を奇麗に表示するには、TeXソースのプリアンブル部におまじないとして `\usepackage{times}` `\usepackage[T1]{fontenc}` `\normalfont` `\usepackage{mathptm}` 【参照】サンプルの<`ex1.tex`> と書いておけば問題ありません。最後のmathptmは、数学記述に対するもので通常は必要ありません。フォントの変更等詳しく知りたい方は該当サイトや著書等を参照してください。日本語PDFにはベクタフォントが組み込まれないので、PDFファイルを大きく拡大すればぎざぎざが見えてしまいます。ただ、常識的な拡大率でPDFファイルを見る場合や、600DPI程度のプリンタで印刷する分には、まず問題ありません。どうしても日本語フォントも奇麗に表示したければ、VECTORフォントをPDFファイルに組み込むか、または、ビットマップフォントの組み込みを避ければよいことになります。弊社で実験したところ、AdobeSystems社の Distiller を通して、 PSからPDFにすればフォントが組み込まれずにAcrobatReaderで見たところ、代替フォントで奇麗に表示されました。が、Distillerは、AcrobatなどのAdobe製品を購入しなければなりません。 ● ビットマップなどの図を取り込む方法 TeXソースは、単純なテキストファイルですから、bmp、jpeg、giffなどの画像データをそのまま貼り付ける訳にはいきません。画像を扱うことに関しては、市販のWYSIWYG環境のソフトウエアのように簡単には行きません。コツを覚えれば意外と使えます。１：まず、TeXソースのプリアンブル部に `\usepackage[dvips]{graphicx}` と記述します。【参照】サンプルの<`ex1.tex`> ２：ペイント（その他、Word、Excel、ドローソフトなど）で、目的のファイルを開きます。３：印刷メニューを選択し、[Default PostScript Printer]を選択して、[プロパティ]を開きます。４：[PostScriptオプション]の[PostScript出力オプション]で、[カプセル化されたPostScript(EPS形式)]を選択します。５：[ファイルへ出力]をチェックして実行します。ファイル名は、の拡張子は、<xxx.ps> にします。６：GSViewを実行し、<`xxx.ps`> を開きます。７：マウスカーソルをトリミングする画像部の左下へ移動し、その座標値を記録します。同じく、必要な画像の右上へ移動し、その座標値を記録します。【例】左下(53,689),右上(266,788) ８：<`xxx.ps`>をエディタで開き、`%%BoundingBox:` を探し、そこにある数値を先ほど記録したトリミングする値に書き換え保存します。【例】%%BoundingBox: 18 23 577 819 （この元々の値は、ファイルへ印刷したときの用紙サイズ、例えばA4など、の外接座標になっています。左下が(0,0) ）これを%%BoundingBox: 53 689 266 788 と書き換えます。これで、必要な画像部分を指定したEPSファイルができています。９：TeXソースの必要な部分に以下のコマンドでEPSファイルを取り込みます。 `\includegraphics[clip]{xxx.ps}`	サンプルKIT `texsampl.exe` LaTeX言語サポートDLLは、対応言語一覧から

タイトル	内容	記述言語	設定	Download
COBOL用リナンバスクリプト	COBOLソースのシーケンス番号を任意の初期値、ステップで番号を振り直す	Perlスクリプト	`# Usage: perl.exe renum.pl ファイル名 [初期値 [増分]]` このスクリプトファイルのプロパティの[実行]ページを以下のように設定することで、編集しているCOBOLソースファイルのリナンバを行う。 [実行方法]ページの設定コマンド: `perl.exe` 実行フォルダ: `$c` 引数: `"$p"$b" $1 $2` その他 [X] 実行後に変化したファイルを読み直すアドホックパラメタの設定 (引数の右の [...] ボタンをクリック) タイトル: COBOLリナンバ $1ラベル: 初期値(&B): $1デフォルト値: 10 $2ラベル: 増分(&I): $2デフォルト値: 10 あとは実行しやすいようにツールボタンへ割り当てておけば完璧。 COBOLのソースファイルを開いて、ボタンをクリックするだけ!!	`renum.pl`

タイトル	内容	記述言語	設定
HTML用文法チェックスクリプト	Peggyで記述中のHTMLファイルの文法をチェックし、エラーがあればF4キーでタグジャンプできます。	Perlスクリプト	ここで紹介するHTML文法チェッカは、石野恵一郎さんがフリーで提供されている Another HTML-lint for Win です。まず、Vectorなどからhtmllintをダウンロードします。 VectorのAnother HTML-lint for Win紹介ページ・ダウンロードダウンロードしたファイルを適当なフォルダに解凍します。 `jcode.pl` が必要ですが、もし、解凍ファイルに入っていなければ解凍ディレクトリにコピーしてください。（`jcode.pl` ダウンロード）エクスプローラで、解凍フォルダの htmllint （拡張子なし）をPeggyのプロジェクトウインドウの適当な場所にドラッグ＆ドロップします。 htmllint のプロパティを開き以下のように設定します。 [ファイル]ページの設定タイプ: スクリプトツールアクション: 適当な番号な番号を選んで、[実行する]を選択 [実行方法]ページの設定コマンド: `perl.exe` 実行フォルダ: 引数: `"$p" -x html401t "$a"` `-x` のパラメータは、Another HTML-lint for Winを解凍したフォルダの <`index.html`> を見てください。 -x html401t は、HTML 4.01 でチェックします。 OKでプロパティを閉じます。チェックしたいHTMLファイルを編集し、割り当てたボタンをクリックすれば、アウトプットウインドウに結果が出力されます。また、エラーがあれば、F4キーを押すことでタグジャンプできます。

■ GNUツールアクセサリ

GNUツールをより便利に改造したプログラムを紹介します。

　日本語ファイル名を通す ETAGS

内容セットアップ Download

etagsは、各種プログラム言語のファイルに書かれているシンボルを抽出し、その定義場所へ簡単にジャンプできる便利な機能を提供しています。
ところが、日本語のファイル名の場合、正しく動作しない場合があります。具体的には Shift JISで、「表示」,「機能」などの漢字は、コード5C を含んでいます。これはASCIIコードのバックスラッシュになり、ファイル名が分断されてしまう訳です。
そこで、漢字コードで5Cを含む場合も、正しくファイル名として認識できるよう改造しました。このETAGSを使えば、\dev\構造ファイル\表示機能.c といったファイル名でも大丈夫です。
Peggyをインストールしているフォルダの Peggy と同じ階層にある <bin> フォルダの中に、ダウンロードしたetags.exeを上書きコピーしてください。 etags.exe
264,168バイト

内容	セットアップ	Download
etagsは、各種プログラム言語のファイルに書かれているシンボルを抽出し、その定義場所へ簡単にジャンプできる便利な機能を提供しています。ところが、日本語のファイル名の場合、正しく動作しない場合があります。具体的には Shift JISで、「表示」,「機能」などの漢字は、コード5C を含んでいます。これはASCIIコードのバックスラッシュになり、ファイル名が分断されてしまう訳です。そこで、漢字コードで5Cを含む場合も、正しくファイル名として認識できるよう改造しました。このETAGSを使えば、\dev\構造ファイル\表示機能.c といったファイル名でも大丈夫です。	Peggyをインストールしているフォルダの Peggy と同じ階層にある <`bin`> フォルダの中に、ダウンロードした`etags.exe`を上書きコピーしてください。	etags.exe 264,168バイト

■ ルネサス開発サポートツール用統合化開発環境

ルネサス開発サポートツール関連事項を紹介します。

　TM V.3.10での設定例

内容例

ルネサスマイコン用、統合化開発環境TMにおいて、「Peggy」シリーズのエディタをデフォルトとして登録する方法を示します。

最初にPeggyシリーズをインストールしておく必要があります。
TMを立ち上げ、「ツールの登録」ボタンをクリックすれば、右図ダイアログボックスが表示されますので、これを参考に設定してください。

Peggy アクセサリ集

■ ユーザツールアクセサリ

■ GNUツール アクセサリ

■ ルネサス開発サポートツール用 統合化開発環境

■ GNUツールアクセサリ

■ ルネサス開発サポートツール用統合化開発環境