XSL変換　xslide

訳注：これは，xslideパッケージのREADME.TXT,v 1.11およびヘルプ（C-h m）を私（岸　和孝）が訳したものです。

　このパッケージは，XSLスタイルシートを編集するためのEmacsのメジャーモードを含んでいます。

　現在の改訂は，0.2b3, dated 7 April, 2001です。

目録

ファイル内容

README.TXT このファイル

changelog.txt xslide elispファイルへの変更記録

dot_emacs .emacsファイルへの追加

xslide.el XSLメジャーモードのためのベースファイル

xslide-abbrev.el XSLモードのための省略形

xslide-data.el XSL要素とフォーマッティングオブジェクトについてのデータ

xslide-font.el XSLスタイルシートのためのフォントロックキーワード

xslide-initial.xsl 空のバッファに挿入される省略時の初期化スタイルシート

xslide-process.el XSLスタイルシートを処理するための手続き

makefile バイトコンパイルのためのMakefile

ファイル	内容
README.TXT	このファイル
changelog.txt	xslide elispファイルへの変更記録
dot_emacs	.emacsファイルへの追加
xslide.el	XSLメジャーモードのためのベースファイル
xslide-abbrev.el	XSLモードのための省略形
xslide-data.el	XSL要素とフォーマッティングオブジェクトについてのデータ
xslide-font.el	XSLスタイルシートのためのフォントロックキーワード
xslide-initial.xsl	空のバッファに挿入される省略時の初期化スタイルシート
xslide-process.el	XSLスタイルシートを処理するための手続き
makefile	バイトコンパイルのためのMakefile

注：xslideのより早いバージョンで用いられたmake-regexp.elは，xslide 0.2によって不要となります。

機能

幾つかの変数を設定するためのXSLカスタマイズグループ
空のXSLバッファに挿入される初期化のスタイルシート
テンプレート規則へ飛ぶための「テンプレート」メニュー，名前付けされたテンプレート，キー宣言，バッファ内の属性集合宣言
XSLプロセッサーを動かし出力を集める`xsl-process'関数
XTとSaxon共にJavaとWindows実行可能形式バージョンのための，定義済みのコマンドラインテンプレートとエラー正規表現式
重要な情報をハイライトするためのフォントロック
要素と属性名を挿入するための`xsl-complete'関数
一致している開始タグと終了タグを挿入するための`xsl-insert-tag'関数
終了タグの自動的完成
ユーザー定義可能な要素の自動的字下げ
より容易なタイプのための普遍的な省略形テーブル

　NTEmacs 20.3.1を使って，xsl-modeを試しました。

バグ報告と強化

　バグ報告と強化を受け取れれば幸甚です。

　バグ報告には`xsl-submit-bug-report'を用いてください。

インストール

　配付物をUnzipで解凍してください。これは上記の目録に列挙されたファイルを解凍します。ファイルは，DOSスタイルの行末符号を持っています。ローカルなファイルの行末符号を変換するために"unzip -a"または"gunzip -a"を用いてもかまいません。

　emacsのsite-lispディレクトリー（例えば，/usr/local/lib/emacs/site-lisp）へ.elファイルをコピーします。

　M-x byte-compile-fileを用いて.elをバイトコンパイルし，各ファイルのパス名を与えます。用意されたmakefileも，ファイルをバイトコンパイルするための規則を持っています。前のバージョンのファイルをバイトコンパイルする場合は，autoloadが正しいバージョンをロードするように，新しいファイルをバイトコンパイルしなければなりません（または，古い.elcファイルを取り除いてください）。

　dot_emacs内のelispコードを.emacsファイルへ追加します。

　Emacsを再始動させます（もし容易であれば，.emacsファイルへ追加したコードを評価してください）。

　.xslか.foの拡張子を持つファイルを開く時，xsl-modeは自動的にロードされます。

　xsl-modeをより知るために，XSLファイルの中でヘルプ　C-h　m　を指示してください。

操作

訳注：次の文章はヘルプで得られる表示内容です。

XSL mode

　XSLスタイルシートを編集するためのメジャーモード。

■特殊コマンド

キーバインディング

DEL backward-delete-char-untabify

C-o xsl-open-line

C-c Prefix Command

> xsl-electric-greater-than

< xsl-electric-less-than

/ xsl-electric-slash

M- xsl-complete

xsl-electric-tab

C-c　> xsl-insert-tag

C-c　C-p xsl-process

C-c　C-c xsl-comment

キー	バインディング
DEL	backward-delete-char-untabify
C-o	xsl-open-line
C-c	Prefix Command
>	xsl-electric-greater-than
<	xsl-electric-less-than
/	xsl-electric-slash
M-	xsl-complete
	xsl-electric-tab
