yatex
view docs/yatexj.tex @ 58:3a7c0c2bf16d
Official support for AMS-LaTeX, HTML, xdvi -remote, Netscape
| author | yuuji |
|---|---|
| date | Thu, 01 Feb 1996 18:55:47 +0000 |
| parents | 18f4939986e6 |
| children | 48ac97a6b6ce |
line source
1 \def\lang{jp} % -*- texinfo -*- for Texinfo V.3.1
2 \input texinfo
3 @setfilename yatexj
4 @settitle Yet Another tex-mode for Emacs
6 @iftex
7 @c @syncodeindex fn cp
8 @syncodeindex vr cp
9 @end iftex
11 @titlepage
12 @sp 10
13 @center
14 @subtitle Yet Another tex-mode for emacs
15 @title 『野鳥』
16 @subtitle // YaTeX //
17 @author @copyright{} 1991-1994 by HIROSE, Yuuji [yuuji@@ae.keio.ac.jp]
18 @end titlepage
20 @node Top, Intro, (dir), (dir)
21 @comment node-name, next, previous, up
23 @menu
24 * Intro:: はじめに
25 * Termnology:: マニュアル参照上の注意
26 * Main features:: 主な機能
27 * Installation:: インストール
28 * Invocation:: プロセス起動
29 * %#notation :: %#記法
30 * Completion:: 補完入力
31 * Local dictionary:: ローカル辞書
32 * Commenting out:: コメントアウト
33 * Cursor jump:: カーソルジャンプ
34 * Modifying/Deleting:: LaTeXコマンドの変更/削除
35 * Filling:: 桁揃え
36 * Includeonly:: 勝手に includeonly
37 * What column:: カラム位置ガイド
38 * Intelligent newline:: おまかせ改行
39 * Changing mode of YaTeX:: 野鳥動作モード変更
40 * Online help:: LaTeXオンラインヘルプ
41 * Inclusion hierarchy browser:: ファイル分割階層構造の表示
42 * Cooperation with other packages:: 他パッケージとの連携
43 * Customizations:: カスタマイズ
44 * Etc:: その他
45 * Copying:: 取り扱い
46 * Concept Index:: 索引
48 --- The Detailed Node Listing ---
50 latexコマンド起動
52 * Calling typesetter:: タイプセッタ起動
53 * Calling previewer:: プレヴューア起動
54 * Print out:: プリントアウト用コマンドの起動
56 %#記法
58 * Changing typesetter:: タイプセット用コマンドの変更
59 * Splitting input files:: 入力ファイル分割
60 * Fix region for typesetting:: 領域の固定
61 * lpr format:: プリントアウトコマンド用フォーマット
62 * Editing %# notation:: %#記法の編集
64 補完入力
66 * begin型補完::
67 * section型補完::
68 * large型補完::
69 * maketitle型補完::
70 * Arbitrary completion:: 随時補完
71 * end補完::
72 * Accent mark completion:: アクセント記号補完
73 * Image completion:: 数式記号イメージ補完
74 * Greek letter completion:: ギリシャ文字補完
76 section型補完
78 * 2個以上の引数をとる section型コマンド::
79 * Enclose section-type command:: 括り補完
80 * Recursive completion:: 再帰補完
81 * view-sectioning:: セクション区切りのアウトライン表示
83 変更/削除
85 * Changing LaTeX command:: La@TeX{} コマンドの変更
86 * Killing LaTeX command:: La@TeX{} コマンドの削除
88 カスタマイズ
90 * Lisp variables:: lisp 変数
91 * Add-in functions:: 付加関数(アドイン関数)
93 lisp 変数
95 * All customizable variables:: カスタマイズ変数一覧
96 * Sample definitions:: カスタマイズ変数設定例
97 * Hook variables:: hook変数
98 * Hook file:: hook用ファイル
99 @end menu
101 @node Intro, Termnology, Top, Top
102 @comment node-name, next, previous, up
103 @chapter はじめに
104 @cindex Demacs
105 @cindex Mule
106 @cindex LaTeX
107 @cindex やちょう[やちよう]
109 野鳥は、GNU Emacs で La@TeX{} 用の文書を作成する時に jLa@TeX{} などの
110 タイプセットコマンドや、プレヴューアの起動を Emacs 編集画面中から
111 行えるようにすると共に、拡張性の高い種々の補完機能によりソーステキ
112 ストの編集を支援します。さらに La@TeX{} コマンドのオンラインヘルプに
113 よりマニュアルを調べる手間を軽減します。
115 English manual @xref{Top, , , yatexe,YaTeX English info}
117 @node Termnology, Main features, Intro, Top
118 @comment node-name, next, previous, up
119 @chapter 本マニュアル参照上の注意
121 本マニュアルでは以下の表記を用います。
123 @itemize @bullet
124 @item
125 begin型コマンド
127 @code{\begin@{環境@} 〜 \end@{環境@}}という形式のLaTeXコマンドを指します。
128 begin型コマンドを補完入力することをbegin型補完と呼びます。
130 @item
131 section型コマンド
133 @code{\section@{タイトル@}}や@code{\mbox@{内容@}}のように
134 引数を取るLaTeXコマンドを指します。
136 @item
137 maketitle型コマンド
139 @code{\maketitle}や@code{\tableofcontents}のように引数を取らないLaTeXコマ
140 ンドを指します。
142 @item
143 large型コマンド
145 @code{@{\large ...@}} や @code{@{\tt ...@}} のようなフォント/サイズ指定子
146 を指します。
148 @item @kbd{[prefix]}
150 野鳥の機能を呼び出すためのプリフィクスキー。デフォルトでは@kbd{C-c}に割り
151 当てられているので、特に変更していない場合本マニュアルの @kbd{[prefix]} と
152 いう表記は、@kbd{C-c} と読み換えてください。
153 @end itemize
155 @node Main features, Installation, Termnology, Top
156 @comment node-name, next, previous, up
157 @chapter 主な機能
159 @itemize @bullet
160 @item タイプセッタやプレヴューアなどの編集画面からの起動(@kbd{C-c t})
161 @item カーソル位置によらない固定リジョンの部分タイプセット
162 @item \includeonlyのワンタッチ更新
163 @item エラー箇所への自動ジャンプ(@kbd{C-c '})
164 @item @code{\begin@{@}, \end@{@}, \section...} などの La@TeX{}
165 コマンドの補完入力
166 (@kbd{C-c b}, @kbd{C-c s}, @kbd{C-c l}, @kbd{C-c m})
167 @item 既に入力したテキストを環境やコマンド引数の中に取り込む括り補完
168 (@kbd{C-u} +通常補完キー)
169 @item セクション区切り入力時の文書構造アウトライン表示
170 @item 補完辞書の学習
171 @item La@TeX{} の環境やコマンドに応じたガイド付き引数入力
172 @item 野鳥にないガイド付き引数入力関数の自動生成(@file{yatexgen.el})
173 @item La@TeX{} コマンドの削除/変更(@kbd{C-c k}, @kbd{C-c c})
174 @item ファイル間、@code{\begin}<->@code{\end}間、
175 @code{\ref}<->@code{\label}間、
176 @code{\cite}<->@code{\bibitem}ジャンプ(@kbd{C-c g})
177 @item 一括コメントアウト/アンコメントアウト
178 (@kbd{C-c >}, @kbd{C-c <}, @kbd{C-c ,}, @kbd{C-c .})
179 @item アクセント記号/数式環境用コマンド/ギリシャ文字の入力支援
180 (@kbd{C-c a}, @kbd{;}, @kbd{/})
181 @item tabular/array環境のカラム位置ガイド
182 @item 標準的 La@TeX{} コマンドのオンラインヘルプ(@kbd{C-c ?}, @kbd{C-c /})
183 @item ドキュメントのインクルード構造の視覚的表示とバッファ切り替え
184 (@kbd{C-c d})
185 @end itemize
187 @node Installation, Invocation, Main features, Top
188 @comment node-name, next, previous, up
189 @chapter 起動法
190 @cindex Install
191 @cindex インストール[いんすとおる]
192 @cindex .emacs
193 @cindex auto-mode-alist
194 @cindex autoload
195 @section 野鳥起動のための設定
197 ~/.emacsに下の2項目を加えます。
199 @lisp
200 (setq auto-mode-alist
201 (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist))
202 (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t)
203 @end lisp
205 次に野鳥の emacs-lisp ファイル群を置くディレクトリを load-path に加えます。
206 たとえば、 @file{~/src/emacs/yatex}に置くのであれば、
208 @lisp
209 (setq load-path (cons (expand-file-name "~/src/emacs/yatex") load-path))
210 @end lisp
212 @noindent
213 などとします。
215 以上の設定により、拡張子が .tex であるファイルを編集すると自動的に野鳥が
216 ロードされます。野鳥が正常に起動できたときはモードラインの表示が「やてふ」
217 に変わります。
219 @section タイプセッタ/プレヴューア環境の設定
221 利用する外部プログラムに関する以下の変数を確認し、必要なら正しい値に変更
222 します。
223 @table @code
224 @item tex-command
225 @dots{} 起動するタイプセッタのコマンド名
226 @item dvi2-command
227 @dots{} 起動するプレヴューアのコマンド名
228 @item NTT-jTeX
229 @dots{} NTT jTeX を使用するなら t
230 @item YaTeX-kanji-code
231 @dots{} 文書を作成する時の漢字コード
232 @item dviprint-command-format
233 @dots{} ファイルの印刷に使われるコマンド列の書式
234 @item makeindex-command
235 @dots{} makeindexコマンド
236 @end table
238 これらを変更する場合は、やはり@file{~/.emacs}にて、たとえば
239 @lisp
240 (setq tex-command "bigjlatex")
241 @end lisp
242 のようにしてください。どのような値をセットすれば良いかについては、
243 @ref{All customizable variables}を参照してください。
246 @node Invocation, %#notation , Installation, Top
247 @comment node-name, next, previous, up
248 @chapter latexコマンド起動
249 @cindex prefix key
250 @cindex C-c
251 @cindex タイプセッタ[たいふせつた]
252 @cindex プレヴューア[ふれひゆうあ]
253 @cindex jlatex
254 @cindex プリントアウト[ふりんとあうと]
256 LaTeXソースの編集中、次のキー入力により、jlatex などのタイプセットプログラ
257 ム(以後タイプセッタと呼ぶ)、プレヴューアなどの起動ができます。
259 @table @kbd
260 @item [prefix] t j
261 @dots{} タイプセッタ(jlatex)起動
262 @item [prefix] t r
263 @dots{} タイプセッタ起動(領域指定)
264 @item [prefix] t k
265 @dots{} 動作中のタイプセッタの停止
266 @item [prefix] t b
267 @dots{} jbibtex起動
268 @item [prefix] t p
269 @dots{} プレヴューア起動
270 @item [prefix] t l
271 @dots{} lpr(プリントアウト用)コマンド起動
272 @item [prefix] t s
273 @dots{} xdvi -remote でのサーチ
274 @end table
276 @menu
277 * Calling typesetter:: タイプセッタ起動
278 * Calling previewer:: プレヴューア起動
279 * Print out:: プリントアウト用コマンドの起動
280 @end menu
282 @node Calling typesetter, Print out, Invocation, Invocation
283 @comment node-name, next, previous, up
284 @section タイプセッタ起動
285 @cindex タイプセッタ起動
286 @cindex タイプセットエラー[たいふせつとえらあ]
287 @cindex エラー修正[えらあしゆうせい]
289 タイプセッタを起動すると、編集ウィンドウが2つに分割され、片方のウィンド
290 ウにタイプセット画面が表示されます。出力されるメッセージと連動しタイプセッ
291 トバッファは自動的にスクロールします。もし、途中でエラーが起こって止まって
292 しまった場合にはタイプセットバッファに移り、(@kbd{C-x o}) タイプセッタの出
293 している ? プロンプトに対して、@kbd{x} (処理の中断)などの指示を送ることが
294 できます。エラーを修正する場合は、
296 @table @kbd
297 @item [prefix] '
298 @itemx (prefix+アポストロフィ)
299 @dots{} 直前のエラー発生行へジャンプ
300 @end table
302 を入力することにより、タイプセッタがエラーを発生した行に移ることができます。
303 また、タイプセッタの出力する overfull hbox などのウォーニング行にも対応し
304 ていますので、順次 @kbd{[prefix] '} を押すことにより、一つ前のウォーニング
305 発生行にジャンプしていきます。
307 もし、気になるエラー行があった場合は、タイプセットバッファで、エ
308 ラーの表示されている行にカーソルを合わせスペースキーを押すと La@TeX{}
309 ソースの対応する行にジャンプします。
311 @subsection 領域タイプセット
313 ポイントとマークの間、あるいはテキスト中に埋め込んだ @code{%#BEGIN} と
314 @code{%#END}の間の領域(@ref{%#記法})だけを切り取ってタイプセットすることが
315 できます。この場合の documentstyle は、単一ファイルの La@TeX{} ソースの編
316 集時にはそのファイルの documentstyle が、別ファイルから include している場
317 合にはメインファイルの documentstyle が自動的に選択されます。指定領域は、
318 メインファイルのあるディレクトリの@file{texput.tex}という臨時ファイルに出
319 力されますので、上書きには注意してください。
321 @node Calling previewer, Print out, Calling typesetter, Invocation
322 @comment node-name, next, previous, up
323 @section プレヴューア起動
324 @kbd{[prefix] t p} によりプレヴューアの起動ができます。さらに、もしあな
325 たが、-remote 機能つきのxdviを利用している場合は @kbd{[prefix] t s} を押す
326 ことによりカーソル位置の文字列を検索してそのページを表示するようにすでに起
327 動中のxdviに命令を送ります。これにより、現在編集中の箇所のタイプセット結果
328 を即座に見ることができます。なお、-remote 機能付きの xdvi は
329 @code{ftp://ftp.ae.keio.ac.jp/pub/text/xdvi/xdvi-remote}
330 などから入手することができます。
332 @node Print out, , Calling typesetter, Invocation
333 @comment node-name, next, previous, up
334 @section プリントアウト
336 @kbd{[prefix] t l}を押してプリントアウトを指示すると、出力開始/終了ペー
337 ジを聞いてくるので、それぞれに答えます。これを省略したい時は、
338 universal-argument をつけ、
340 @cindex 出力開始ページ[しゆつりよくかいしへえし]
341 @cindex 出力終了ページ[しゆつりよくしゆうりようへえし]
343 @table @kbd
344 @item C-u [prefix] t l
345 @dots{} ページ確認省略lpr起動
346 @end table
347 @cindex ページ確認省略lpr起動[へえしかくにんしようりやくlprきとう]
349 @noindent
350 のように起動してください。
352 @node %#notation , Completion, Invocation, Top
353 @comment node-name, next, previous, up
354 @chapter %#記法
356 本文中に@code{%#}ではじまるキーワードを埋め込むことでタイプセッタ起動等
357 の制御をすることができます。
359 @menu
360 * Changing typesetter:: タイプセット用コマンドの変更
361 * Splitting input files:: 入力ファイル分割
362 * Fix region for typesetting:: 領域の固定
363 * lpr format:: プリントアウトコマンド用フォーマット
364 * Editing %# notation:: %#記法の編集
365 @end menu
367 @node Changing typesetter, Splitting input files, %#notation , %#notation
368 @comment node-name, next, previous, up
369 @section タイプセット用コマンド変更
371 起動するコマンドを変えたい時は本文中に次のような行を書きます。
373 @cindex 起動するコマンドを変える[きとうするこまんとをかえる]
375 @example
376 %#!jlatex-ntt
377 @end example
379 NTT jTeX と、ASCII jTeX を使い分けたいような場合に便利でしょう。
381 @cindex タイプセッタの使い分け[たいふせつたのつかいわけ]
383 @node Splitting input files, Fix region for typesetting, Changing typesetter, %#notation
384 @comment node-name, next, previous, up
385 @section 入力ファイル分割
387 また、章毎に別ファイルの .tex を作成している場合で、@file{main.tex}から
388 @file{sub.tex}を @code{\include}しているような時は、@file{sub.tex}の任意の
389 位置に次のような行を埋め込みます。
391 @example
392 %#!jlatex main.tex
393 @end example
395 @cindex 入力ファイル分割[にゆうりよくふあいるふんかつ]
397 上の例のようにコマンド名だけでなく引数も書いた場合には、全てをそのまま
398 shell に渡すので次のように書けば、ghostview などをプレヴューアに使う時に便
399 利です。
401 @cindex ghostview
403 @example
404 %#!jlatex main ; dvi2ps main.dvi > main
405 @end example
407 なお、この行の最後の単語のピリオド以前を「メインファイル」のベース
408 ネームであると仮定します(上の2つの場合どちらも@file{main})。
410 @kbd{[prefix] g} (@ref{Cursor jump}参照) での
411 ファイル間ジャンプを有効に機能させるため、入力ファイル分割時には次のことに
412 注意して下さい。
414 @enumerate
415 @item
416 サブディレクトリを作って、その中にサブファイルを置くことはできるが
417 サブディレクトリのサブディレクトリには置けない。
418 @item
419 メインファイルからサブディレクトリ内のファイルを include
420 する時には、相対パス指定を用いて、
421 @code{\include{chap1/sub}}のように記述。
422 @item
423 メインファイルが一つ上のディレクトリにある場合も、サブファイルには
424 %#!jlatex main.tex のように記述する(../mainではない)。
425 @end enumerate
429 @node Fix region for typesetting, lpr format, Splitting input files, %#notation
430 @comment node-name, next, previous, up
431 @section 領域の固定
432 @cindex 固定領域のタイプセット[こていりよういきのたいふせつと]
433 @cindex %#BEGIN
434 @cindex %#END
436 @kbd{[prefix] tr} の領域指定のタイプセットでは、とくに指定のないかぎり、
437 @kbd{C-SPC}でマークした位置と、ポイント(カーソル位置)の間を領域とみなしま
438 すが、必ず決まった領域をタイプセットしたい場合は、その領域を
440 @example
441 %#BEGIN
442 <渡したい領域>
443 %#END
444 @end example
446 @noindent
447 のように@code{%#BEGIN}と@code{%#END}で囲み、カーソルを「@code{%#BEGIN}以降」
448 に置いてください。この時の領域決定規則をまとめると次のようになります。
451 @enumerate
452 @item
453 カーソル位置よりバッファの先頭方向に@code{%#BEGIN}というキーワードが
454 ある場合
456 @enumerate
457 @item
458 @code{%#BEGIN}よりバッファの末尾方向に@code{%#END}というキーワードが見つかっ
459 た場合。
460 @result{}@code{%#BEGIN} から、その @code{%#END} のある位置まで。
461 @item
462 @code{%#END} が見つからなかった場合。
463 @result{}バッファの最後尾まで。
464 @end enumerate
465 @cindex 領域決定規則[りよういきけつていきそく]
467 @item
468 カーソル位置よりバッファの先頭方向に @code{%#BEGIN} というキーワードが
469 見つからなかった場合。
470 @result{}マーク(@kbd{C-SPC}位置)とポイント(カーソル位置)の間の領域。
471 @end enumerate
473 tabular 環境を何度も試行錯誤しているような場合は、@code{\begin}の前の行
474 に @code{%#BEGIN} と書き、@code{\end} の次の行に @code{%#END} と書いておく
475 と簡単に作表結果をテストすることができます。また、長い .tex ファイルの後半
476 に @code{%#BEGIN} を書いておけば、前半の部分は無視できます。このBEGINとEND
477 の消し忘れには十分ご注意下さい。
478 @cindex 長いファイルの編集[なかいふあいるのへんしゆう]
480 @node Require, lpr format, Fix region for typesetting, %#notation
481 @comment node-name, next, previous, up
483 @node lpr format, Editing %# notation, Fix region for typesetting, %#notation
484 @comment node-name, next, previous, up
485 @section lprフォーマット
486 @cindex lprふぉーまっと[lprふおおまつと]
487 @cindex lprフォーマット[lprふおおまつと]
488 @cindex lpr format
490 まず、プリントアウト用コマンド列のフォーマットについて説明します。
491 コマンド列フォーマットは、3つの Lisp 変数によって表現されます。デ
492 フォルトの dvi2ps 用のフォーマットを例に説明します。
494 @table @code
495 @item (1)dviprint-command-format
496 @code{"dvi2ps %f %t %s | lpr"}
498 @item (2)dviprint-from-format
499 @code{"-f %b"}
501 @item (3)dviprint-to-format
502 @code{"-t %e"}
503 @end table
505 実際にプリントアウトする時は、(1)中の %s がファイル名に置き換えられ、%f が
506 (2)の内容、%t が(3)の内容に置き換えられます。その際に(2)の文字列中の %b は
507 「出力開始ページ」、(3)の文字列中の %e は「出力終了ページ」に置き換えられ
508 ます。もし、ページを指定しない時には、%f, %t 両方とも無視されます。
510 この、dviprint-command-format を臨時に変えたい時は、La@TeX{} の
511 ソーステキスト中の任意の場所に、
513 @example
514 %#LPR dvi2ps %f %t %s | 4up -page 4 | texfix | lpr -Plp2
515 @end example
517 @noindent
518 のように書いて下さい。プリントアウトするページ範囲をいちいち聞かせないよう
519 にする時に
521 @example
522 %#LPR dvi2ps %s | lpr
523 @end example
525 @noindent
526 などとするのも便利かもしれません。
528 @node Editing %# notation, , lpr format, %#notation
529 @comment node-name, next, previous, up
530 @section %#記法自体の編集
531 @cindex %#きほうじたいのへんしゅう[%#きほうしたいのへんしゆう]
533 以上のような@code{%#}で始まる各種制御記法を編集するためには
535 @table @kbd
536 @item [prefix] %
537 @dots{} @code{%#}@var{記法編集メニュー}
538 @end table
540 @noindent
541 を押します。
543 @example
544 !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR
545 @end example
547 @noindent
548 というメニューが出て来るので、@code{%#!}に続くコマンドを変更したい時には
549 @kbd{!}を、@code{%#LPR}で lpr フォーマットを変えたい時は@kbd{l}を、あらか
550 じめ設定したリジョンを @code{%#BEGIN} 〜 @code{%#END} で括りたい時は、
551 @kbd{b}を押します。@kbd{b}を選んだ時には、それまでバッファ中に置かれていた
552 @code{%#BEGIN}, @code{%#END} が自動的に消去されます。
553 @cindex lprフォーマットの変更[lprふおおまつとのへんこう]
555 @node Completion, Local dictionary, %#notation , Top
556 @comment node-name, next, previous, up
557 @chapter 補完入力
559 La@TeX{} での環境名などは、野鳥の補完機能を利用して能率的に入力すること
560 ができます。
562 @menu
563 * begin型補完::
564 * section型補完::
565 * large型補完::
566 * maketitle型補完::
567 * Arbitrary completion:: 随時補完
568 * end補完::
569 * Accent mark completion:: アクセント記号補完
570 * Image completion:: 数式記号イメージ補完
571 * Greek letter completion:: ギリシャ文字補完
572 @end menu
574 @node begin型補完, section型補完, Completion, Completion
575 @comment node-name, next, previous, up
576 @section begin型補完
577 @cindex begin型補完[beginかたほかん]
578 @cindex 環境名の補完[かんきようめいのほかん]
579 @cindex prefix b
581 @code{\begin@{env@}...\end@{env@}}の様な形式の入力の補完をbegin型補完と
582 呼ぶことにします。begin 型補完は、
584 @table @kbd
585 @item [prefix] b
586 @dots{} begin 型補完開始(標準では @kbd{C-c b})
587 @end table
589 @noindent
590 で始まります。頻繁に用いられる次の La@TeX{} 環境の補完は、[prefix] @kbd{b}
591 に続く次の1文字を入力するだけで、@code{\begin@{xxx@}...\end@{xxx@}}を完成
592 させます。
594 @table @kbd
595 @item [prefix] b c
596 @dots{} @code{\begin@{center@}...\end@{center@}}
597 @item [prefix] b d
598 @dots{} @code{\begin@{document@}...\end@{document@}}
599 @item [prefix] b D
600 @dots{} @code{\begin@{description@}...\end@{description@}}
601 @item [prefix] b e
602 @dots{} @code{\begin@{enumerate@}...\end@{enumerate@}}
603 @item [prefix] b E
604 @dots{} @code{\begin@{equation@}...\end@{equation@}}
605 @item [prefix] b i
606 @dots{} @code{\begin@{itemize@}...\end@{itemize@}}
607 @item [prefix] b l
608 @dots{} @code{\begin@{flushleft@}...\end@{flushleft@}}
609 @item [prefix] b m
610 @dots{} @code{\begin@{minipage@}...\end@{minipage@}}
611 @item [prefix] b t
612 @dots{} @code{\begin@{tabbing@}...\end@{tabbing@}}
613 @item [prefix] b T
614 @dots{} @code{\begin@{tabular@}...\end@{tabular@}}
615 @item [prefix] b ^T
616 @dots{} @code{\begin@{table@}...\end@{table@}}
617 @item [prefix] b p
618 @dots{} @code{\begin@{picture@}...\end@{picture@}}
619 @item [prefix] b q
620 @dots{} @code{\begin@{quote@}...\end@{quote@}}
621 @item [prefix] b Q
622 @dots{} @code{\begin@{quotation@}...\end@{quotation@}}
623 @item [prefix] b r
624 @dots{} @code{\begin@{flushright@}...\end@{flushright@}}
625 @item [prefix] b v
626 @dots{} @code{\begin@{verbatim@}...\end@{verbatim@}}
627 @item [prefix] b V
628 @dots{} @code{\begin@{verse@}...\end@{verse@}}
629 @end table
631 上記のもの以外の環境名は Emacs の持つインクリメンタルな補完機能を用いて
632 入力します(上記の環境名も以下の補完入力可能)。
634 @table @kbd
635 @item [prefix] b @key{SPC}
636 @dots{} begin 型補完入力
637 @end table
639 @kbd{[prefix] b @key{SPC}} と入力すると、最下行のミニバッファに
641 @example
642 Begin environment(default document):
643 @end example
645 @noindent
646 と表示されます。ここで、何も入れずにリターンキーのみ押すと、括弧内に出てい
647 るデフォルトの環境名が入力されますが、適当な環境名を入力すると、
648 @code{\begin@{環境名@} … \end@{環境名@}}が文書中に挿入されます。ミニバッ
649 ファで環境名を入力するときに、環境名の頭文字を入力し「スペース」をたたくと、
650 一致する環境名が内部テーブルに存在した場合、正しい環境名に補完されるので、
651 入力の手間が省けます。内部テーブルに存在しない環境名を入力した時はユーザ専
652 用のテーブルに登録され、さらにそのテーブルを自動的に、ユーザ辞書(デフォル
653 トでは @file{~/.yatexrc})に保存します。
655 さらに、特定の環境を補完入力した時にはその環境で必ず用いられるエントリを自
656 動挿入します(例: @code{itemize}環境における@code{\item}など)。挿入されたエ
657 ントリが不要な場合にはundoによって消去して下さい。
658 @cindex ユーザ辞書[ゆうさししよ]
660 @subsection 既に書いたテキストを環境で括る
662 ところで、最初に書いてしまったブロックを後から、itemize 環境の中
663 に閉じこめたいと思うことがありますが、そのようなときは、あらかじめ
664 閉じこめたい段落をマークして、begin 型補完の各コマンドの @kbd{[prefix]}
665 の次の『小文字の 'b'』 を『大文字』に変えて起動して下さい。(または、
666 @kbd{C-u} を先に打ち、universal argument をつけても可能です)
667 @cindex ブロック[ふろつく]
668 @cindex 閉じ込める[としこめる]
670 例えばあるパラグラフを description 環境の中に入れたいときは、
671 そのパラグラフをマークしてから、
673 @table @kbd
674 @item [prefix] B D
675 @itemx (または ESC 1 [prefix] b D)
676 @itemx (または C-u [prefix] b D など)
677 @end table
679 とタイプしてください。これは、@kbd{[prefix] b SPC}の補完入力にもあてはまり、
680 @kbd{b} を大文字に変えて、@kbd{[prefix] B SPC} とタイプすれば、あらかじめ
681 マークしておいたリジョンを、begin と end の環境で括ります。
683 @node section型補完, large型補完, begin型補完, Completion
684 @comment node-name, next, previous, up
685 @section section型補完
686 @cindex section型補完[sectionかたほかん]
687 @cindex prefix s
689 @code{\section@{目的@}} のような形式の入力の補完を section 型補完と呼ぶこ
690 とにします。section 型補完は、
692 @table @kbd
693 @item [prefix] s
694 @dots{} section 型補完
695 @end table
697 @noindent
698 で実行します。@kbd{[prefix] s} を入力するとミニバッファに、
700 @example
701 (C-v for view-section) \???@{@} (default documentstyle):
702 @end example
704 @noindent
705 というプロンプトが現れるので、そこで @samp{section} のような La@TeX{} コマ
706 ンド名を入力します。ここでもリターンキーのみで括弧内のデフォルト値が選択さ
707 れるほか、@samp{chapter}などのような頻度の高い名称入力にはスペースキーによ
708 る補完機能が有効です。 次に、@{@}の中身の入力を促す、
710 @example
711 \section@{???@}:
712 @end example
714 @noindent
715 というプロンプトが現れるので、セクションのタイトルなどを入力します。
716 たとえば、
718 @example
719 (C-v for view-section) \???@{@} (default documentstyle): section
720 \section@{???@}: 目的
721 @end example
723 @noindent
724 のように入力した場合は、文章中に
726 @example
727 \section@{目的@}
728 @end example
730 @noindent
731 が挿入され、
733 @example
734 (C-v for view-section) \???@{@} (default section): vspace*
735 \vspace*@{???@}:
736 @end example
738 @noindent
739 のように@{@}の中身を省略したときは、
741 @example
742 \vspace*@{@}
743 @end example
745 @noindent
746 だけが挿入され、改行はせずカーソルは自動的に中括弧の内側に移動します。
748 @menu
749 * 2個以上の引数をとる section型コマンド::
750 * Enclose section-type command:: 括り補完
751 * Recursive completion:: 再帰補完
752 * view-sectioning:: セクション区切りのアウトライン表示
753 @end menu
755 @node 2個以上の引数をとる section型コマンド, Recursive completion, section型補完, section型補完
756 @comment node-name, next, previous, up
757 @subsection 2個以上の引数をとる section型コマンド
758 @cindex 引数[ひきすう]
760 ところで、@samp{\addtolength{\topmargin}{8mm}} などのように、引数を二つ
761 以上取る La@TeX{} コマンドがあります。このようなコマンドの補完入力には、
762 section 型補完呼び出しに引数を付けてください。例えば上の@samp{addtolength}
763 の例であれば、引数2を指定します。つまり、
765 @example
766 C-u 2 [prefix] s (または、ESC 2 [prefix] s)
767 @end example
769 @noindent
770 と section 型補完を呼び出した後、
772 @example
773 (Ctrl-v for view-section) \???@{@} (default vspace*): addtolength
774 \addtolength@{???@}: \topmargin
775 Argument 2: 8mm
776 @end example
778 @noindent
779 のように入力してください。最初の addtolength の部分と、第一引数である
780 \topmargin の入力は当然スペースによる補完入力が可能です。ユーザ辞書に登録
781 される La@TeX{} コマンドには、この引数の数も学習されるので、最初の補完の時
782 引数の数を指定して起動しておけば、以後の補完時には、記憶された個数だけ引数
783 を聞いて来るようになります。あとで引数の個数を変えたい時は、再び @kbd{C-u}
784 を用いて個数を指定し直すことで、自動的に辞書中の引数の個数の部分を更新しま
785 す。
786 @cindex 引数の個数を変える[ひきすうのこすうをかえる]
789 @node Enclose section-type command, Recursive completion, 2個以上の引数をとる section型コマンド, section型補完
790 @subsection 既に書いたテキストを括る
791 @cindex 括る[くくる]
793 また、起動コマンドの@kbd{s}を大文字に変えて起動すると、あらかじめ書
794 いた文章を section 型コマンドの第一引数として括ります。
796 @node Recursive completion, view-sectioning, 2個以上の引数をとる section型コマンド, section型補完
797 @comment node-name, next, previous, up
798 @subsection 再帰補完
799 @cindex 再帰補完[さいきほかん]
801 高度な使い方になるかもしれませんが、section型補完の引数の入力時にさらに
802 補完入力を利用することができます(section/large/maketitle型に限る)。section
803 型コマンドの引数に更に La@TeX{} コマンドが来る場合にはミニバッファで野鳥の
804 補完キーを再帰的に入力することで引数の入力も効率的に行なえます。
806 @node view-sectioning, , Recursive completion, section型補完
807 @comment node-name, next, previous, up
808 @subsection セクション区切りのアウトライン表示
809 @cindex アウトライン[あうとらいん]
811 通常のsection型補完の時にミニバッファで@kbd{C-v}を押すと現在存在するセク
812 ション区切りコマンド全てを @code{*Sectioning Lines*}というバッファに一覧表
813 示します(「<<--」のついている行がもっとも近いセクション区切り)。この時ミニ
814 バッファで@kbd{C-p}, @kbd{C-n} を押すと@samp{part}, @samp{chapter}, ...,
815 @samp{subparagraph} のコマンドが論理階層の高さにしたがって上下します。また、
816 @kbd{C-v}, @kbd{M-v} を押すとセクション区切り一覧バッファがスクロールし、
817 数字の@kbd{0}〜@kbd{7}を押すとある高さ以上のセクション区切りだけを選んで表
818 示します(実際にやって見れば分かります)。
820 @code{*Sectioning Lines*}バッファは、
821 @table @kbd
822 @item M-x YaTeX-section-overview
823 @dots{} セクション区切り一覧バッファを生成
824 @end table
825 @cindex セクション区切り一覧バッファ[せくしよんくきりいちらんはつは]
826 で作成することができます。このバッファをを選択し任意の行でスペースを押すと、
827 該当するセクション区切りのある本文中の場所にジャンプします。さらに、同バッ
828 ファで @kbd{u} を押すと、ソーステキストの対応するセクションコマンドが一階
829 層上がり(例: subsection が section に変わる)、@kbd{d}を押すと一階層下がり
830 ます。@code{*Sectioning Lines*}バッファにあるセクション区切りの行をマーク
831 しておいて@kbd{U}を押すとリジョン内のものに対応するソーステキストのセクショ
832 ンコマンドすべてが一階層上がり、@kbd{D}を押すと下がります。セクション区切
833 り一覧バッファで利用できるキーコマンドには以下のものがあります。
835 @table @kbd
836 @item SPC
837 @dots{} 対応するソース行へジャンプ
838 @item .
839 @dots{} 対応するソース行を表示
840 @item u
841 @dots{} カーソル位置に対応するセクションコマンドを一階層上げる
842 @item d
843 @dots{} カーソル位置に対応するセクションコマンドを一階層下げる
844 @item U
845 @dots{} マークしたセクションコマンドを一階層上げる
846 @item D
847 @dots{} マークしたセクションコマンドを一階層上げる
848 @item 0〜6
849 @dots{} レベル n 以下のセクションコマンドを隠して表示
850 @end table
852 @cindex 論理階層[ろんりかいそう]
853 @cindex セクション区切り[せくしよんくきり]
854 @cindex ジャンプ[しやんふ]
856 @node large型補完, maketitle型補完, section型補完, Completion
857 @comment node-name, next, previous, up
858 @section large型補完
859 @cindex large型補完[largeかたほかん]
860 @cindex prefix l
862 @code{@{\large @}} のような形式の補完を large 型補完と呼ぶことにします。
864 @table @kbd
865 @item [prefix] l
866 @dots{} large 型補完開始
867 @end table
869 @noindent
870 がlarge型補完の開始です。@kbd{[prefix] l} を押すと、ミニバッファに
872 @example
873 @{\??? @} (default large):
874 @end example
876 @noindent
877 と表示されるので、上記のものと同じ要領で補完入力して下さい。補完候補に用意
878 されているのは、@samp{footnotesize} や @samp{huge} のような文字サイズ指定
879 子と、@samp{bf}や@samp{dg}のようなフォント指定子です。
880 @cindex 文字サイズ指定子[もしさいすしていし]
881 @cindex フォント指定子[ふおんとしていし]
883 @subsection 既に書いた文字を括る
884 @cindex 括る[くくる]
886 また、begin型補完の時と同様、先に書いてしまった一連の文章の文字のサイズ
887 を変えたいと思う時がありますが、そのような時は、サイズや大きさを変えたい文
888 字の範囲をマークしてから、呼び出しキーを @kbd{[prefix] L} と、大文字の L
889 に変えて呼び出せば、そのリジョン全体が、ブレースで囲まれます。
891 @node maketitle型補完, Arbitrary completion, large型補完, Completion
892 @comment node-name, next, previous, up
893 @section maketitle型補完
894 @cindex maketitle型補完[maketitleかたほかん]
895 @cindex prefix m
897 @code{\maketitle} の形式の補完を maketitle 型補完と呼ぶことにします。
899 @table @kbd
900 @item [prefix] m
901 @dots{} maketitle 型補完開始
902 @end table
904 @noindent
905 で、maketitle 型補完を開始します。補完の要領は今までのものとまったく同じで
906 す。La@TeX{} 用のコマンド名が補完候補として用意されています。
908 @node Arbitrary completion, end補完, maketitle型補完, Completion
909 @comment node-name, next, previous, up
910 @section 随時補完
911 @cindex 随時補完[すいしほかん]
912 @cindex prefix SPC
914 さて、今まで述べた典型的な La@TeX{} コマンド形式の補完入力を用いずに、今
915 入力しようとしている La@TeX{} コマンドを文書中の任意の位置で随時補完するこ
916 ともできます。La@TeX{} コマンド(先頭が\で始まる)を入力している途中で、
918 @table @kbd
919 @item [prefix] SPC
920 @dots{} 随時補完
921 @end table
923 @noindent
924 を入力すれば、全ての補完候補の中から一致するものが選ばれカーソル位置に挿入
925 されます。
927 @node end補完, Accent mark completion, Arbitrary completion, Completion
928 @comment node-name, next, previous, up
929 @section end補完
930 @cindex end補完[endほかん]
931 @cindex prefix e
933 現在開いたままの環境名を自動的に検出し、@code{\end@{環境名@}}を挿入しま
934 す。begin 型補完を用いれば環境の閉じ忘れはないのですが、時にはついつい手で
935 @code{\begin@{環境名@}} を入れてしまい、悲しい思いをすることがあります。そ
936 のような時には気にせず続けて文章を入力し、しかるのちに
938 @table @kbd
939 @item [prefix] e
940 @dots{} end 補完
941 @end table
943 @noindent
944 とすることで、現在開いている環境名で \end{} が補われます。
946 @node Accent mark completion, Image completion, end補完, Completion
947 @comment node-name, next, previous, up
948 @section アクセント記号補完
949 @cindex アクセント記号補完[あくせんときこうほかん]
950 @cindex prefix a
951 @cindex 欧文[おうふん]
953 欧文のアクセント記号(@code{\`@{o@}}など)を入力する時は、
955 @table @kbd
956 @item [prefix] a
957 @dots{} アクセント記号入力
958 @end table
960 @noindent
961 を押すと、ミニバッファに
963 @example
964 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b
965 @end example
967 @noindent
968 というメニューが出て来るので、数字、または対応する記号/英字を入力
969 して下さい。すると編集バッファに、
971 @example
972 \`@{@}
973 @end example
975 @noindent
976 があらわれ、カーソルが@{@}内に位置するので、さらに一文字入力する事で、
978 @example
979 \`@{o@}
980 @end example
982 @noindent
983 が完成され、カーソルは@{@}の外に戻ります。
985 @node Image completion, Greek letter completion, Accent mark completion, Completion
986 @comment node-name, next, previous, up
987 @section 数式記号イメージ補完
988 @cindex 数式記号イメージ補完[すうしききこういめえしほかん]
989 @cindex イメージ補完[いめえしほかん]
990 @cindex ;
991 @cindex 数式モード[すうしきもおと]
992 @cindex 矢印[やしるし]
993 @cindex Σ[しくま]
994 @cindex leftarrow
995 @cindex ∞[むけんたい]
997 主に数式モードで使用される、矢印やΣなどの記号を擬似的に表現するキー入力
998 で、La@TeX{} コマンドを入力できます。これは野鳥自身の「数式モード」でのみ
999 動作します。野鳥はカーソルが@TeX{}の数式環境の中にある時に@kbd{;}や、
1000 @kbd{:}に特殊な機能を持たせます。
1002 さて、例えば、←(leftarrow)をASCII文字だけで表現する場合、一般的には「<-」
1003 のようにしますが、これを利用して、数式記号イメージ入力モードで
1004 @code{\leftarrow}を入力するには、@kbd{;}(セミコロン)を打ってから@kbd{<-}と
1005 入力します。同様に、長い矢印←-(long-leftarrow) をASCII文字だけで表現する
1006 場合「<--」とするので、@code{\longleftarrow}を入力するためには、@kbd{;<--}
1007 と入力します。あるいは無限大記号をASCII文字だけで表現する時は「oo」のよう
1008 にすることから、@code{\infty} を入力する時は、@kbd{;oo}とキー入力します。
1010 これらの操作をまとめると次のようになります。
1012 @example
1013 INPUT 入力される La@TeX{} コマンド
1014 ; < - @code{\leftarrow}
1015 ; < - - @code{\longleftarrow}
1016 ; < - - > @code{\longleftrightarrow}
1017 ; o @code{\circ}
1018 ; o o @code{\infty}
1019 @end example
1022 @noindent
1023 いずれの場合も、イメージ入力を行っている途中で望みのものがバッファ
1024 に表示されたなら、そこでイメージ入力を止めて次の編集動作に移っても
1025 構いません。
1027 @cindex ;自身[;ししん]
1028 数式環境中で@samp{;}自身を入力するには@kbd{;;}のようにします。イメージ
1029 入力の途中でTABを押すと、それまで入力した文字で始まるもの一覧が表示されま
1030 す。ここで目的の La@TeX{} コマンドまでカーソルを移動し再度TABを押すことで
1031 その La@TeX{} コマンドがバッファに挿入されます。
1033 どのキー入力にどの記号が対応しているか全て知りたい時は、@kbd{;}を押した
1034 直後にTABを押してください。以下の例は、@kbd{;<}と押した後にTABを押したもの
1035 です。
1037 @example
1038 KEY LaTeX sequence sign
1039 < \leq ≦
1040 << \ll 《
1041 <- \leftarrow ←
1042 <= \Leftarrow <=
1043 @end example
1045 左から[入力キー]、[対応する La@TeX{} コマンド]、[(擬似)記号図示]、と
1046 いう順でメニューが出て来るので、よく使うものを覚えておくと良いでしょ
1047 う。ものによってはASCII文字で表現することが困難なので、あまり覚え
1048 やすいキー並びではないものがあるでしょうから、そのような場合は
1049 \maketitle 型補完で入力するか、以下に述べる対応表の設定を行って単
1050 純なキー並びのものを設定すると良いでしょう。
1052 入力キーと La@TeX{} コマンド、記号の対応表を個人的に設定したい場合は
1053 Emacs-Lisp 変数 @code{YaTeX-math-sign-alist-private} に定義してください。
1054 その内容とデフォルトのものを合わせたものが対応表として使用されます(private
1055 の方が優先される)。なお、この変数の構造については @file{yatexmth.el} を参
1056 照してください。
1057 @cindex YaTeX-math-sign-alist-private
1059 @node Greek letter completion, , Image completion, Completion
1060 @comment node-name, next, previous, up
1061 @section ギリシャ文字補完
1062 @cindex ギリシャ文字補完[きりしやもしほかん]
1063 @cindex :
1065 もう一つ、数式環境中で@kbd{:}を押すとギリシャ文字入力モードに入ります。
1066 @kbd{:}を押した直後に@kbd{a}を押すと@code{\alpha}が、@kbd{g} を押すと
1067 @code{\gamma}が、などアルファベットに対応したギリシャ文字が挿入されます。
1068 操作方法は;の数式記号補完とまったく同じです。まずは@kbd{:}の直後に
1069 TABを押してどのアルファベットにどのギリシャ文字が対応しているか調べてみて
1070 ください。
1072 @kbd{;}と@kbd{:}を数式環境中で押しているにもかかわらず、イメージ補完が働
1073 かない場合は、@kbd{C-u ;}のように universal-argument をつけてキーを押すこ
1074 とにより、強制的にイメージ補完に入ることができます。また、この時にどのよう
1075 な状態で数式環境内判定に失敗したかをご連絡下さい。
1077 @node Local dictionary, Commenting out, Completion, Top
1078 @comment node-name, next, previous, up
1079 @chapter ローカル辞書
1080 @cindex ローカル辞書[ろおかるししよ]
1081 @cindex .yatexrc
1083 補完入力用の候補は三種類の辞書から構成されています。一つは
1084 @file{yatex.el}に組み込まれた「標準辞書」、もう一つはユーザが個人的に常用
1085 するコマンドを保存する「ユーザ辞書」、そしてもうひとつはあるディレクトリで
1086 のみ有効なコマンドを保存する「ローカル辞書」です。
1088 補完入力時に新しい単語を入れた場合に、その単語をどの辞書に入れるか聞いて
1089 来ます。
1091 @example
1092 `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard
1093 @end example
1095 @noindent
1096 というプロンプトに対し、@kbd{u}と答えると「ユーザ辞書」を、@kbd{l}と答える
1097 とローカル辞書を更新し、@kbd{n}と答えると辞書ファイルは更新せず現在のEmacs
1098 セッションのみ有効な単語とし、@kbd{d}と答えると新たな単語を学習せずに捨て
1099 ることになります。
1101 もし、ローカル辞書の機能はいらず、全てユーザ辞書の更新のみでよいと言う場
1102 合には@file{~/.emacs}などで、
1103 @cindex YaTeX-nervous
1105 @lisp
1106 (setq YaTeX-nervous nil)
1107 @end lisp
1109 @noindent
1110 として下さい。
1112 @node Commenting out, Cursor jump, Local dictionary, Top
1113 @comment node-name, next, previous, up
1114 @chapter コメントアウト
1115 @cindex コメントアウト[こめんとあうと]
1116 @cindex prefix <
1117 @cindex prefix >
1118 @cindex prefix .
1119 @cindex prefix ,
1122 La@TeX{}の編集には試行錯誤がつきものです。ある部分を一括でコメントアウト
1123 したり、コメントを外したりしたいことがあります。
1125 @table @kbd
1126 @item [prefix] >
1127 @dots{} リジョンを % でコメントアウト
1128 @item [prefix] <
1129 @dots{} リジョンの % のコメントを外す
1130 @end table
1132 @noindent
1133 は、あらかじめ設定したリジョンに対しての操作、
1135 @table @kbd
1136 @item [prefix] .
1137 @dots{} 現在のパラグラフをコメントアウト
1138 @item [prefix] ,
1139 @dots{} 現在のパラグラフのコメントを外す
1140 @end table
1142 @noindent
1143 は、カーソルの位置するパラグラフ全体に対しての操作です。なお、ここでいう
1144 「パラグラフ」は (@code{mark-paragraph}) 関数によりマークされる範囲を指し
1145 ます(標準設定で@kbd{ESC h}にバインドされている)。なお、既に@code{%}でコメ
1146 ントアウトされているパラグラフに対して繰り返しパラグラフのコメントを使用し
1147 た場合の動作は保証しませんので御注意ください。
1149 さて、文章に対してだけでなく、時には@code{\begin}, @code{\end} 自体に対
1150 してもコメントアウトの操作をしたいときがあります。このようなときは、
1151 @code{\begin@{@}} あるいは @code{\end@{@}} の行にカーソルを合わせ、
1153 @table @kbd
1154 @item [prefix] >
1155 @dots{} @code{\begin@{@}}〜@code{\end@{@}} 全てコメントアウト
1156 @item [prefix] <
1157 @dots{} @code{\begin@{@}}〜@code{\end@{@}} 全てコメントを外す
1158 @end table
1160 @noindent
1161 とすることで、@code{\begin〜\end}で囲まれる環境全てに対してコメント操作し、
1163 @table @kbd
1164 @item [prefix] .
1165 @dots{} @code{\begin@{@}} と @code{\end@{@}} をコメントアウト
1166 @item [prefix] ,
1167 @dots{} @code{\begin@{@}} と @code{\end@{@}} のコメントを外す
1168 @end table
1170 は、対応する @code{\begin} と @code{\end} 2行だけを、コメント操作の対象と
1171 します。リジョンをコメントアウトしようとして、マークを設定したのちにカーソ
1172 ルを移動し@kbd{[preifx] >} を押してもカーソルが @code{\begin@{@}} の上にあ
1173 ると@code{\begin@{@}}〜@code{\end@{@}}モードでコメント機能が働いてしまうの
1174 で注意して下さい。
1176 @node Cursor jump, Modifying/Deleting, Commenting out, Top
1177 @comment node-name, next, previous, up
1178 @chapter カーソルジャンプ
1179 @cindex カーソルジャンプ[かあそるしやんふ]
1180 @cindex prefix g
1182 @section 対応オブジェクトへのジャンプ
1184 文書中のいろいろな場所で
1186 @table @kbd
1187 @item [prefix] g
1188 @dots{} 対応するオブジェクトにジャンプ
1189 @end table
1191 @noindent
1192 を押すことにより、カーソル位置のLa@TeX{}コマンドに対応する場所にジャンプ
1193 します。対応関係が存在すると解釈されるコマンドには以下のものがあります。
1195 @itemize @bullet
1196 @item @code{\begin@{@}}←→@code{\end@{@}}
1197 @item @code{%#BEGIN}←→@code{%#END}
1198 @item @code{\label@{@}}←→@code{\ref@{@}}
1199 @item @code{\include(\input)}→対応するファイル
1200 @item @code{\bibitem@{@}}←→@code{\cite@{@}}
1201 @end itemize
1203 @code{\begin@{@}} か @code{\end@{@}} の行で@kbd{[prefix] g}を押すことに
1204 より、対応する@code{end/begin}の行にジャンプします。もちろん対応するものが
1205 ない場合はエラーになります。またこれは、領域固定のための @code{%#BEGIN} と
1206 @code{%#END} のペアに対しても同様に動作します。なお、@code{label/ref}や
1207 @code{cite/bibitem}対応するものが別ファイルにある時は、ジャンプ先となるファ
1208 イルがオープンされていなければなりません。@xref{%#記法}
1209 メインの .tex ファイルの @code{\include{chap1}} などにカーソルを合わせ、
1210 @kbd{[prefix] g} を押すと、@file{chap1.tex} にジャンプします。
1212 また、
1214 @table @kbd
1215 @item [prefix] 4 g
1216 @dots{} 別ウィンドウで対応オブジェクトにジャンプ
1217 @end table
1219 @noindent
1220 を押すと、対応するオブジェクトへのジャンプを別ウィンドウで行います。ただし、
1221 この機能は @code{begin/end}, @code{%#BEGIN/%#END} 間のジャンプに対しては
1222 (意味がないと思われるので)機能しないので注意してください。
1224 @section メインファイルへのジャンプ
1226 @file{chap1.tex}のようなサブファイルで、
1228 @table @kbd
1229 @item [prefix] ^
1230 @dots{} メインファイルにジャンプ
1231 @item [prefix] 4 ^
1232 @dots{} 別ウィンドウでメインファイルにジャンプ
1233 @end table
1235 @noindent
1236 を押すと、メインファイルの編集バッファに切替えます。もし、メインファイルを
1237 オープンしていない場合は、カレントディレクトリから探して自動的にオープンし
1238 ます。
1240 @section 環境を単位としたジャンプ
1242 さらに現在の環境を単位として機能するコマンドに以下のものがあります。
1244 @cindex 環境の先頭へ[かんきようのせんとうへ]
1245 @cindex 環境の末尾へ[かんきようのまつひへ]
1246 @cindex 環境をマーク[かんきようをまあく]
1247 @cindex M-C-a
1248 @cindex M-C-e
1249 @cindex M-C-@@
1250 @table @kbd
1251 @item M-C-a
1252 @dots{} 環境の先頭(@code{\begin})へジャンプ
1253 @item M-C-e
1254 @dots{} 環境の末尾(@code{\end})へジャンプ
1255 @item M-C-@@
1256 @dots{} 環境全体をマーク
1257 @end table
1259 上記のコマンドは通常の@kbd{[prefix]}キーではなく@kbd{META}キーをプリフィク
1260 スとして機能するのでご注意下さい。
1264 @node Modifying/Deleting, Filling, Cursor jump, Top
1265 @comment node-name, next, previous, up
1266 @chapter 変更/削除
1267 @cindex 変更/削除[へんこう/さくしよ]
1268 @cindex prefix c
1269 @cindex prefix k
1271 既に入力されている La@TeX{} コマンドの変更/削除のために以下の機能が用意
1272 されています。
1274 @table @kbd
1275 @item [prefix] c
1276 @dots{} カーソル位置の La@TeX{} コマンドの変更
1277 @item [prefix] k
1278 @dots{} カーソル位置の La@TeX{} コマンドの削除
1279 @end table
1281 @noindent
1282 これらのコマンドは、コマンドを起動する場所によって動作を決定するので注意し
1283 て下さい。
1285 @menu
1286 * Changing LaTeX command:: La@TeX{} コマンドの変更
1287 * Killing LaTeX command:: La@TeX{} コマンドの削除
1288 @end menu
1290 @node Changing LaTeX command, Killing LaTeX command, Modifying/Deleting, Modifying/Deleting
1291 @comment node-name, next, previous, up
1292 @section La@TeX{} コマンドの変更
1294 変更したい La@TeX{} コマンドにカーソルを合わせて @kbd{[prefix] c}
1295 を押すとそのコマンドを補完入力などを用いて手軽に変えることができます。
1296 @kbd{[prefix] c} で変更できるコマンドには以下のものがあります。
1298 @itemize
1299 @item @code{begin/end} の環境名
1300 @item section型コマンドのコマンド名
1301 @item section型コマンドの引数
1302 @item section型コマンドのオプションパラメータ([]で囲まれたもの)
1303 @item large型コマンド
1304 @item (イメージ補完で入力可能な)数式モード専用のmaketitle型コマンド
1305 @end itemize
1307 変えたいsection型コマンドの引数がさらに La@TeX{} コマンドを含む場合は、
1308 その引数を囲む中括弧の上で @kbd{[prefix] c} を押すことで中のコマンドを変更
1309 対象判定から除外することができます。
1311 @cindex 環境名の変更[かんきようめいのへんこう]
1313 @node Killing LaTeX command, , Changing LaTeX command, Modifying/Deleting
1314 @comment node-name, next, previous, up
1315 @section La@TeX{} コマンドの削除
1317 @kbd{[prefix] k} は起動する位置により
1318 次のような動作を行います。
1319 @cindex 環境の削除[かんきようのさくしよ]
1322 @example
1323 起動位置 動作
1324 \begin, \endの行 @code{\begin\end}ペアの削除
1325 %#BEGIN, %#END の行 %#BEGIN,%#ENDペアの削除
1326 section型コマンドの上(中) section型コマンドの削除
1327 フォント指定括弧の上 フォント指定の削除
1328 括弧の上 対をなす括弧の削除
1329 @end example
1331 @noindent
1332 @code{\begin, \end} および @code{%#BEGIN, %#END} を削除する場合、
1333 @code{\begin, \end} や @code{%#BEGIN, %#END} の存在する行は
1334 まるごと削除されるので、それらの一行に @code{\begin} などを二つ以上連ねて
1335 書かないように注意してください。
1336 上記のものはすべて本文を囲う「容器」を削除するように働きますが、
1337 universal-argument (@kbd{C-u}) を打った後で@kbd{[prefix] k}をタイプすると、
1338 それぞれの「容器」に含まれる「中身」も一気に削除します。以下の例を参考にし
1339 て下さい。
1341 @example
1342 元のテキスト: [prefix] k C-u [prefix] k
1343 本文\footnote@{脚注@}です。 本文脚注です。 本文です。
1344 ↑(カーソル位置)
1345 @end example
1347 @node Filling, Includeonly, Modifying/Deleting, Top
1348 @comment node-name, next, previous, up
1349 @chapter 桁揃え
1350 @cindex 桁揃え[けたそろえ]
1352 @section itemの桁揃え
1353 @cindex itemなどの桁揃え[itemなとのけたそろえ]
1354 @cindex prefix i
1356 itemize 環境中にある@code{\item}の項目(文章)が複数行に渡る場合に、項
1357 目の先頭を桁揃えしたい場合には、
1359 @c @table @kbd
1360 @c @item [prefix] i
1361 @c @dots{} itemの桁揃え
1362 @c @end table
1364 @table @kbd
1365 @item M-q
1366 @dots{} 桁揃え
1367 @end table
1369 @cindex NTT-jTeX[えぬていいていいしえいてつく]
1370 @noindent
1371 によって、その item のインデントの深さに応じて fill されます。なお、古い
1372 NTT jTeX を使用している場合には、Lisp 変数@code{NTT-jTeX}を@code{t}にセッ
1373 トして下さい。
1375 @cindex YaTeX-item-regexp
1376 このとき、変数@code{YaTeX-item-regexp}の値(標準では @code{"\\\\item"})を
1377 項目指定コマンドの正規表現として検索に使用します。itemize 環境で、独自のコ
1378 マンドを定義して項目を列挙している場合(例えば@code{\underlineitem})は、
1379 @file{~/.emacs} で次のように指定して下さい。
1381 @lisp
1382 (setq YaTeX-item-regexp
1383 "\\(\\\\\\(sub\\)*item\\)\\|\\(\\\\underlineitem\\)")
1384 @end lisp
1386 @noindent
1387 この変数の指定の仕方がよく分からない場合は、独自の項目列挙コマンドの名前を
1388 @code{@code{"\item"}で始まるものにして下さい(例えば"\itembf"})。
1390 野鳥の @kbd{M-q} では @code{\item} を環境に応じて以下のように「ハングイン
1391 デント」します。
1393 @example
1394 itemize, enumerate環境:
1395 >\item[ほげほげ] 英語では、特に意味のない単語を `foo' であらわしま
1396 > すが、これの日本語版ともいえる単語が「ほげほげ」
1397 > です。
1398 description環境:
1399 > \item[へろへろ] 「ほげほげ」をでたらめが単語として使った時に、第
1400 > 2のでたらめな単語として「へろへろ」が使われることが多
1401 > いようです。
1402 @end example
1404 @section パラグラフの桁揃え
1405 @cindex パラグラフの桁揃え[はらくらふのけたそろえ]
1406 @cindex M-q
1408 itemize環境以外でのパラグラフの桁揃え(fill)は、基本的に他のモードと同じ
1409 ように機能しますが、verbatim環境や、tabular環境など桁揃えをすると悲惨な状
1410 況になるような環境中では機能しません。また、\verb で括ってあるものは決して
1411 行分割されません(変数 @code{YaTeX-verb-regexp} で制御) )。さらに、一時的に
1412 インデントの深さを変えてある箇所では、そのインデントの先頭で@kbd{M-q}を押
1413 すことにより fill-prefix をいちいち変更しなくて桁揃えができます。
1416 @node Includeonly, What column, Filling, Top
1417 @comment node-name, next, previous, up
1418 @chapter 勝手にincludeonly
1419 @cindex 勝手にincludeonly[かつてにincludeonly]
1420 @cindex includeonly
1422 ファイルを分割して文章を入力している時には、メインファイル中に
1424 @example
1425 \includeonly@{現在編集中のファイル名@}
1426 @end example
1428 @noindent
1429 のように書いておくことで、タイプセットの時間を節約できますが、ちょっと他の
1430 ファイルを手直ししたい時には
1431 @cindex 他のファイルの手直し[ほかのふあいるのてなおし]
1433 @example
1434 \includeonly@{ちょっと手直ししたいファイル名@}
1435 @end example
1437 @noindent
1438 と書き直さなければならず手間がかかります。野鳥では現在編集しているファイル
1439 名がメインファイルの@code{\includeonly}にない場合には自動的にこれを検出し、
1440 次の指示を仰ぎます。
1442 @example
1443 A)dd R)eplace %)comment?
1444 @end example
1446 @noindent
1447 現在編集中のファイルを @code{\includeonly} のリストに加えたい時には@kbd{a}
1448 を、現在編集中のファイルだけを @code{\includeonly} にしたい時は@kbd{R}を、
1449 @code{\includeonly} の行をコメントアウトして無効化したい時には、@kbd{%}を
1450 それぞれ押して下さい。
1452 @node What column, Intelligent newline, Includeonly, Top
1453 @comment node-name, next, previous, up
1454 @chapter ここはどこ?
1455 @cindex ここどこ?[ここはとこ]
1456 @cindex prefix &
1457 @cindex 複雑なtabular[ふくさつなtabular]
1459 項目数の多い tabular などをたくさん書いていると下の方の行で、いま書いて
1460 いる桁がどこに対応するのかわからなくなってしまうことがあります。例えば、以
1461 下のような tabular において、
1463 @example
1464 \begin@{tabular@}{|c|c|c|c|c|c|c|c|}\hline
1465 氏名&所属&〒&住所&電話&FAX&帰省先&帰省先電話\\ \hline
1466 矢上二郎 & 6 & 223 & 横浜市港北区日吉 & xxx-yyy &
1467 zzz-www & トンガ & 9876-54321 \\
1468 日吉小僧 & 2 & \multicolumn@{2@}@{c|@}@{教えない@}
1469 &&&(???)
1470 \\ \hline
1471 \end@{tabular@}
1472 @end example
1474 @noindent
1475 (???)の部分がどの項目なのかすぐに判断するのは難しいでしょう。こんな時は、
1477 @table @kbd
1478 @item [prefix] &
1479 @dots{} 現在のカラム表示
1480 @end table
1481 @cindex 現在のカラム表示[けんさいのからむひようし]
1483 を押すとカーソル位置のカラムがどの項目に該当するかをミニバッファに表示しま
1484 す。tabular/array環境の第1行目を項目名の並びとみなして対応するものを探しま
1485 す。もし項目名として別のものを表示して欲しい場合は、行頭を@code{%}にしてダ
1486 ミーの項目並びを作っておくと良いでしょう。
1488 @node Intelligent newline, Changing mode of YaTeX, What column, Top
1489 @comment node-name, next, previous, up
1490 @chapter おまかせ改行
1491 @cindex おまかせ改行[おまかせかいぎょう]
1492 @cindex &入力[&にゅうりょく]
1493 @cindex prefix &
1495 tabular[*], array, itemize, enumerate, tabbing 環境をbegin型補完で入力し
1496 た時、または各環境内で
1498 @table @kbd
1499 @item ESC RET
1500 @dots{} おまかせ改行
1501 @end table
1503 @noindent
1504 を押すと、その環境に応じた行エントリを次の行に挿入します(begin型補完時に自
1505 動挿入されたエントリが不要な場合は undo によって消去できます)。例えば、
1506 tabular環境では、その環境のカラム数に対応した個数の @code{&} に加え、行末
1507 の @code{\\} を入れます。この時それ以前に @code{\hline} があればそれも付け
1508 加えます。環境とそれに応じて自動入力するものの対応は以下のようになります。
1510 @itemize
1511 @item @code{tabular}, @code{tabular*}, @code{array}
1513 カラム数-1 だけの @code{&} と @code{\\}。必要に応じて @code{\hline}
1515 @item @code{tabbing}
1517 一行目で定義している @code{\=} と同じ個数の @code{\>}。
1519 @item @code{itemize}, @code{enumerate}, @code{description}, @code{list}
1521 @code{\item} または @code{item[]}
1522 @end itemize
1524 tabular 環境の例のように、本機能は各環境の一行目の内容を参考にして動作す
1525 るので、なるべく二行目以降で呼び出すようにしてください。
1527 もし、その他の環境、例えば @code{foo}、に対して@code{おまかせ改行}を動作
1528 させたい時は、@code{YaTeX-intelligent-newline-foo} という名前の関数を定義
1529 します。定義した関数は、現在の行に改行を挿入した直後の行頭の位置で呼ばれま
1530 す。関数 @code{YaTeX-indent-line} を呼ぶと現在の環境のネストに応じた深さに
1531 インデントされるので、これを呼んでから何かを挿入するようなコードを書くとよ
1532 いでしょう。@file{yatexenv.el}内の関数
1533 @code{YaTeX-intelligent-newline-itemize} の定義などを参考にしてください。
1535 @node Changing mode of YaTeX, Online help, Intelligent newline, Top
1536 @comment node-name, next, previous, up
1537 @chapter 野鳥の動作モード切り替え
1538 @cindex モード切り替え[もーときりかえ]
1539 @cindex prefix w
1541 @table @kbd
1542 @item [prefix] w
1543 @dots{} 野鳥動作モード切り替えメニュー
1544 @end table
1546 @noindent
1547 で野鳥自身の動作を決定する以下のモードを切り替えます。
1549 @itemize @bullet
1550 @item 修正モード
1551 @item 野鳥数式モード
1552 @end itemize
1554 修正モードは、開き括弧入力時の処理をコントロールし、修正モードONの時は開き
1555 括弧の入力は開き括弧のみの入力になり、修正モードOFFの時は開き括弧の入力だ
1556 けで閉じ括弧まで入力します。デフォルト(起動時)の設定は@emph{OFF}です。
1558 野鳥数式モードは、変数 @code{YaTeX-auto-math-mode} が @code{nil} の時の
1559 み有効で、このとき@kbd{;}や@kbd{:}を押した時(@ref{Image completion}参照)に、
1560 どのようなイメージ補完を機能させるか、通常のキーとして機能させるかを手動で
1561 切り替えます。自動判定が遅いマシンでは@code{YaTeX-auto-math-mode}
1562 @code{nil}にセットし、野鳥数式モードを手動で切り替えると良いでしょう。
1565 @node Online help, Cooperation with other packages, Changing mode of YaTeX, Top
1566 @comment node-name, next, previous, up
1567 @chapter オンラインヘルプ
1568 @cindex オンラインヘルプ[おんらいんへるふ]
1569 @cindex apropos
1570 @cindex キーワード検索[きいわあとけんさく]
1571 @cindex prefix ?
1572 @cindex prefix /
1574 使おうとする La@TeX{} コマンドの用法がよく分からない時は、オンラインヘル
1575 プをひきましょう。ヘルプに関するキーには以下のものがあります。
1577 @table @kbd
1578 @item [prefix] ?
1579 @dots{} オンラインヘルプ
1580 @item [prefix] /
1581 @dots{} オンラインapropos
1582 @end table
1584 @section オンラインヘルプ
1585 @cindex グローバルヘルプ[くろおはるへるふ]
1586 @cindex プライベートヘルプ[ふらいへえとへるふ]
1587 @cindex YaTeX-help-file
1588 @cindex YaTeX-help-file-private
1590 「オンラインヘルプ」は、一般的な La@TeX{} コマンド(デフォルトでカーソル
1591 位置のコマンド)に対する説明を隣のバッファに表示します。この時参照されるヘ
1592 ルプ用ファイルには「グローバルヘルプ」と「プライベートヘルプ」の二種類があ
1593 り、前者は La@TeX{} の標準コマンドの主なものの説明を含むファイルで、変数
1594 @code{YaTeX-help-file}の値で指定されます。このファイルは通常公共の場所(デ
1595 フォルトで@code{$EMACSEXECPATH})に置かれ、誰もがその内容を更新できるように
1596 全員に書き込み権が与えられるべきものです。後者は、非標準もしくは個人的なマ
1597 クロ定義に関する説明が書かれているファイルで、変数
1598 @code{YaTeX-help-file-private}の値で指定されます。こちらはユーザのホームディ
1599 レクトリの下などに置かれます。
1601 @section オンラインapropos
1603 「オンラインapropos」は GNU Emacs の apropos と同様、ユーザが指定したキー
1604 ワードを説明文に含む項目すべてを隣のバッファに表示します。
1606 もし、調べようとしたLa@TeX{}コマンドに対する説明がヘルプファイル中に見つ
1607 からなかった場合は、説明文の入力を求めてくるので、可能であれば参考書などを
1608 調べてそのコマンドの説明を入力してください。もし、なにか標準的なコマンドに
1609 対する説明を書いたならばぜひ私までその説明をお送り下さい。次回の配布に含め
1610 たいと思います。
1612 @node Inclusion hierarchy browser
1613 @comment node-name, next, previous, up
1614 @chapter インクルード構造ブラウザ
1615 @cindex インクルード構造[いんくるうとこうそう]
1616 @cindex prefix d
1618 複数のファイルに分割しているドキュメントを書いている場合、
1620 @table @kbd
1621 @item [prefix] d
1622 @dots{} インクルード構造ブラウズ
1623 @end table
1625 @noindent
1626 を押すと、そのドキュメントの親ファイルを聞いて来ます。ここで全てのファイル
1627 の親となるファイル(デフォルトが示されているので大抵はRETのみ)を入力すると
1628 インクルードしている全てのファイルを解析し、インクルード状況を視覚的に表示
1629 します。このバッファでは以下のキー操作が有効です。
1631 @table @kbd
1632 @item n
1633 @dots{} 次の行に移動し対応するファイルを隣のバッファに表示
1634 @item p
1635 @dots{} 上の行に移動し対応するファイルを隣のバッファに表示
1636 @item N
1637 @dots{} 同じインクルードレベルの次のファイルに移動
1638 @item P
1639 @dots{} 同じインクルードレベルの前のファイルに移動
1640 @item j
1641 @dots{} 次の行に移動
1642 @item k
1643 @dots{} 上の行に移動
1644 @item u
1645 @dots{} 一代親にあたるファイルに移動
1646 @item .
1647 @dots{} カーソル位置のファイルを隣のバッファに表示
1648 @item SPC
1649 @dots{} 隣のバッファの対応ファイルをスクロールアップ
1650 @item DEL, b
1651 @dots{} 隣のバッファの対応ファイルをスクロールダウン
1652 @item <
1653 @dots{} 隣のバッファの対応ファイルの先頭を表示
1654 @item >
1655 @dots{} 隣のバッファの対応ファイルの末尾を表示
1656 @item '
1657 @dots{} (@kbd{<}や@kbd{>}の後で)元の表示位置に戻る
1658 @item RET, g
1659 @dots{} カーソル位置のファイルを隣のバッファでオープン
1660 @item mouse-2
1661 @dots{} RETと同じ(ウィンドウ使用時のみ)
1662 @item o
1663 @dots{} 隣のウィンドウに移動
1664 @item 1
1665 @dots{} 他のウィンドウを消す
1666 @item -
1667 @dots{} ブラウズウィンドウを小さくする
1668 @item +
1669 @dots{} ブラウズウィンドウを大きくする
1670 @item ?
1671 @dots{} ヘルプ表示
1672 @item q
1673 @dots{} 表示前の状態に戻る
1674 @end table
1676 ただし、隣のウィンドウのファイルの内容を表示する機能に関しては、対応する
1677 ファイルをクローズしてしまうとうまく働きませんのでご注意ください。
1679 @node Cooperation with other packages, Customizations, Online help, Top
1680 @comment node-name, next, previous, up
1681 @chapter 他パッケージとの連携
1682 @cindex 他パッケージとの連携[たはつけえしとのれんけい]
1684 @section gmhist
1685 @cindex gmhist
1686 @cindex コマンドヒストリ[こまんとひすとり]
1687 @cindex ヒストリ[ひすとり]
1689 @file{gmhist.el}と@file{gmhist-mh.el} をロードしている場合、プレヴューコ
1690 マンドの入力(@kbd{[prefix] tp]})、印刷コマンドの入力(@kbd{[prefix] tl})の
1691 時に独立したヒストリを利用できます。それぞれのプロンプトで、@kbd{M-p} を押
1692 すと直前に利用したコマンド文字列をくり返し呼び出すことができます。
1694 @section min-out
1695 @cindex min-out
1697 @file{min-out.el} (@code{outline-minor-mode}) と野鳥を組み合わせて使うこ
1698 とももちろん可能です。設定の方法に関しては@file{yatexm-o.el}をご覧ください。
1700 @node Customizations, Etc, Cooperation with other packages, Top
1701 @comment node-name, next, previous, up
1702 @chapter カスタマイズ
1703 @cindex カスタマイズ[かすたまいす]
1704 @cindex キーアサイン[きいあさいん]
1706 野鳥の動作を制御する種々の変数を独自に設定することにより、補完入
1707 力を起動するキーアサインを変えたり、環境名の補完候補をさらに充実さ
1708 せることなどができます。
1710 @menu
1711 * Lisp variables:: lisp 変数
1712 * Add-in functions:: 付加関数(アドイン関数)
1713 @end menu
1715 @node Lisp variables, Add-in functions, Customizations, Customizations
1716 @comment node-name, next, previous, up
1717 @section lisp 変数
1718 @cindex prefixキー変更[prefixきいへんこう]
1720 例えば prefix キーを @kbd{C-c} 以外のキーにしたい場合は、
1721 @code{YaTeX-prefix}に prefix キーにしたいシンボルを定義してください。さら
1722 に、「@kbd{C-c 英字}」というキーバインドは独自の関数が割り当ててあるので使
1723 いたくない。このような時は、@code{YaTeX-inhibit-prefix-letter} を @code{t}
1724 に設定することにより、@kbd{C-c 英字…}のバインドが全て、対応する@kbd{C-c
1725 C-英字…}に変わります(ただし、begin型 large型補完の大文字起動によるリジョ
1726 ン指定は可能なままです。これも無効にしたい場合は@code{t}ではなく 1 にセッ
1727 トして下さい。)。
1729 @menu
1730 * All customizable variables:: カスタマイズ変数一覧
1731 * Sample definitions:: カスタマイズ変数設定例
1732 * Hook variables:: hook変数
1733 * Hook file:: hook用ファイル
1734 @end menu
1736 @node All customizable variables, Sample definitions, Lisp variables, Lisp variables
1737 @comment node-name, next, previous, up
1738 @subsection カスタマイズ変数一覧
1739 @cindex カスタマイズ変数一覧[かすたまいすへんすういちらん]
1741 yatex-mode における次の変数がカスタマイズ可能です。@file{~/.emacs} で
1742 @code{setq} しておけば、そちらの定義が優先されます。括弧の中はデフォルト値
1743 です。実際に変数の値を変更する場合は @kbd{M-x describe-variable} で
1744 変数の詳細な説明を参照してください。
1746 @defvar YaTeX-prefix
1747 yatex-mode 中のプリフィクスキー(@kbd{C-c})
1748 @end defvar
1750 @defvar YaTeX-inhibit-prefix-letter
1751 prefix キーの直後のキーバインドで@kbd{英字}のものを@kbd{C-英字}に変更
1752 (@code{nil})
1753 @end defvar
1755 @defvar YaTeX-fill-prefix
1756 本文を書く時の行頭に挿入する接頭辞すなわち fill-prefix (@code{""(nil)})
1757 @end defvar
1759 @defvar YaTeX-user-completion-table
1760 学習したLa@TeX{}コマンド保存ファイル名(@code{"~/.yatexrc"})
1761 @end defvar
1763 @defvar YaTeX-kanji-code
1764 文書を作成する時の漢字コード1=Shift JIS, 2=JIS, 3=EUC(2 (MS-DOSでは1))
1765 @end defvar
1767 @defvar YaTeX-item-regexp
1768 itemの桁揃えの時に用いる、itemの正規表現(@code{"\\\\(sub\\)*item"})
1769 @end defvar
1771 @defvar YaTeX-verb-regexp
1772 verbコマンドの正規表現。先頭の\\\\はつけない(@code{"verb\\*?\\|path"})
1773 @end defvar
1775 @defvar tex-command
1776 La@TeX{}タイプセッタコマンド名 (@code{"jlatex"})
1777 @end defvar
1779 @defvar dvi2-command
1780 プレヴューアコマンド名(@code{"xdvi -geo +0+0 -s 4 -display (getenv"DISPLAY")"})
1781 @end defvar
1783 @defvar dviprint-command-format
1784 dviファイルの印刷に使われるコマンド式(@code{"dvi2ps %f %t %s | lpr"})
1785 @end defvar
1787 @defvar dviprint-from-format
1788 上の@code{%f}に相当する開始ページ指定書式、@code{%b} が開始ページ番号に変
1789 わる(@code{"-f %b"})
1790 @end defvar
1792 @defvar dviprint-to-format
1793 @code{%t} に相当する終了ページ指定書式、@code{%e}が終了ページ番号に変わる
1794 (@code{"-t %e"})
1795 @end defvar
1797 @defvar makeindex-command
1798 makeindexコマンド(@code{"makeindex"} (MS-DOSでは@code{"makeind"}))
1799 @end defvar
1801 @defvar section-name
1802 最初のsection型補完の規定値(@code{"documentstyle"})
1803 @end defvar
1805 @defvar env-name
1806 最初のbegin型補完の規定値(@code{"document"})
1807 @end defvar
1809 @defvar fontsize-name
1810 最初のlarge型補完の規定値(@code{"large"})
1811 @end defvar
1813 @defvar single-command
1814 @end defvar
1815 最初のmaketitle型補完の規定値(@code{"maketitle"})
1817 @defvar YaTeX-need-nonstop
1818 @code{\nonstopmode@{@}}を自動的に付加するか(@code{nil})
1819 @end defvar
1821 @defvar latex-warning-regexp
1822 latexコマンドの出力するウォーニング行の正規表現(@code{"line.* [0-9]*"})
1823 @end defvar
1825 @defvar latex-error-regexp
1826 同じくエラー行の正規表現(@code{"l\\.[1-9][0-9]*"})
1827 @end defvar
1829 @defvar latex-dos-emergency-message
1830 MS-DOS上で動作する latex コマンドが、エラーにより停止するとき出力するメッ
1831 セージ (@code{"Emergency stop"})
1832 @end defvar
1834 @defvar latex-message-kanji-code
1835 jlatex コマンドの出力するメッセージの漢字コード.タイプセットバッファ
1836 の出力が化ける時は、これを設定する(2, Nemacsでのみ有効)
1837 @end defvar
1839 @defvar NTT-jTeX
1840 NTT-j@TeX{}使用時@code{t}にする(@code{nil})
1841 @end defvar
1843 @defvar YaTeX-item-regexp
1844 item化コマンドの正規表現(@code{"\\\\(sub\\)*item"})
1845 @end defvar
1847 @defvar YaTeX-nervous
1848 ローカル辞書を用いる時 @code{t} (@code{t})
1849 @end defvar
1851 @defvar YaTeX-sectioning-regexp
1852 セクション区切り設定コマンドの正規表現
1853 (@code{"part\\|chapter\\|\\(sub\\)*\\(section\\|paragraph\\)"})
1854 @end defvar
1856 @defvar YaTeX-fill-inhibit-environments
1857 fill を抑止する環境名のリスト(@code{'("verbatim" "tabular")})
1858 @end defvar
1860 @defvar YaTeX-uncomment-once
1861 領域uncommentで行頭の複数の@code{%}を全て削除するか(@code{nil})
1862 @end defvar
1864 @defvar YaTeX-close-paren-always
1865 開き括弧の入力で常に閉じ括弧を入力する(@code{t})
1866 @end defvar
1868 @defvar YaTeX-auto-math-mode
1869 数式モードの切り替えを自動的に行う。(@code{t})
1870 @end defvar
1872 @defvar YaTeX-math-key-list-private
1873 数式イメージ補完で用いる (プリフィクスキー . 対応補完テーブル) の
1874 alist(@code{nil})。補完テーブルの書き方については
1875 @file{yatexmth.el}を参照。
1876 @end defvar
1878 @defvar YaTeX-default-pop-window-height
1879 1画面の時にタイプセットバッファを初めて作成する時の高さ。数値で行数、数字
1880 文字列でEmacsウィンドウに対する百分率(10)。
1881 @end defvar
1883 @defvar YaTeX-help-file
1884 共用ヘルプファイル(@file{$EMACS/etc/YATEXHLP.jp})
1885 @end defvar
1887 @defvar YaTeX-help-file-private
1888 個人用ヘルプファイル(@file{"~/YATEXHLP.jp"})
1889 @end defvar
1891 @defvar YaTeX-no-begend-shortcut
1892 @kbd{[prefix] b ??} のショートカットを使わず、@kbd{[prefix] b} だけで補完
1893 入力に入る(@kbd{nil})
1894 @end defvar
1896 @defvar YaTeX-hilit-pattern-adjustment-private
1897 正規表現とそれにマッチするものの論理的意味をシンボルであらわしたものの
1898 リスト…のリスト。hilit19 を組み込んでいる時のみ有効。
1899 詳しくは @code{(assq 'yatex-mode hilit-patterns-alist)}
1900 した結果と、変数 @code{YaTeX-hilit-pattern-adjustment-default} の値(と場合
1901 によっては hilit19 のドキュメント)を参照せよ。
1902 @end defvar
1904 @defvar YaTeX-sectioning-level
1905 LaTeXのセクション単位宣言コマンドとその論理的高さのalist。
1906 @end defvar
1908 @defvar YaTeX-hierarchy-ignore-heading-regexp
1909 Hierarchy バッファは通常ファイルヘッダとして、LaTeXのセクション宣言コマン
1910 ドの引数を検索し、それがなければコメント行を探すが、その際にヘッダとしては
1911 意味を持たないパターンをこの変数に設定する。デフォルトでは RCS ヘッダとモー
1912 ド指定行(-*- xxx -*-)が設定されている。
1913 @end defvar
1915 @defvar YaTeX-skip-default-reader
1916 Non-nil に設定するとsection型コマンドの引数入力時、アドイン関数がなければ
1917 ミニバッファでの読み込みをせずに入力を完了させる。
1918 @end defvar
1920 @defvar YaTeX-create-file-prefix-g
1921 @code{\include}などで @kbd{prefix g}した時に、ジャンプ先が存在しないファイ
1922 ルであってもオープンする(@code{nil})。
1923 @end defvar
1925 @defvar YaTeX-simple-messages
1926 各種補完時のメッセージ出力を簡素化する(@code{nil})。
1927 @end defvar
1929 @defvar YaTeX-hilit-sectioning-face
1930 色付けが有効な時の @code{\part} の色
1931 (@code{'(yellow/dodgerblue yellow/slateblue)})。
1932 リストの第一要素は @code{hilit-background-mode} が @code{'light} の時の、
1933 第二要素は @code{'dark} の時の @code{\chapter} の色で、文字色/背景色 のよ
1934 うに指定する。
1935 @end defvar
1937 @defvar YaTeX-hilit-sectioning-attenuation-rate
1938 色付けが有効な時の、@code{\subparagraph} の色を @code{\chapter} の濃度の何
1939 %薄くしたものにするか(@code{'(15 40)}。@code{YaTeX-hilit-sectioning-face}
1940 の項参照。
1941 @end defvar
1943 @defvar YaTeX-use-AMS-LaTeX
1944 AMS-LaTeX を使用する場合は @code{t} に設定する(@code{nil})。
1945 @end defvar
1947 @node Sample definitions, Hook variables, All customizable variables, Lisp variables
1948 @comment node-name, next, previous, up
1949 @subsection カスタマイズ変数設定例
1950 @cindex 設定例[せつていれい]
1952 たとえば、prefix キーとして@kbd{ESC}を使用し、新たな補完候補を格納するファ
1953 イルを、@file{~/src/emacs/yatexrc} にし、行頭の prefix をタブ文字一つに変
1954 えたいときは、
1956 @lisp
1957 (setq YaTeX-prefix "\e"
1958 YaTeX-user-completion-table "~/src/emacs/yatexrc"
1959 YaTeX-fill-prefix " ")
1960 @end lisp
1962 @noindent
1963 を @file{~/.emacs} に加えます。
1965 @node Hook variables, Hook file, Sample definitions, Lisp variables
1966 @comment node-name, next, previous, up
1967 @subsection hook変数
1968 @cindex hook変数[hookへんすう]
1969 @cindex yatex-mode-hook
1970 @cindex yatex-mode-load-hook
1972 また、hook 変数 @code{yatex-mode-hook}, @code{yatex-mode-load-hook} を用
1973 意しています。すべての yatex-mode のバッファで作用させたいものは、
1974 @code{yatex-mode-hook} に記述し、@file{yatex.el} をロードする時だけ作用さ
1975 せたいものは@code{yatex-mode-load-hook} に記述します。例えば、
1976 @code{outline-minor-mode} を利用する場合、それぞれのバッファで
1977 @code{outline-minor-mode} を有効にしたいので、@code{yatex-mode-hook} を次
1978 のように設定します。
1980 @lisp
1981 (setq yatex-mode-hook
1982 '(lambda () (outline-minor-mode t)))
1983 @end lisp
1985 @noindent
1986 逆に、独自のキー定義を行いたい時などは、@code{yatex-mode-load-hook} を利用
1987 します。例えば、begin 型補完において、 document や、enumerate 以外の環境名
1988 もショートカットキーで入れたいなどという時は、次のようにします。以下の例は、
1989 @kbd{[prefix] ba} で @code{\begin@{abstract@}}, @code{\end@{abstract@}} を
1990 挿入します。
1992 @lisp
1993 (setq yatex-mode-load-hook
1994 '(lambda() (YaTeX-define-begend-key "ba" "abstract")))
1995 @end lisp
1997 なお、新たなキーの定義には、関数 @code{YaTeX-define-key}
1998 @code{YaTeX-define-begend-key}を利用するようにしてください。
2000 @node Hook file, , Hook variables, Lisp variables
2001 @comment node-name, next, previous, up
2002 @subsection hook用ファイル
2004 変数 @code{yatex-mode-load-hook} で定義する内容が多い時は、
2005 @file{yatexhks.el}というファイルを作り、その中に野鳥関連の設定を書く事で、
2006 初期化の時に自動的にロードします。
2009 @node Add-in functions, , Lisp variables, Customizations
2010 @comment node-name, next, previous, up
2011 @section 付加関数(アドイン関数)
2013 各種補完時に、環境名やコマンド名に応じたきめ細やかな補完入力機能を実現す
2014 るための関数を作成することができます。この関数の作成方法や、組み込み方法に
2015 関しては、@code{yatexadd.doc} をご覧ください。
2017 @node Etc, Copying, Customizations, Top
2018 @comment node-name, next, previous, up
2019 @chapter その他
2021 野鳥の標準の La@TeX{} コマンドの辞書には、作者が頻繁に使うものしか登録さ
2022 れていません。これは、補完候補に使いそうもないコマンドが存在して、補完した
2023 いコマンドを出すまでのストローク数を増やしてしまう事を防止するためです。標
2024 準辞書にないコマンドも、できるだけ補完入力方式を利用し、ユーザ辞書を充実さ
2025 せることで、あなたの La@TeX{} スタイルにあった野鳥へと育っていくことでしょ
2026 う。
2028 @node Copying, Concept Index, Etc, Top
2029 @comment node-name, next, previous, up
2030 @chapter 取り扱い
2032 本プログラムはフリーソフトウェアです。本プログラムを使用して生じたいかな
2033 る結果に対しても作者は責任を負わないこととします。転載等に関しては制限いた
2034 しません。常識的に扱ってください。また、使用している旨をメイルでお知らせい
2035 ただくと、作者は喜んでサポートに励むことでしょう。
2037 苦情、希望、バグ報告、感想等は歓迎いたします。
2038 連絡は yuuji@@ae.keio.ac.jp または、
2039 pcs39334@@asciinet.or.jp まで(1995年3月現在)。
2040 継続的に使用してくださる方はメイリングリスト「fj野鳥の会」に
2041 是非加入してください。加入方法については本パッケージの @file{docs/qanda}
2042 ファイルの「その他」の章を御覧ください。
2044 仕様は、予告なく確実に(気分次第で)変更されます:-p。
2046 @flushright
2047 広瀬雄二
2048 @end flushright
2050 @node Concept Index, , Copying, Top
2051 @comment node-name, next, previous, up
2052 @unnumbered 索引
2053 @printindex cp
2055 @c カスタマイズ変数索引を索引と分離する場合にはコメントアウトを外す!!!
2056 @c @node Variable Index
2057 @c @comment node-name, next, previous, up
2058 @c @unnumbered カスタマイズ変数索引
2059 @c @printindex vr
2061 @contents
2063 @bye
2065 @c Local Variables:
2066 @c fill-column: 74
2067 @c fill-prefix: nil
2068 @c End:
2070 Tag table:
2072 End tag table