C-c　>	xsl-insert-tag
C-c　C-p	xsl-process
C-c　C-c	xsl-comment

　変数`xsl-mode-hook'の値がnilでなければ，XSLモードへの切り替えはその値を呼びます。

■略語

　XSLモードは，略語テーブルにプリロードされたXSL特有の略語の包括的集合を含んでいます。

■フォントロックモード

　フォントロックモードの切り替えは，様々なXSLシンタックスの構造を強調するようにします。

　XSLファイルを訪れる場合にいつもこれを切り替えるために，.emacsファイルに次を加えてください。

  (add-hook 'xsl-mode-hook 'turn-on-font-lock)

■スタイルシートの処理

　　C-c　C-p　は，バッファ*XSL process*へ出力する非同期に別々のプロセスでシェルコマンドを動かします。次のエラーメッセージを見つけるために，コマンド　C-x　`　を利用でき，それを引き起こしたXSL文書の行へ移動できます。

　プログラムを動作させる最初の段階は，いつでも接頭辞のある引数を用意します。例えば，　C-u　C-c　C-p　，入力ファイル名，スタイルシートファイル，出力ファイル名についてのプロンプト。

　それらの値は，それらを用いている幾つかのXSLTプロセッサーを動かすコマンドラインと共にこのコマンドの履歴に入れるために，`xsl-process-command'のテンプレートを用います。予め定義されたコマンドを介して　M-p　と　M-n　を用います。必要であれば，そのコマンドを編集し，或いは新しいコマンドラインを入力します。そのコマンドを動作させる次の段階で，直前に実行されたコマンドが省略時に用いられます。

■複数ファイルの探索

　複数のファイルを探すために，　M-x　xsl-grep　 RET 　を用い，探すべきパターンとプロンプトに応じて探索すべきにファイルの指定を与えます。

xsl-process-command

　xsl-process-commandは，XSL文書を処理するためのシェルコマンドです。

  transfrmx -i %i -s %s -o %o
  xt %i %s %o
  java com.jclark.xsl.Driver %i %s %o
  saxon -o %o %i %s
  saxon -o %o %i
  java com.icl.saxon.StyleSheet -o %o %i %s
  java com.icl.saxon.StyleSheet -o %o %i

訳注：
　MS-Windowsではxtの動作を確認しています。
　MacOSではtransfrmxの動作を確認しています。

　これは，省略時に三つの`%s'変換指定を含むべき`format'制御ストリングです。

1番目は，xsl-process-input-file（または，nilの場合に空のストリング）の値と取り替えられます。
2番目は，xsl-process-stylesheet-file（または，nilの場合に空のストリング）と取り替えられます。
3番目は，xsl-process-output-file（または，nilの場合に空のストリング）と取り替えられます。

　`xsl-process-files'がnilでない場合，フォーマットストリングはその結果の各要素のために一つの`%s'変換指定を含むべきです。

　xsl-process-commandがリストの場合，どの要素もストリングであるべきです。ストリングは順番に試され，ストリングの中の%列が下記のリストによって置き換えれます。ストリングが置換値なしの%列を含む場合，次のストリングは試されます。

%bは，現在のバッファの訪れているファイルを意味します。
%iは，xsl-process-input-fileの値を意味します。
%sは，xsl-process-stylesheet-fileの値を意味します。
%oは，xsl-process-output-fileの値を意味します。

　この変数はカスタマイズできます。

xsl-grep

　xsl-grepは，FILESPECに一致するファイルにおいてPATTERNでgrepします。

  (xsl-grep PATTERN FILESPEC)

PATTERNとFILESPECの引き数で`grep'を動かします。
PATTERNは `grep'が照合するためのパターンです。
PATTERNは，PATTERNにおける文字の解釈を避けるために`grep'コマンドの引数において単一引用符で引用されます。
`xsl-grep'は，直前の値を容易に再利用できるようにPATTERNの履歴を保守します。
FILESPECは，grepによって走査されるべきファイルの名前か正規表現式です。
`xsl-grep'は`grep'を用いるので，正規表現式と複数のファイル名がサポートされます。
"*.xsl"と"*.XSL *.ent"は，共に妥当なFILESPEC値です。
インタラクティブに呼ばれる時，最初のFILESPECがxsl-default-filespecから取られます。しかし，直前の値を容易に再利用できるように`xsl-grep'もFILESPEC引数の履歴を保守します。同じFILESPECを再利用できるように、履歴は`xsl-etags'とも共有されます。

（2001年6月記）

XSL変換 xslide

目録

機能