yatex: docs/yatexj.tex annotate

yatex

annotate docs/yatexj.tex @ 409:781604df4cbd

New variables: YaTeX-electric-indent-mode, yahtml-electric-indent-mode

author	HIROSE Yuuji <yuuji@gentei.org>
date	Wed, 11 Feb 2015 11:45:37 +0900
parents	c44910b36b95
children	9ab38ecfd3d1

rev	line source
yuuji@271	1 \def\lang{jp} % -- texinfo -- for Texinfo V.3.1
yuuji@271	2 \input texinfo
yuuji@271	3 @setfilename yatexj
yuuji@271	4 @settitle Yet Another tex-mode for Emacs
yuuji@272	5 @direntry
yuuji@272	6 * YaTeX: (yatexj). Yet Another tex-mode for Emacs (Japanese).
yuuji@272	7 @end direntry
yuuji@271	8
yuuji@271	9 @iftex
yuuji@271	10 @c @syncodeindex fn cp
yuuji@271	11 @c いつも忘れるのでここに書いとくか。
yuuji@271	12 @c C-l C-c n でノード入れ
yuuji@271	13 @c ノードいじったら C-l C-u C-n 全部のノード更新 C-l C-u C-e
yuuji@271	14 @c メニュー増やしたら C-l C-u C-m 全部のメニュー更新 C-l C-u C-a
yuuji@271	15 @c フォーマットするときは C-l C-e C-b
yuuji@409	16 @c Last modified Wed Feb 11 11:42:41 2015 on firestorm
yuuji@271	17 @syncodeindex vr cp
yuuji@271	18 @end iftex
yuuji@271	19
yuuji@271	20 @titlepage
yuuji@271	21 @sp 10
yuuji@271	22 @center
yuuji@271	23 @subtitle Yet Another tex-mode for emacs
yuuji@271	24 @title 『野鳥』
yuuji@271	25 @subtitle // YaTeX //
yuuji@271	26 @author @copyright{} 1991-2012 by HIROSE, Yuuji [yuuji@@yatex.org]
yuuji@271	27 @end titlepage
yuuji@271	28
yuuji@271	29 @node Top, Intro, (dir), (dir)
yuuji@271	30 @comment node-name, next, previous, up
yuuji@271	31
yuuji@271	32 @menu
yuuji@271	33 * Intro:: はじめに
yuuji@271	34 * Terminology:: マニュアル参照上の注意
yuuji@271	35 * Main features:: 主な機能
yuuji@271	36 * Installation:: インストール
yuuji@271	37 * Invocation:: プロセス起動
yuuji@271	38 * %#notation :: %#記法
yuuji@271	39 * Completion:: 補完入力
yuuji@271	40 * Local dictionary:: ローカル辞書
yuuji@271	41 * Commenting out:: コメントアウト
yuuji@271	42 * Cursor jump:: カーソルジャンプ
yuuji@271	43 * Modifying/Deleting:: LaTeXコマンドの変更/削除
yuuji@271	44 * Filling:: 桁揃え
yuuji@271	45 * Includeonly:: 勝手に includeonly
yuuji@271	46 * What column:: カラム位置ガイド
yuuji@271	47 * Intelligent newline:: おまかせ改行
yuuji@271	48 * Usepackage cheker:: 先回りusepackage
yuuji@271	49 * Changing mode of YaTeX:: 野鳥動作モード変更
yuuji@271	50 * Online help:: LaTeXオンラインヘルプ
yuuji@271	51 * Inclusion hierarchy browser:: ファイル分割階層構造の表示
yuuji@271	52 * Cooperation with other packages:: 他パッケージとの連携
yuuji@271	53 * Customizations:: カスタマイズ
yuuji@271	54 * Etc:: その他
yuuji@271	55 * Copying:: 取り扱い
yuuji@271	56 * Concept Index:: 索引
yuuji@271	57
yuuji@271	58 @end menu
yuuji@271	59
yuuji@271	60 @node Intro, Terminology, Top, Top
yuuji@271	61 @comment node-name, next, previous, up
yuuji@271	62 @chapter はじめに
yuuji@271	63 @cindex Demacs
yuuji@271	64 @cindex Mule
yuuji@271	65 @cindex LaTeX
yuuji@271	66 @cindex やちょう[やちよう]
yuuji@271	67
yuuji@271	68 野鳥は、GNU Emacs で La@TeX{} 用の文書を作成する時に pLa@TeX{} などの
yuuji@271	69 タイプセットコマンドや、プレヴューアの起動を Emacs 編集画面中から
yuuji@271	70 行えるようにすると共に、拡張性の高い種々の補完機能によりソーステキ
yuuji@271	71 ストの編集を支援します。さらに La@TeX{} コマンドのオンラインヘルプに
yuuji@271	72 よりマニュアルを調べる手間を軽減します。
yuuji@271	73
yuuji@271	74 English manual @xref{Top, , , yatexe,YaTeX English info}.
yuuji@271	75
yuuji@271	76 @node Terminology, Main features, Intro, Top
yuuji@271	77 @comment node-name, next, previous, up
yuuji@271	78 @chapter 本マニュアル参照上の注意
yuuji@271	79
yuuji@271	80 本マニュアルでは以下の表記を用います。
yuuji@271	81
yuuji@271	82 @itemize @bullet
yuuji@271	83 @item
yuuji@271	84 begin型コマンド
yuuji@271	85
yuuji@271	86 @code{\begin@{環境@} ～ \end@{環境@}}という形式のLaTeXコマンドを指します。
yuuji@271	87 begin型コマンドを補完入力することをbegin型補完と呼びます。
yuuji@271	88
yuuji@271	89 @item
yuuji@271	90 section型コマンド
yuuji@271	91
yuuji@271	92 @code{\section@{タイトル@}}や@code{\mbox@{内容@}}のように
yuuji@271	93 引数を取るLaTeXコマンドを指します。
yuuji@271	94
yuuji@271	95 @item
yuuji@271	96 maketitle型コマンド
yuuji@271	97
yuuji@271	98 @code{\maketitle}や@code{\tableofcontents}のように引数を取らないLaTeXコマ
yuuji@271	99 ンドを指します。
yuuji@271	100
yuuji@271	101 @item
yuuji@271	102 large型コマンド
yuuji@271	103
yuuji@271	104 @code{@{\large ...@}} や @code{@{\tt ...@}} のようなフォント/サイズ指定子
yuuji@271	105 を指します。
yuuji@271	106
yuuji@271	107 @item @kbd{[prefix]}
yuuji@271	108
yuuji@271	109 野鳥の機能を呼び出すためのプリフィクスキー。デフォルトでは@kbd{C-c}に割り
yuuji@271	110 当てられているので、特に変更していない場合本マニュアルの @kbd{[prefix]} と
yuuji@271	111 いう表記は、@kbd{C-c} と読み換えてください。
yuuji@271	112 @end itemize
yuuji@271	113
yuuji@271	114 @node Main features, Installation, Terminology, Top
yuuji@271	115 @comment node-name, next, previous, up
yuuji@271	116 @chapter 主な機能
yuuji@271	117
yuuji@271	118 @itemize @bullet
yuuji@271	119 @item タイプセッタやプレヴューアなどの編集画面からの起動(@kbd{C-c t})
yuuji@271	120 @item カーソル位置によらない固定リジョンの部分タイプセット
yuuji@271	121 @item \includeonlyのワンタッチ更新
yuuji@271	122 @item エラー箇所への自動ジャンプ(@kbd{C-c '})
yuuji@271	123 @item @code{\begin@{@}, \end@{@}, \section...} などの La@TeX{}
yuuji@271	124 コマンドの補完入力
yuuji@271	125 (@kbd{C-c b}, @kbd{C-c s}, @kbd{C-c l}, @kbd{C-c m})
yuuji@271	126 @item 既に入力したテキストを環境やコマンド引数の中に取り込む括り補完
yuuji@392	127 (リジョン指定後に通常補完キー)
yuuji@271	128 @item セクション区切り入力時の文書構造アウトライン表示
yuuji@271	129 @item セクションコマンドの一括シフト (@ref{view-sectioning})
yuuji@271	130 @item 補完辞書の学習
yuuji@271	131 @item La@TeX{} の環境やコマンドに応じたガイド付き引数入力
yuuji@271	132 @item 野鳥にないガイド付き引数入力関数の自動生成(@file{yatexgen.el})
yuuji@271	133 @item La@TeX{} コマンドの削除/変更(@kbd{C-c k}, @kbd{C-c c})
yuuji@271	134 @item ファイル間、@code{\begin}<->@code{\end}間、
yuuji@271	135 @code{\ref}<->@code{\label}間、
yuuji@271	136 @code{\cite}<->@code{\bibitem}ジャンプ(@kbd{C-c g})
yuuji@271	137 @item 一括コメントアウト/アンコメントアウト
yuuji@271	138 (@kbd{C-c >}, @kbd{C-c <}, @kbd{C-c ,}, @kbd{C-c .})
yuuji@271	139 @item アクセント記号/数式環境用コマンド/ギリシャ文字の入力支援
yuuji@271	140 (@kbd{C-c a}, @kbd{;}, @kbd{/})
yuuji@271	141 @item tabular/array環境のカラム位置ガイド
yuuji@271	142 @item 標準的 La@TeX{} コマンドのオンラインヘルプ(@kbd{C-c ?}, @kbd{C-c /})
yuuji@271	143 @item ドキュメントのインクルード構造の視覚的表示とバッファ切り替え
yuuji@271	144 (@kbd{C-c d})
yuuji@271	145 @item 補完入力したマクロに応じて必要な \userpackage を入れてくれる先回り
yuuji@271	146 userpackage
yuuji@271	147 @item \labelを打つことはもう忘れよう! refやcite補完入力で自動生成します
yuuji@271	148 @end itemize
yuuji@271	149
yuuji@271	150 @node Installation, Invocation, Main features, Top
yuuji@271	151 @comment node-name, next, previous, up
yuuji@271	152 @chapter 起動法
yuuji@271	153 @cindex Install
yuuji@271	154 @cindex インストール[いんすとおる]
yuuji@271	155 @cindex .emacs
yuuji@271	156 @cindex auto-mode-alist
yuuji@271	157 @cindex autoload
yuuji@271	158 @section 野鳥起動のための設定
yuuji@271	159
yuuji@271	160 ~/.emacsに下の2項目を加えます。
yuuji@271	161
yuuji@271	162 @lisp
yuuji@271	163 (setq auto-mode-alist
yuuji@271	164 (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist))
yuuji@271	165 (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t)
yuuji@271	166 @end lisp
yuuji@271	167
yuuji@271	168 次に野鳥の emacs-lisp ファイル群を置くディレクトリを load-path に加えます。
yuuji@271	169 たとえば、 @file{~/src/emacs/yatex}に置くのであれば、
yuuji@271	170
yuuji@271	171 @lisp
yuuji@271	172 (setq load-path (cons (expand-file-name "~/src/emacs/yatex") load-path))
yuuji@271	173 @end lisp
yuuji@271	174
yuuji@271	175 @noindent
yuuji@271	176 などとします。
yuuji@271	177
yuuji@271	178 以上の設定により、拡張子が .tex であるファイルを編集すると自動的に野鳥が
yuuji@271	179 ロードされます。野鳥が正常に起動できたときはモードラインの表示が「やてふ」
yuuji@271	180 に変わります。
yuuji@271	181
yuuji@271	182 @section タイプセッタ/プレヴューア環境の設定
yuuji@271	183
yuuji@271	184 利用する外部プログラムに関する以下の変数を確認し、必要なら正しい値に変更
yuuji@271	185 します。
yuuji@271	186 @table @code
yuuji@271	187 @item tex-command
yuuji@271	188 @dots{} 起動するタイプセッタのコマンド名
yuuji@271	189 @item dvi2-command
yuuji@271	190 @dots{} 起動するプレヴューアのコマンド名
yuuji@271	191 @item NTT-jTeX
yuuji@271	192 @dots{} 改行+インデントによって、タイプセット後の字間が空いてしま
yuuji@271	193 うのを抑制する場合にtにする(古いNTT-jTeXで顕著に現れる)。具体的には、
yuuji@271	194 fillするときに各行の終わりに%を付加するようになる。
yuuji@271	195 @item YaTeX-kanji-code
yuuji@271	196 @dots{} 文書を作成する時の漢字コード
yuuji@271	197 @item dviprint-command-format
yuuji@271	198 @dots{} ファイルの印刷に使われるコマンド列の書式
yuuji@329	199 @item YaTeX-dvipdf-command
yuuji@329	200 @dots{} DVIをPDFに変換するコマンド
yuuji@271	201 @end table
yuuji@271	202
yuuji@271	203 これらを変更する場合は、やはり@file{~/.emacs}にて、たとえば
yuuji@271	204 @lisp
yuuji@271	205 (setq tex-command "pdflatex")
yuuji@271	206 @end lisp
yuuji@271	207 のようにしてください。どのような値をセットすれば良いかについては、
yuuji@271	208 @ref{All customizable variables}を参照してください。
yuuji@271	209
yuuji@271	210
yuuji@271	211 @node Invocation, %#notation , Installation, Top
yuuji@271	212 @comment node-name, next, previous, up
yuuji@271	213 @chapter latexコマンド起動
yuuji@271	214 @cindex prefix key
yuuji@271	215 @cindex C-c
yuuji@271	216 @cindex タイプセッタ[たいふせつた]
yuuji@271	217 @cindex プレヴューア[ふれひゆうあ]
yuuji@271	218 @cindex jlatex
yuuji@271	219 @cindex platex
yuuji@271	220 @cindex プリントアウト[ふりんとあうと]
yuuji@271	221
yuuji@271	222 LaTeXソースの編集中、次のキー入力により、platex などのタイプセットプログラ
yuuji@271	223 ム(以後タイプセッタと呼ぶ)、プレヴューアなどの起動ができます。
yuuji@271	224
yuuji@271	225 @table @kbd
yuuji@271	226 @item [prefix] t j
yuuji@271	227 @dots{} タイプセッタ(platex)起動
yuuji@271	228 @item [prefix] t r
yuuji@271	229 @dots{} タイプセッタ起動(領域指定)
yuuji@271	230 @item [prefix] t e
yuuji@392	231 @dots{} 部分タイプセット&プレヴュー
yuuji@392	232 (ポイント位置の段落、環境または数式モードのみをタイプセットして
yuuji@392	233 隣のバッファに組版結果の画像を出す)
yuuji@271	234 @item [prefix] t k
yuuji@271	235 @dots{} 動作中のタイプセッタの停止
yuuji@271	236 @item [prefix] t b
yuuji@271	237 @dots{} jbibtex起動
yuuji@271	238 @item [prefix] t i
yuuji@271	239 @dots{} makeindex起動
yuuji@271	240 @item [prefix] t d
yuuji@271	241 @dots{} タイプセット完了後dvipdfmx起動
yuuji@271	242 @item [prefix] t p
yuuji@271	243 @dots{} プレヴューア起動
yuuji@271	244 @item [prefix] t l
yuuji@271	245 @dots{} lpr(プリントアウト用)コマンド起動
yuuji@271	246 @item [prefix] t s
yuuji@271	247 @dots{} xdvi -remote でのサーチ
yuuji@271	248 @end table
yuuji@271	249
yuuji@271	250 @menu
yuuji@271	251 * Calling typesetter:: タイプセッタ起動
yuuji@271	252 * Calling previewer:: プレヴューア起動
yuuji@271	253 * Print out:: プリントアウト用コマンドの起動
yuuji@271	254 @end menu
yuuji@271	255
yuuji@271	256 @node Calling typesetter, Calling previewer, Invocation, Invocation
yuuji@271	257 @comment node-name, next, previous, up
yuuji@271	258 @section タイプセッタ起動
yuuji@271	259 @cindex タイプセッタ起動[たいふせつたきとう]
yuuji@271	260 @cindex タイプセットエラー[たいふせつとえらあ]
yuuji@271	261 @cindex エラー修正[えらあしゆうせい]
yuuji@271	262
yuuji@271	263 タイプセッタを起動すると、編集ウィンドウが2つに分割され、片方のウィンド
yuuji@271	264 ウにタイプセット画面が表示されます。出力されるメッセージと連動しタイプセッ
yuuji@271	265 トバッファは自動的にスクロールします。もし、途中でエラーが起こって止まって
yuuji@271	266 しまった場合にはタイプセットバッファに移り、(@kbd{C-x o}) タイプセッタの出
yuuji@271	267 している ? プロンプトに対して、@kbd{x} (処理の中断)などの指示を送ることが
yuuji@271	268 できます。エラーを修正する場合は、
yuuji@271	269
yuuji@271	270 @table @kbd
yuuji@271	271 @item [prefix] '
yuuji@271	272 @itemx (prefix+アポストロフィ)
yuuji@271	273 @dots{} 直前のエラー発生行へジャンプ
yuuji@271	274 @end table
yuuji@271	275
yuuji@271	276 を入力することにより、タイプセッタがエラーを発生した行に移ることができます。
yuuji@271	277 また、タイプセッタの出力する overfull hbox などのウォーニング行にも対応し
yuuji@271	278 ていますので、順次 @kbd{[prefix] '} を押すことにより、一つ前のウォーニング
yuuji@271	279 発生行にジャンプしていきます。
yuuji@271	280
yuuji@271	281 もし、気になるエラー行があった場合は、タイプセットバッファで、エ
yuuji@271	282 ラーの表示されている行にカーソルを合わせスペースキーを押すと La@TeX{}
yuuji@271	283 ソースの対応する行にジャンプします。
yuuji@271	284
yuuji@271	285 @subsection 領域タイプセット
yuuji@271	286
yuuji@271	287 ポイントとマークの間、あるいはテキスト中に埋め込んだ @code{%#BEGIN} と
yuuji@271	288 @code{%#END}の間の領域(@ref{%#notation})だけを切り取ってタイプセットすることが
yuuji@271	289 できます。この場合メインファイルのプリアンブルが一時ファイルの
yuuji@271	290 プリアンブルとして使われます。したがってプリアンブルにないマクロ定義が
yuuji@271	291 領域内にあるとエラーになります。領域タイプセットを使う場合、
yuuji@271	292 必ずマクロ定義はプリアンブル(@code{\begin@{document@}}より前)に置くよう
yuuji@271	293 にして下さい。一時ファイルはメインファイルのある
yuuji@271	294 ディレクトリの@file{texput.tex}という名前で出力されるので、
yuuji@271	295 上書きには注意してください。
yuuji@271	296
yuuji@271	297 @subsection 環境タイプセット
yuuji@271	298
yuuji@271	299 @kbd{[prefix] te} を押すと、ポイント位置の最も内側の環境、または数式モー
yuuji@392	300 ド内の場合はその数式モード全体、あるいは環境がなければその段落が自動的に
yuuji@392	301 領域選択されて、領域タイプセットを呼び出します。
yuuji@392	302 tabular環境や数式モードで複雑なものを作っている場合は確かめたい部分だけを
yuuji@392	303 確認できるので便利です。Emacsが画像表示可能な場合は、
yuuji@392	304 部分タイプセットの結果を画像化して隣のウィンドウに表示します。また、
yuuji@392	305 特定の環境で呼び出した場合は、環境内の文字を書き換える度に自動的に
yuuji@392	306 プレビュー画像を更新します(on-the-flyプレヴュー)。
yuuji@392	307 自動表示されない場合はプレヴューアで @file{texput.dvi}
yuuji@392	308 を開いたままにしておけば修正と確認が素早くできるでしょう。
yuuji@392	309
yuuji@392	310 画像プレヴューの場合の大きさ(解像度)はデフォルトで200dpi(数式は300dpi)です。
yuuji@392	311 dpiを変えたい場合はLaTeXソースのどこかに
yuuji@392	312 @code{%#PREVIEWDPI 150}
yuuji@392	313 のようにdpi値を書いてください。
yuuji@271	314
yuuji@271	315 @node Calling previewer, Print out, Calling typesetter, Invocation
yuuji@271	316 @comment node-name, next, previous, up
yuuji@271	317 @section プレヴューア起動
yuuji@271	318 @kbd{[prefix] t p} によりプレヴューアの起動ができます。さらに、もしあな
yuuji@271	319 たが、-remote 機能つきのxdviを利用している場合は @kbd{[prefix] t s} を押す
yuuji@271	320 ことによりカーソル位置の文字列を検索してそのページを表示するようにすでに起
yuuji@271	321 動中のxdviに命令を送ります。これにより、現在編集中の箇所のタイプセット結果
yuuji@271	322 を即座に見ることができます。
yuuji@271	323
yuuji@271	324 @c なお、-remote 機能付きの xdvi は
yuuji@271	325 @c @code{ftp://ftp.ae.keio.ac.jp/pub/text/xdvi/xdvi-remote}
yuuji@271	326 @c などから入手することができます。
yuuji@271	327
yuuji@271	328 @node Print out, , Calling previewer, Invocation
yuuji@271	329 @comment node-name, next, previous, up
yuuji@271	330 @section プリントアウト
yuuji@271	331
yuuji@271	332 @kbd{[prefix] t l}を押してプリントアウトを指示すると、出力開始/終了ペー
yuuji@271	333 ジを聞いてくるので、それぞれに答えます。これを省略したい時は、
yuuji@271	334 universal-argument をつけ、
yuuji@271	335
yuuji@271	336 @cindex 出力開始ページ[しゆつりよくかいしへえし]
yuuji@271	337 @cindex 出力終了ページ[しゆつりよくしゆうりようへえし]
yuuji@271	338
yuuji@271	339 @table @kbd
yuuji@271	340 @item C-u [prefix] t l
yuuji@271	341 @dots{} ページ確認省略lpr起動
yuuji@271	342 @end table
yuuji@271	343 @cindex ページ確認省略lpr起動[へえしかくにんしようりやくlprきとう]
yuuji@271	344
yuuji@271	345 @noindent
yuuji@271	346 のように起動してください。
yuuji@271	347
yuuji@271	348 @node %#notation , Completion, Invocation, Top
yuuji@271	349 @comment node-name, next, previous, up
yuuji@271	350 @chapter %#記法
yuuji@271	351
yuuji@271	352 本文中に@code{%#}ではじまるキーワードを埋め込むことでタイプセッタ起動等
yuuji@271	353 の制御をすることができます。
yuuji@271	354
yuuji@271	355 @menu
yuuji@271	356 * Changing typesetter:: タイプセット用コマンドの変更
yuuji@271	357 * Splitting input files:: 入力ファイル分割
yuuji@271	358 * Fix region for typesetting:: 領域の固定
yuuji@271	359 * lpr format:: プリントアウトコマンド用フォーマット
yuuji@271	360 * Controlling which command to invoke:: その他の起動コマンド制御
yuuji@271	361 * Editing %# notation:: %#記法の編集
yuuji@271	362 @end menu
yuuji@271	363
yuuji@271	364 @node Changing typesetter, Splitting input files, %#notation , %#notation
yuuji@271	365 @comment node-name, next, previous, up
yuuji@271	366 @section タイプセット用コマンド変更
yuuji@271	367
yuuji@271	368 起動するコマンドを変えたい時は本文中に次のような行を書きます。
yuuji@271	369
yuuji@271	370 @cindex 起動するコマンドを変える[きとうするこまんとをかえる]
yuuji@271	371
yuuji@271	372 @example
yuuji@271	373 %#!jlatex-ntt
yuuji@271	374 @end example
yuuji@271	375
yuuji@271	376 NTT jTeX と、ASCII jTeX を使い分けたいような場合に便利でしょう。
yuuji@271	377
yuuji@271	378 @cindex タイプセッタの使い分け[たいふせつたのつかいわけ]
yuuji@271	379
yuuji@271	380 @node Splitting input files, Fix region for typesetting, Changing typesetter, %#notation
yuuji@271	381 @comment node-name, next, previous, up
yuuji@271	382 @section 入力ファイル分割
yuuji@271	383
yuuji@271	384 また、章毎に別ファイルの .tex を作成している場合で、@file{main.tex}から
yuuji@271	385 @file{sub.tex} を @code{\include}しているような時は、@file{sub.tex}の任意の
yuuji@271	386 位置に次のような行を埋め込みます。
yuuji@271	387
yuuji@271	388 @example
yuuji@271	389 %#!platex main.tex
yuuji@271	390 @end example
yuuji@271	391
yuuji@271	392 @cindex 入力ファイル分割[にゆうりよくふあいるふんかつ]
yuuji@271	393
yuuji@271	394 上の例のようにコマンド名だけでなく引数も書いた場合には、全てをそのまま
yuuji@271	395 shell に渡すので次のように書けば、ghostview などをプレヴューアに使う時に便
yuuji@271	396 利です。
yuuji@271	397
yuuji@271	398 @cindex ghostview
yuuji@271	399
yuuji@271	400 @example
yuuji@271	401 %#!platex main && dvi2ps main.dvi > main
yuuji@271	402 @end example
yuuji@271	403
yuuji@271	404 なお、この行の最後の単語のピリオド以前を「メインファイル」のベース
yuuji@271	405 ネームであると仮定します(上の2つの場合どちらも@file{main})。
yuuji@271	406 この行に記述した、@code{%f}はメインファイル名に、
yuuji@271	407 @code{%r} はメインファイルの拡張子を取り除いた部分に置換されます。
yuuji@271	408 ただし、@code{%f,%r}を利用した場合、初回タイプセット時に必ずメインファイル
yuuji@271	409 名の入力を促されます。
yuuji@271	410
yuuji@271	411 @kbd{[prefix] g} (@ref{Cursor jump}参照) での
yuuji@271	412 ファイル間ジャンプを有効に機能させるため、入力ファイル分割時には次のことに
yuuji@271	413 注意して下さい。
yuuji@271	414
yuuji@271	415 @enumerate
yuuji@271	416 @item
yuuji@271	417 サブディレクトリを作って、その中にサブファイルを置くことはできるが
yuuji@271	418 サブディレクトリのサブディレクトリには置けない。
yuuji@271	419 @item
yuuji@271	420 メインファイルからサブディレクトリ内のファイルを include する時には、
yuuji@271	421 相対パス指定を用いて、
yuuji@271	422 @code{\include@{chap1/sub@}}のように記述。
yuuji@271	423 @item
yuuji@271	424 メインファイルが一つ上のディレクトリにある場合も、サブファイルには
yuuji@271	425 %#!platex main.tex のように記述する(../mainではない)。
yuuji@271	426 @end enumerate
yuuji@271	427
yuuji@271	428
yuuji@271	429
yuuji@271	430 @node Fix region for typesetting, lpr format, Splitting input files, %#notation
yuuji@271	431 @comment node-name, next, previous, up
yuuji@271	432 @section 領域の固定
yuuji@271	433 @cindex 固定領域のタイプセット[こていりよういきのたいふせつと]
yuuji@271	434 @cindex %#BEGIN
yuuji@271	435 @cindex %#END
yuuji@271	436
yuuji@271	437 @kbd{[prefix] tr} の領域指定のタイプセットでは、とくに指定のないかぎり、
yuuji@271	438 @kbd{C-SPC}でマークした位置と、ポイント(カーソル位置)の間を領域とみなしま
yuuji@271	439 すが、必ず決まった領域をタイプセットしたい場合は、その領域を
yuuji@271	440
yuuji@271	441 @example
yuuji@271	442 %#BEGIN
yuuji@271	443 <渡したい領域>
yuuji@271	444 %#END
yuuji@271	445 @end example
yuuji@271	446
yuuji@271	447 @noindent
yuuji@271	448 のように@code{%#BEGIN}と@code{%#END}で囲み、カーソルを「@code{%#BEGIN}以降」
yuuji@271	449 に置いてください。この時の領域決定規則をまとめると次のようになります。
yuuji@271	450
yuuji@271	451
yuuji@271	452 @enumerate
yuuji@271	453 @item
yuuji@271	454 カーソル位置よりバッファの先頭方向に@code{%#BEGIN}というキーワードが
yuuji@271	455 ある場合
yuuji@271	456
yuuji@271	457 @enumerate
yuuji@271	458 @item
yuuji@271	459 @code{%#BEGIN}よりバッファの末尾方向に@code{%#END}というキーワードが見つかっ
yuuji@271	460 た場合。
yuuji@271	461 @result{}@code{%#BEGIN} から、その @code{%#END} のある位置まで。
yuuji@271	462 @item
yuuji@271	463 @code{%#END} が見つからなかった場合。
yuuji@271	464 @result{}バッファの最後尾まで。
yuuji@271	465 @end enumerate
yuuji@271	466 @cindex 領域決定規則[りよういきけつていきそく]
yuuji@271	467
yuuji@271	468 @item
yuuji@271	469 カーソル位置よりバッファの先頭方向に @code{%#BEGIN} というキーワードが
yuuji@271	470 見つからなかった場合。
yuuji@271	471 @result{}マーク(@kbd{C-SPC}位置)とポイント(カーソル位置)の間の領域。
yuuji@271	472 @end enumerate
yuuji@271	473
yuuji@271	474 tabular 環境を何度も試行錯誤しているような場合は、@code{\begin}の前の行
yuuji@271	475 に @code{%#BEGIN} と書き、@code{\end} の次の行に @code{%#END} と書いておく
yuuji@271	476 と簡単に作表結果をテストすることができます。また、長い .tex ファイルの後半
yuuji@271	477 に @code{%#BEGIN} を書いておけば、前半の部分は無視できます。このBEGINとEND
yuuji@271	478 の消し忘れには十分ご注意下さい。
yuuji@271	479 @cindex 長いファイルの編集[なかいふあいるのへんしゆう]
yuuji@271	480
yuuji@271	481 @c @node Require, lpr format, Fix region for typesetting, %#notation
yuuji@271	482 @comment node-name, next, previous, up
yuuji@271	483
yuuji@271	484 @node lpr format, Controlling which command to invoke, Fix region for typesetting, %#notation
yuuji@271	485 @comment node-name, next, previous, up
yuuji@271	486 @section lprフォーマット
yuuji@271	487 @cindex lprふぉーまっと[lprふおおまつと]
yuuji@271	488 @cindex lprフォーマット[lprふおおまつと]
yuuji@271	489 @cindex lpr format
yuuji@271	490
yuuji@271	491 まず、プリントアウト用コマンド列のフォーマットについて説明します。
yuuji@271	492 コマンド列フォーマットは、3つの Lisp 変数によって表現されます。デ
yuuji@271	493 フォルトの dvi2ps 用のフォーマットを例に説明します。
yuuji@271	494
yuuji@271	495 @table @code
yuuji@271	496 @item (1)dviprint-command-format
yuuji@271	497 @code{"dvi2ps %f %t %s \| lpr"}
yuuji@271	498
yuuji@271	499 @item (2)dviprint-from-format
yuuji@271	500 @code{"-f %b"}
yuuji@271	501
yuuji@271	502 @item (3)dviprint-to-format
yuuji@271	503 @code{"-t %e"}
yuuji@271	504 @end table
yuuji@271	505
yuuji@271	506 実際にプリントアウトする時は、(1)中の %s がファイル名に置き換えられ、%f が
yuuji@271	507 (2)の内容、%t が(3)の内容に置き換えられます。その際に(2)の文字列中の %b は
yuuji@271	508 「出力開始ページ」、(3)の文字列中の %e は「出力終了ページ」に置き換えられ
yuuji@271	509 ます。もし、ページを指定しない時には、%f, %t 両方とも無視されます。
yuuji@271	510
yuuji@271	511 この、dviprint-command-format を臨時に変えたい時は、La@TeX{} の
yuuji@271	512 ソーステキスト中の任意の場所に、
yuuji@271	513
yuuji@271	514 @example
yuuji@271	515 %#LPR dvi2ps %f %t %s \| 4up -page 4 \| texfix \| lpr -Plp2
yuuji@271	516 @end example
yuuji@271	517
yuuji@271	518 @noindent
yuuji@271	519 のように書いて下さい。プリントアウトするページ範囲をいちいち聞かせないよう
yuuji@271	520 にする時に
yuuji@271	521
yuuji@271	522 @example
yuuji@271	523 %#LPR dvi2ps %s \| lpr
yuuji@271	524 @end example
yuuji@271	525
yuuji@271	526 @noindent
yuuji@271	527 などとするのも便利かもしれません。
yuuji@271	528
yuuji@271	529 @node Controlling which command to invoke, Editing %# notation, lpr format, %#notation
yuuji@271	530 @comment node-name, next, previous, up
yuuji@271	531 @section その他の起動コマンド制御
yuuji@271	532 @cindex その他のコマンド制御[そのたのこまんとせいきよ]
yuuji@271	533
yuuji@271	534 La@TeX{} 文書に関連するコマンドは以下の %# 記法で指定することができます。
yuuji@271	535
yuuji@271	536 @table @code
yuuji@271	537 @item %#BIBTEX
yuuji@271	538 @dots{} makeindexを行なうコマンドライン([prefix] t b)
yuuji@271	539 @item %#MAKEINDEX
yuuji@271	540 @dots{} bibtexを行なうコマンドライン([prefix] t i)
yuuji@329	541 @item %#DVIPDF
yuuji@329	542 @dots{} DVIからPDF変換を行なうコマンドライン([prefix] t d)
yuuji@271	543 @end table
yuuji@271	544
yuuji@271	545 行頭がこれらのキーワードで始まる行をLa@TeX{}文書の先頭付近に書いておけば、
yuuji@271	546 それで指定したコマンドを起動できます。
yuuji@271	547
yuuji@271	548 @node Editing %# notation, , Controlling which command to invoke, %#notation
yuuji@271	549 @comment node-name, next, previous, up
yuuji@271	550 @section %#記法自体の編集
yuuji@271	551 @cindex %#記法自体の編集[%#きほうしたいのへんしゆう]
yuuji@271	552
yuuji@271	553 以上のような@code{%#}で始まる各種制御記法を編集するためには
yuuji@271	554
yuuji@271	555 @table @kbd
yuuji@271	556 @item [prefix] %
yuuji@271	557 @dots{} @code{%#}@var{記法編集メニュー}
yuuji@271	558 @end table
yuuji@271	559
yuuji@271	560 @noindent
yuuji@271	561 を押します。
yuuji@271	562
yuuji@271	563 @example
yuuji@271	564 !)Edit-%#! B)EGIN-END-region L)Edit-%#LPR
yuuji@271	565 @end example
yuuji@271	566
yuuji@271	567 @noindent
yuuji@271	568 というメニューが出て来るので、@code{%#!}に続くコマンドを変更したい時には
yuuji@271	569 @kbd{!}を、@code{%#LPR}で lpr フォーマットを変えたい時は@kbd{l}を、あらか
yuuji@271	570 じめ設定したリジョンを @code{%#BEGIN} ～ @code{%#END} で括りたい時は、
yuuji@271	571 @kbd{b}を押します。@kbd{b}を選んだ時には、それまでバッファ中に置かれていた
yuuji@271	572 @code{%#BEGIN}, @code{%#END} が自動的に消去されます。
yuuji@271	573 @cindex lprフォーマットの変更[lprふおおまつとのへんこう]
yuuji@271	574
yuuji@271	575 @node Completion, Local dictionary, %#notation , Top
yuuji@271	576 @comment node-name, next, previous, up
yuuji@271	577 @chapter 補完入力
yuuji@271	578
yuuji@271	579 La@TeX{} での環境名などは、野鳥の補完機能を利用して能率的に入力すること
yuuji@271	580 ができます。
yuuji@271	581
yuuji@271	582 @menu
yuuji@392	583 * begin型補完::
yuuji@392	584 * section型補完::
yuuji@392	585 * large型補完::
yuuji@392	586 * maketitle型補完::
yuuji@271	587 * Arbitrary completion:: 随時補完
yuuji@392	588 * end補完::
yuuji@271	589 * Accent mark completion:: アクセント記号補完
yuuji@271	590 * Image completion:: 数式記号イメージ補完
yuuji@271	591 * Greek letter completion:: ギリシャ文字補完
yuuji@392	592 * Inserting parens::
yuuji@271	593 @end menu
yuuji@271	594
yuuji@271	595 @node begin型補完, section型補完, Completion, Completion
yuuji@271	596 @comment node-name, next, previous, up
yuuji@271	597 @section begin型補完
yuuji@271	598 @cindex begin型補完[beginかたほかん]
yuuji@271	599 @cindex 環境名の補完[かんきようめいのほかん]
yuuji@271	600 @cindex prefix b
yuuji@271	601
yuuji@271	602 @code{\begin@{env@}...\end@{env@}}の様な形式の入力の補完をbegin型補完と
yuuji@271	603 呼ぶことにします。begin 型補完は、
yuuji@271	604
yuuji@271	605 @table @kbd
yuuji@271	606 @item [prefix] b
yuuji@271	607 @dots{} begin 型補完開始(標準では @kbd{C-c b})
yuuji@271	608 @end table
yuuji@271	609
yuuji@271	610 @noindent
yuuji@271	611 で始まります。頻繁に用いられる次の La@TeX{} 環境の補完は、[prefix] @kbd{b}
yuuji@271	612 に続く次の1文字を入力するだけで、@code{\begin@{xxx@}...\end@{xxx@}}を完成
yuuji@271	613 させます。
yuuji@271	614
yuuji@271	615 @table @kbd
yuuji@271	616 @item [prefix] b c
yuuji@271	617 @dots{} @code{\begin@{center@}...\end@{center@}}
yuuji@271	618 @item [prefix] b d
yuuji@271	619 @dots{} @code{\begin@{document@}...\end@{document@}}
yuuji@271	620 @item [prefix] b D
yuuji@271	621 @dots{} @code{\begin@{description@}...\end@{description@}}
yuuji@271	622 @item [prefix] b e
yuuji@271	623 @dots{} @code{\begin@{enumerate@}...\end@{enumerate@}}
yuuji@271	624 @item [prefix] b E
yuuji@271	625 @dots{} @code{\begin@{equation@}...\end@{equation@}}
yuuji@271	626 @item [prefix] b i
yuuji@271	627 @dots{} @code{\begin@{itemize@}...\end@{itemize@}}
yuuji@271	628 @item [prefix] b l
yuuji@271	629 @dots{} @code{\begin@{flushleft@}...\end@{flushleft@}}
yuuji@271	630 @item [prefix] b m
yuuji@271	631 @dots{} @code{\begin@{minipage@}...\end@{minipage@}}
yuuji@271	632 @item [prefix] b t
yuuji@271	633 @dots{} @code{\begin@{tabbing@}...\end@{tabbing@}}
yuuji@271	634 @item [prefix] b T
yuuji@271	635 @dots{} @code{\begin@{tabular@}...\end@{tabular@}}
yuuji@271	636 @item [prefix] b ^T
yuuji@271	637 @dots{} @code{\begin@{table@}...\end@{table@}}
yuuji@271	638 @item [prefix] b p
yuuji@271	639 @dots{} @code{\begin@{picture@}...\end@{picture@}}
yuuji@271	640 @item [prefix] b q
yuuji@271	641 @dots{} @code{\begin@{quote@}...\end@{quote@}}
yuuji@271	642 @item [prefix] b Q
yuuji@271	643 @dots{} @code{\begin@{quotation@}...\end@{quotation@}}
yuuji@271	644 @item [prefix] b r
yuuji@271	645 @dots{} @code{\begin@{flushright@}...\end@{flushright@}}
yuuji@271	646 @item [prefix] b v
yuuji@271	647 @dots{} @code{\begin@{verbatim@}...\end@{verbatim@}}
yuuji@271	648 @item [prefix] b V
yuuji@271	649 @dots{} @code{\begin@{verse@}...\end@{verse@}}
yuuji@271	650 @end table
yuuji@271	651
yuuji@271	652 上記のもの以外の環境名は Emacs の持つインクリメンタルな補完機能を用いて
yuuji@271	653 入力します(上記の環境名も以下の補完入力可能)。
yuuji@271	654
yuuji@271	655 @table @kbd
yuuji@271	656 @item [prefix] b @key{SPC}
yuuji@271	657 @dots{} begin 型補完入力
yuuji@271	658 @end table
yuuji@271	659
yuuji@271	660 @kbd{[prefix] b @key{SPC}} と入力すると、最下行のミニバッファに
yuuji@271	661
yuuji@271	662 @example
yuuji@271	663 Begin environment(default document):
yuuji@271	664 @end example
yuuji@271	665
yuuji@271	666 @noindent
yuuji@271	667 と表示されます。ここで、何も入れずにリターンキーのみ押すと、括弧内に出てい
yuuji@271	668 るデフォルトの環境名が入力されますが、適当な環境名を入力すると、
yuuji@271	669 @code{\begin@{環境名@} … \end@{環境名@}}が文書中に挿入されます。ミニバッ
yuuji@271	670 ファで環境名を入力するときに、環境名の頭文字を入力し「スペース」をたたくと、
yuuji@271	671 一致する環境名が内部テーブルに存在した場合、正しい環境名に補完されるので、
yuuji@271	672 入力の手間が省けます。内部テーブルに存在しない環境名を入力した時はユーザ専
yuuji@271	673 用のテーブルに登録され、さらにそのテーブルを自動的に、ユーザ辞書(デフォル
yuuji@271	674 トでは @file{~/.yatexrc})に保存します。
yuuji@271	675
yuuji@271	676 さらに、特定の環境を補完入力した時にはその環境で必ず用いられるエントリを自
yuuji@271	677 動挿入します(例: @code{itemize}環境における@code{\item}など)。挿入されたエ
yuuji@271	678 ントリが不要な場合にはundoによって消去して下さい。
yuuji@271	679 @cindex ユーザ辞書[ゆうさししよ]
yuuji@271	680
yuuji@271	681 @subsection 既に書いたテキストを環境で括る
yuuji@271	682
yuuji@271	683 ところで、最初に書いてしまったブロックを後から、itemize 環境の中
yuuji@271	684 に閉じこめたいと思うことがありますが、そのようなときは、あらかじめ
yuuji@271	685 閉じこめたい段落をマークして、begin 型補完の各コマンドの @kbd{[prefix]}
yuuji@271	686 の次の『小文字の 'b'』を『大文字』に変えて起動して下さい。(または、
yuuji@271	687 @kbd{C-u} を先に打ち、universal argument をつけても可能です)
yuuji@271	688 @cindex ブロック[ふろつく]
yuuji@271	689 @cindex 閉じ込める[としこめる]
yuuji@271	690
yuuji@271	691 例えばあるパラグラフを description 環境の中に入れたいときは、
yuuji@392	692 そのパラグラフをマークしてから、補完機能を呼び出してください(description
yuuji@392	693 環境の場合は @kbd{[prefix] b D})。
yuuji@392	694
yuuji@392	695 選択された領域を括ります。ただしこれは @code{transient-mark-mode} が t
yuuji@392	696 (Emacsの標準)になっている場合のみで、普段
yuuji@392	697 @code{transient-mark-mode} を @code{nil} にしている場合は、
yuuji@392	698 補完キー前に @code{universal-argument} 指定(@kbd{C-u})
yuuji@392	699 をタイプしてから @kbd{[prefix] b D} など、補完キーを
yuuji@392	700 タイプすれば括り補完になります。
yuuji@392	701 なおEmacs22以降であれば @code{transient-mark-mode} 無効時も
yuuji@392	702 @code{set-mark-command} (@kbd{C-space})の連打で一時的に
yuuji@392	703 @code{transient-mark-mode} が有効になります。
yuuji@392	704
yuuji@271	705
yuuji@271	706 @node section型補完, large型補完, begin型補完, Completion
yuuji@271	707 @comment node-name, next, previous, up
yuuji@271	708 @section section型補完
yuuji@271	709 @cindex section型補完[sectionかたほかん]
yuuji@271	710 @cindex prefix s
yuuji@271	711
yuuji@271	712 @code{\section@{目的@}} のような形式の入力の補完を section 型補完と呼ぶこ
yuuji@271	713 とにします。section 型補完は、
yuuji@271	714
yuuji@271	715 @table @kbd
yuuji@271	716 @item [prefix] s
yuuji@271	717 @dots{} section 型補完
yuuji@271	718 @end table
yuuji@271	719
yuuji@271	720
yuuji@271	721 で実行します。@kbd{[prefix] s} を入力するとミニバッファに、
yuuji@271	722
yuuji@271	723 @example
yuuji@271	724 (C-v for view-section) \???@{@} (default documentclass):
yuuji@271	725 @end example
yuuji@271	726
yuuji@271	727 @noindent
yuuji@271	728 というプロンプトが現れるので、そこで @samp{section} のような La@TeX{} コマ
yuuji@271	729 ンド名を入力します。ここでもリターンキーのみで括弧内のデフォルト値が選択さ
yuuji@271	730 れるほか、@samp{chapter}などのような頻度の高い名称入力にはスペースキーによ
yuuji@271	731 る補完機能が有効です。次に、@{@}の中身の入力を促す、
yuuji@271	732
yuuji@271	733 @example
yuuji@271	734 \section@{???@}:
yuuji@271	735 @end example
yuuji@271	736
yuuji@271	737 @noindent
yuuji@271	738 というプロンプトが現れるので、セクションのタイトルなどを入力します。
yuuji@271	739 たとえば、
yuuji@271	740
yuuji@271	741 @example
yuuji@271	742 (C-v for view-section) \???@{@} (default documentclass): section
yuuji@271	743 \section@{???@}: 目的
yuuji@271	744 @end example
yuuji@271	745
yuuji@271	746 @noindent
yuuji@271	747 のように入力した場合は、文章中に
yuuji@271	748
yuuji@271	749 @example
yuuji@271	750 \section@{目的@}
yuuji@271	751 @end example
yuuji@271	752
yuuji@271	753 @noindent
yuuji@271	754 が挿入され、
yuuji@271	755
yuuji@271	756 @example
yuuji@271	757 (C-v for view-section) \???@{@} (default section): vspace*
yuuji@271	758 \vspace*@{???@}:
yuuji@271	759 @end example
yuuji@271	760
yuuji@271	761 @noindent
yuuji@271	762 のように@{@}の中身を省略したときは、
yuuji@271	763
yuuji@271	764 @example
yuuji@271	765 \vspace*@{@}
yuuji@271	766 @end example
yuuji@271	767
yuuji@271	768 @noindent
yuuji@271	769 だけが挿入され、改行はせずカーソルは自動的に中括弧の内側に移動します。
yuuji@271	770
yuuji@271	771 @menu
yuuji@271	772 * 2個以上の引数をとる section型コマンド::
yuuji@271	773 * Enclose section-type command:: 括り補完
yuuji@271	774 * Recursive completion:: 再帰補完
yuuji@271	775 * view-sectioning:: セクション区切りのアウトライン表示
yuuji@271	776 * label-generation:: ラベル自動生成
yuuji@271	777 @end menu
yuuji@271	778
yuuji@271	779 @node 2個以上の引数をとる section型コマンド, Enclose section-type command, section型補完, section型補完
yuuji@271	780 @comment node-name, next, previous, up
yuuji@271	781 @subsection 2個以上の引数をとる section型コマンド
yuuji@271	782 @cindex 引数[ひきすう]
yuuji@271	783
yuuji@271	784 ところで、@samp{\addtolength@{\topmargin@}@{8mm@}} などのように、引数を二つ
yuuji@271	785 以上取る La@TeX{} コマンドがあります。このようなコマンドの補完入力には、
yuuji@271	786 section 型補完呼び出しに引数を付けてください。例えば上の@samp{addtolength}
yuuji@271	787 の例であれば、引数2を指定します。つまり、
yuuji@271	788
yuuji@271	789 @example
yuuji@271	790 C-u 2 [prefix] s (または、ESC 2 [prefix] s)
yuuji@271	791 @end example
yuuji@271	792
yuuji@271	793 @noindent
yuuji@271	794 と section 型補完を呼び出した後、
yuuji@271	795
yuuji@271	796 @example
yuuji@271	797 (Ctrl-v for view-section) \???@{@} (default vspace*): addtolength
yuuji@271	798 \addtolength@{???@}: \topmargin
yuuji@271	799 Argument 2: 8mm
yuuji@271	800 @end example
yuuji@271	801
yuuji@271	802 @noindent
yuuji@271	803 のように入力してください。最初の addtolength の部分と、第一引数である
yuuji@271	804 \topmargin の入力は当然スペースによる補完入力が可能です。ユーザ辞書に登録
yuuji@271	805 される La@TeX{} コマンドには、この引数の数も学習されるので、最初の補完の時
yuuji@271	806 引数の数を指定して起動しておけば、以後の補完時には、記憶された個数だけ引数
yuuji@271	807 を聞いて来るようになります。あとで引数の個数を変えたい時は、再び @kbd{C-u}
yuuji@271	808 を用いて個数を指定し直すことで、自動的に辞書中の引数の個数の部分を更新しま
yuuji@271	809 す。
yuuji@271	810 @cindex 引数の個数を変える[ひきすうのこすうをかえる]
yuuji@271	811
yuuji@271	812
yuuji@271	813 @node Enclose section-type command, Recursive completion, 2個以上の引数をとる section型コマンド, section型補完
yuuji@271	814 @subsection 既に書いたテキストを括る
yuuji@271	815 @cindex 括る[くくる]
yuuji@271	816
yuuji@392	817 また、section型補完機能の呼び出し時に領域選択状態にしておくと
yuuji@392	818 領域内のテキストを section 型コマンドの第一引数として括ります。
yuuji@392	819 これも普段 @code{transient-mark-mode} を @code{nil} にしている場合は
yuuji@392	820 @kbd{C-u} のあとに補完キーをタイプすれば強制的に括り補完になります。
yuuji@392	821
yuuji@271	822
yuuji@271	823 @node Recursive completion, view-sectioning, Enclose section-type command, section型補完
yuuji@271	824 @comment node-name, next, previous, up
yuuji@271	825 @subsection 再帰補完
yuuji@271	826 @cindex 再帰補完[さいきほかん]
yuuji@271	827
yuuji@271	828 高度な使い方になるかもしれませんが、section型補完の引数の入力時にさらに
yuuji@271	829 補完入力を利用することができます(section/large/maketitle型に限る)。section
yuuji@271	830 型コマンドの引数に更に La@TeX{} コマンドが来る場合にはミニバッファで野鳥の
yuuji@271	831 補完キーを再帰的に入力することで引数の入力も効率的に行なえます。
yuuji@271	832
yuuji@271	833 @node view-sectioning, label-generation, Recursive completion, section型補完
yuuji@271	834 @comment node-name, next, previous, up
yuuji@271	835 @subsection セクション区切りのアウトライン表示
yuuji@271	836 @cindex アウトライン[あうとらいん]
yuuji@271	837
yuuji@271	838 通常のsection型補完の時にミニバッファで@kbd{C-v}を押すと現在存在するセク
yuuji@271	839 ション区切りコマンド全てを @code{Sectioning Lines}というバッファに一覧表
yuuji@271	840 示します(「<<--」のついている行がもっとも近いセクション区切り)。この時ミニ
yuuji@271	841 バッファで@kbd{C-p}, @kbd{C-n} を押すと@samp{part}, @samp{chapter}, ...,
yuuji@271	842 @samp{subparagraph} のコマンドが論理階層の高さにしたがって上下します。また、
yuuji@271	843 @kbd{C-v}, @kbd{M-v} を押すとセクション区切り一覧バッファがスクロールし、
yuuji@271	844 数字の@kbd{0}～@kbd{7}を押すとある高さ以上のセクション区切りだけを選んで表
yuuji@271	845 示します(実際にやって見れば分かります)。
yuuji@271	846
yuuji@271	847 @code{Sectioning Lines}バッファは、
yuuji@271	848
yuuji@271	849 @table @kbd
yuuji@271	850 @item M-x YaTeX-section-overview
yuuji@271	851 @dots{} セクション区切り一覧バッファを生成
yuuji@271	852 @end table
yuuji@271	853
yuuji@271	854 @cindex セクション区切り一覧バッファ[せくしよんくきりいちらんはつふあ]
yuuji@271	855 で作成することができます。このバッファを選択し任意の行でスペースを押すと、
yuuji@271	856 該当するセクション区切りのある本文中の場所にジャンプします。さらに、同バッ
yuuji@271	857 ファで @kbd{u} を押すと、ソーステキストの対応するセクションコマンドが一階
yuuji@271	858 層上がり(例: subsection が section に変わる)、@kbd{d}を押すと一階層下がり
yuuji@271	859 ます。@code{Sectioning Lines}バッファにあるセクション区切りの行をマーク
yuuji@271	860 しておいて@kbd{U}を押すとリジョン内のものに対応するソーステキストのセクショ
yuuji@271	861 ンコマンドすべてが一階層上がり、@kbd{D}を押すと下がります。セクション区切
yuuji@271	862 り一覧バッファで利用できるキーコマンドには以下のものがあります。
yuuji@271	863
yuuji@271	864 @table @kbd
yuuji@271	865 @item SPC
yuuji@271	866 @dots{} 対応するソース行へジャンプ
yuuji@271	867 @item .
yuuji@271	868 @dots{} 対応するソース行を表示
yuuji@271	869 @item u
yuuji@271	870 @dots{} カーソル位置に対応するセクションコマンドを一階層上げる
yuuji@271	871 @item d
yuuji@271	872 @dots{} カーソル位置に対応するセクションコマンドを一階層下げる
yuuji@271	873 @item U
yuuji@271	874 @dots{} マークしたセクションコマンドを一階層上げる
yuuji@271	875 @item D
yuuji@271	876 @dots{} マークしたセクションコマンドを一階層上げる
yuuji@271	877 @item 0～6
yuuji@271	878 @dots{} レベル n 以下のセクションコマンドを隠して表示
yuuji@271	879 @end table
yuuji@271	880
yuuji@271	881 @cindex 論理階層[ろんりかいそう]
yuuji@271	882 @cindex セクション区切り[せくしよんくきり]
yuuji@271	883 @cindex ジャンプ[しやんふ]
yuuji@271	884
yuuji@271	885 @node label-generation, , view-sectioning, section型補完
yuuji@271	886 @comment node-name, next, previous, up
yuuji@271	887 @subsection ラベル自動生成
yuuji@271	888 @cindex ラベル自動生成[らへるしとうせいせい]
yuuji@271	889
yuuji@271	890 @code{\ref@{@}} や @code{\cite@{@}} マクロをsection型補完で入れた場合
yuuji@271	891 参照先となり得るものを全て探してメニューにして選択できます。参照先には
yuuji@271	892 @code{\label@{@}}をつけておく必要はありません。もしあれば、そのラベルを
yuuji@271	893 使い、なければその場で参照先に@code{\label@{@}}を作らせてくれます。
yuuji@271	894 ラベル名を考えるのは苦痛に感じるものです。全てのカウンタにラベルを
yuuji@271	895 つけるのもたいへんです。もうラベル名に何をつけるか、ラベルをつけるかつけま
yuuji@271	896 いか、などということは忘れましょう!
yuuji@271	897
yuuji@271	898 @node large型補完, maketitle型補完, section型補完, Completion
yuuji@271	899 @comment node-name, next, previous, up
yuuji@271	900 @section large型補完
yuuji@271	901 @cindex large型補完[largeかたほかん]
yuuji@271	902 @cindex prefix l
yuuji@271	903
yuuji@271	904 @code{@{\large @}} のような形式の補完を large 型補完と呼ぶことにします。
yuuji@271	905
yuuji@271	906 @table @kbd
yuuji@271	907 @item [prefix] l
yuuji@271	908 @dots{} large 型補完開始
yuuji@271	909 @end table
yuuji@271	910
yuuji@271	911 @noindent
yuuji@271	912 がlarge型補完の開始です。@kbd{[prefix] l} を押すと、ミニバッファに
yuuji@271	913
yuuji@271	914 @example
yuuji@271	915 @{\??? @} (default large):
yuuji@271	916 @end example
yuuji@271	917
yuuji@271	918
yuuji@271	919 と表示されるので、上記のものと同じ要領で補完入力して下さい。補完候補に用意
yuuji@271	920 されているのは、@samp{footnotesize} や @samp{huge} のような文字サイズ指定
yuuji@271	921 子と、@samp{bf}や@samp{dg}のようなフォント指定子です。
yuuji@271	922 @cindex 文字サイズ指定子[もしさいすしていし]
yuuji@271	923 @cindex フォント指定子[ふおんとしていし]
yuuji@271	924
yuuji@271	925 @subsection 既に書いた文字を括る
yuuji@271	926 @cindex 括る[くくる]
yuuji@271	927
yuuji@271	928 また、begin型補完の時と同様、先に書いてしまった一連の文章の文字のサイズ
yuuji@271	929 を変えたいと思う時がありますが、そのような時は、サイズや大きさを変えたい文
yuuji@392	930 字の範囲をマークしてからlarge型補完を呼んでください。
yuuji@271	931
yuuji@271	932 @node maketitle型補完, Arbitrary completion, large型補完, Completion
yuuji@271	933 @comment node-name, next, previous, up
yuuji@271	934 @section maketitle型補完
yuuji@271	935 @cindex maketitle型補完[maketitleかたほかん]
yuuji@271	936 @cindex prefix m
yuuji@271	937
yuuji@271	938 @code{\maketitle} の形式の補完を maketitle 型補完と呼ぶことにします。
yuuji@271	939
yuuji@271	940 @table @kbd
yuuji@271	941 @item [prefix] m
yuuji@271	942 @dots{} maketitle 型補完開始
yuuji@271	943 @end table
yuuji@271	944
yuuji@271	945 @noindent
yuuji@271	946 で、maketitle 型補完を開始します。補完の要領は今までのものとまったく同じで
yuuji@271	947 す。La@TeX{} 用のコマンド名が補完候補として用意されています。
yuuji@271	948
yuuji@271	949 @node Arbitrary completion, end補完, maketitle型補完, Completion
yuuji@271	950 @comment node-name, next, previous, up
yuuji@271	951 @section 随時補完
yuuji@271	952 @cindex 随時補完[すいしほかん]
yuuji@271	953 @cindex prefix SPC
yuuji@271	954
yuuji@271	955 さて、今まで述べた典型的な La@TeX{} コマンド形式の補完入力を用いずに、今
yuuji@271	956 入力しようとしている La@TeX{} コマンドを文書中の任意の位置で随時補完するこ
yuuji@271	957 ともできます。La@TeX{} コマンド(先頭が\で始まる)を入力している途中で、
yuuji@271	958
yuuji@271	959 @table @kbd
yuuji@271	960 @item [prefix] SPC
yuuji@271	961 @dots{} 随時補完
yuuji@271	962 @end table
yuuji@271	963
yuuji@271	964 @noindent
yuuji@271	965 を入力すれば、全ての補完候補の中から一致するものが選ばれカーソル位置に挿入
yuuji@271	966 されます。
yuuji@271	967
yuuji@271	968 @node end補完, Accent mark completion, Arbitrary completion, Completion
yuuji@271	969 @comment node-name, next, previous, up
yuuji@271	970 @section end補完
yuuji@271	971 @cindex end補完[endほかん]
yuuji@271	972 @cindex prefix e
yuuji@271	973
yuuji@271	974 現在開いたままの環境名を自動的に検出し、@code{\end@{環境名@}}を挿入しま
yuuji@271	975 す。begin 型補完を用いれば環境の閉じ忘れはないのですが、時にはついつい手で
yuuji@271	976 @code{\begin@{環境名@}} を入れてしまい、悲しい思いをすることがあります。そ
yuuji@271	977 のような時には気にせず続けて文章を入力し、しかるのちに
yuuji@271	978
yuuji@271	979 @table @kbd
yuuji@271	980 @item [prefix] e
yuuji@271	981 @dots{} end 補完
yuuji@271	982 @end table
yuuji@271	983
yuuji@271	984 @noindent
yuuji@271	985 とすることで、現在開いている環境名で \end@{@} が補われます。
yuuji@271	986
yuuji@271	987 @node Accent mark completion, Image completion, end補完, Completion
yuuji@271	988 @comment node-name, next, previous, up
yuuji@271	989 @section アクセント記号補完
yuuji@271	990 @cindex アクセント記号補完[あくせんときこうほかん]
yuuji@271	991 @cindex prefix a
yuuji@271	992 @cindex 欧文[おうふん]
yuuji@271	993
yuuji@271	994 欧文のアクセント記号(@code{\`@{o@}}など)を入力する時は、
yuuji@271	995
yuuji@271	996 @table @kbd
yuuji@271	997 @item [prefix] a
yuuji@271	998 @dots{} アクセント記号入力
yuuji@271	999 @end table
yuuji@271	1000
yuuji@271	1001 @noindent
yuuji@271	1002 を押すと、ミニバッファに
yuuji@271	1003
yuuji@271	1004 @example
yuuji@271	1005 1:` 2:' 3:^ 4:" 5:~ 6:= 7:. u v H t c d b
yuuji@271	1006 @end example
yuuji@271	1007
yuuji@271	1008 @noindent
yuuji@271	1009 というメニューが出て来るので、数字、または対応する記号/英字を入力
yuuji@271	1010 して下さい。すると編集バッファに、
yuuji@271	1011
yuuji@271	1012 @example
yuuji@271	1013 \`@{@}
yuuji@271	1014 @end example
yuuji@271	1015
yuuji@271	1016 @noindent
yuuji@271	1017 が現われ、カーソルが@{@}内に位置するので、さらに一文字入力する事で、
yuuji@271	1018
yuuji@271	1019 @example
yuuji@271	1020 \`@{o@}
yuuji@271	1021 @end example
yuuji@271	1022
yuuji@271	1023 @noindent
yuuji@271	1024 が完成され、カーソルは@{@}の外に戻ります。
yuuji@271	1025
yuuji@271	1026 @node Image completion, Greek letter completion, Accent mark completion, Completion
yuuji@271	1027 @comment node-name, next, previous, up
yuuji@271	1028 @section 数式記号イメージ補完
yuuji@271	1029 @cindex 数式記号イメージ補完[すうしききこういめえしほかん]
yuuji@271	1030 @cindex イメージ補完[いめえしほかん]
yuuji@271	1031 @cindex ;
yuuji@271	1032 @cindex 数式モード[すうしきもおと]
yuuji@271	1033 @cindex 矢印[やしるし]
yuuji@271	1034 @cindex Σ[しくま]
yuuji@271	1035 @cindex leftarrow
yuuji@271	1036 @cindex ∞[むけんたい]
yuuji@271	1037
yuuji@271	1038 主に数式モードで使用される、矢印やΣなどの記号を擬似的に表現するキー入力
yuuji@271	1039 で、La@TeX{} コマンドを入力できます。これは野鳥自身の「数式モード」でのみ
yuuji@271	1040 動作します。野鳥はカーソルが@TeX{}の数式環境の中にある時に@kbd{;}や、
yuuji@271	1041 @kbd{:}に特殊な機能を持たせます。
yuuji@271	1042
yuuji@271	1043 さて、例えば、←(leftarrow)をASCII文字だけで表現する場合、一般的には「<-」
yuuji@271	1044 のようにしますが、これを利用して、数式記号イメージ入力モードで
yuuji@271	1045 @code{\leftarrow}を入力するには、@kbd{;}(セミコロン)を打ってから@kbd{<-}と
yuuji@271	1046 入力します。同様に、長い矢印←-(long-leftarrow) をASCII文字だけで表現する
yuuji@271	1047 場合「<--」とするので、@code{\longleftarrow}を入力するためには、@kbd{;<--}
yuuji@271	1048 と入力します。あるいは無限大記号をASCII文字だけで表現する時は「oo」のよう
yuuji@271	1049 にすることから、@code{\infty} を入力する時は、@kbd{;oo}とキー入力します。
yuuji@271	1050
yuuji@271	1051 これらの操作をまとめると次のようになります。
yuuji@271	1052
yuuji@271	1053 @example
yuuji@271	1054 INPUT 入力される La@TeX{} コマンド
yuuji@271	1055 ; < - @code{\leftarrow}
yuuji@271	1056 ; < - - @code{\longleftarrow}
yuuji@271	1057 ; < - - > @code{\longleftrightarrow}
yuuji@271	1058 ; o @code{\circ}
yuuji@271	1059 ; o o @code{\infty}
yuuji@271	1060 @end example
yuuji@271	1061
yuuji@271	1062
yuuji@271	1063
yuuji@271	1064 いずれの場合も、イメージ入力を行っている途中で望みのものがバッファ
yuuji@271	1065 に表示されたなら、そこでイメージ入力を止めて次の編集動作に移っても
yuuji@271	1066 構いません。
yuuji@271	1067
yuuji@271	1068 @cindex ;自身[;ししん]
yuuji@271	1069 数式環境中で@samp{;}自身を入力するには@kbd{;;}のようにします。イメージ
yuuji@271	1070 入力の途中でTABを押すと、それまで入力した文字で始まるもの一覧が表示されま
yuuji@271	1071 す。ここで目的の La@TeX{} コマンドまでカーソルを移動し再度TABを押すことで
yuuji@271	1072 その La@TeX{} コマンドがバッファに挿入されます。
yuuji@271	1073
yuuji@271	1074 どのキー入力にどの記号が対応しているか全て知りたい時は、@kbd{;}を押した
yuuji@271	1075 直後にTABを押してください。以下の例は、@kbd{;<}と押した後にTABを押したもの
yuuji@271	1076 です。
yuuji@271	1077
yuuji@271	1078 @example
yuuji@271	1079 KEY LaTeX sequence sign
yuuji@271	1080 < \leq ≦
yuuji@271	1081 << \ll 《
yuuji@271	1082 <- \leftarrow ←
yuuji@271	1083 <= \Leftarrow <=
yuuji@271	1084 @end example
yuuji@271	1085
yuuji@271	1086 左から[入力キー]、[対応する La@TeX{} コマンド]、[(擬似)記号図示]、と
yuuji@271	1087 いう順でメニューが出て来るので、よく使うものを覚えておくと良いでしょ
yuuji@271	1088 う。ものによってはASCII文字で表現することが困難なので、あまり覚え
yuuji@271	1089 やすいキー並びではないものがあるでしょうから、そのような場合は
yuuji@271	1090 \maketitle 型補完で入力するか、以下に述べる対応表の設定を行って単
yuuji@271	1091 純なキー並びのものを設定すると良いでしょう。
yuuji@271	1092
yuuji@271	1093 入力キーと La@TeX{} コマンド、記号の対応表を個人的に設定したい場合は
yuuji@271	1094 Emacs-Lisp 変数 @code{YaTeX-math-sign-alist-private} に定義してください。
yuuji@271	1095 その内容とデフォルトのものを合わせたものが対応表として使用されます(private
yuuji@271	1096 の方が優先される)。なお、この変数の構造については @file{yatexmth.el} を参
yuuji@271	1097 照してください。
yuuji@271	1098 @cindex YaTeX-math-sign-alist-private
yuuji@271	1099
yuuji@392	1100 @node Greek letter completion, Inserting parens, Image completion, Completion
yuuji@271	1101 @comment node-name, next, previous, up
yuuji@271	1102 @section ギリシャ文字補完
yuuji@271	1103 @cindex ギリシャ文字補完[きりしやもしほかん]
yuuji@271	1104 @cindex :
yuuji@271	1105
yuuji@271	1106 もう一つ、数式環境中で@kbd{:}を押すとギリシャ文字入力モードに入ります。
yuuji@271	1107 @kbd{:}を押した直後に@kbd{a}を押すと@code{\alpha}が、@kbd{g} を押すと
yuuji@271	1108 @code{\gamma}が、などアルファベットに対応したギリシャ文字が挿入されます。
yuuji@271	1109 操作方法は;の数式記号補完とまったく同じです。まずは@kbd{:}の直後に
yuuji@271	1110 TABを押してどのアルファベットにどのギリシャ文字が対応しているか調べてみて
yuuji@271	1111 ください。
yuuji@271	1112
yuuji@271	1113 @kbd{;}と@kbd{:}を数式環境中で押しているにもかかわらず、イメージ補完が働
yuuji@271	1114 かない場合は、@kbd{C-u ;}のように universal-argument をつけてキーを押すこ
yuuji@271	1115 とにより、強制的にイメージ補完に入ることができます。また、この時にどのよう
yuuji@271	1116 な状態で数式環境内判定に失敗したかをご連絡下さい。
yuuji@271	1117
yuuji@392	1118 @node Inserting parens, , Greek letter completion, Completion
yuuji@392	1119 @section 括弧入力補助
yuuji@392	1120 @cindex 括弧入力補助[かつこにゆうりよくほしよ]
yuuji@392	1121
yuuji@392	1122 3種類ある括弧 () {} [] の開き括弧を入れたときに閉じ括弧を自動的に入れます。
yuuji@392	1123 @code{\} の直後にの @code{[} を入れると行を分けてインデントを揃え、
yuuji@392	1124 数式入力に備えます。その他 La@TeX{} のマクロに応じて括弧の釣合の取れた
yuuji@392	1125 状態に導きます。開き括弧そのものを1つだけ入れたいときは @kbd{C-q} で
yuuji@392	1126 クォート入力するか、@kbd{[prefix] w m} で修正モードをOFFにしてください。
yuuji@392	1127
yuuji@392	1128 領域選択してから開き括弧を入れるとその領域をその種類の括弧で括ります。
yuuji@392	1129
yuuji@271	1130 @node Local dictionary, Commenting out, Completion, Top
yuuji@271	1131 @comment node-name, next, previous, up
yuuji@271	1132 @chapter ローカル辞書
yuuji@271	1133 @cindex ローカル辞書[ろおかるししよ]
yuuji@271	1134 @cindex .yatexrc
yuuji@271	1135
yuuji@271	1136 補完入力用の候補は三種類の辞書から構成されています。一つは
yuuji@271	1137 @file{yatex.el}に組み込まれた「標準辞書」、もう一つはユーザが個人的に常用
yuuji@271	1138 するコマンドを保存する「ユーザ辞書」、そしてもうひとつはあるディレクトリで
yuuji@271	1139 のみ有効なコマンドを保存する「ローカル辞書」です。
yuuji@271	1140
yuuji@271	1141 補完入力時に新しい単語を入れた場合に、その単語をどの辞書に入れるか聞いて
yuuji@271	1142 来ます。
yuuji@271	1143
yuuji@271	1144 @example
yuuji@271	1145 `foo' is not in table. Register into: U)serDic L)ocalDic N)one D)iscard
yuuji@271	1146 @end example
yuuji@271	1147
yuuji@271	1148 @noindent
yuuji@271	1149 というプロンプトに対し、@kbd{u}と答えると「ユーザ辞書」を、@kbd{l}と答える
yuuji@271	1150 とローカル辞書を更新し、@kbd{n}と答えると辞書ファイルは更新せず現在のEmacs
yuuji@271	1151 セッションのみ有効な単語とし、@kbd{d}と答えると新たな単語を学習せずに捨て
yuuji@271	1152 ることになります。
yuuji@271	1153
yuuji@271	1154 もし、ローカル辞書の機能はいらず、全てユーザ辞書の更新のみでよいと言う場
yuuji@271	1155 合には@file{~/.emacs}などで、
yuuji@271	1156 @cindex YaTeX-nervous
yuuji@271	1157
yuuji@271	1158 @lisp
yuuji@271	1159 (setq YaTeX-nervous nil)
yuuji@271	1160 @end lisp
yuuji@271	1161
yuuji@271	1162 @noindent
yuuji@271	1163 として下さい。
yuuji@271	1164
yuuji@271	1165 @node Commenting out, Cursor jump, Local dictionary, Top
yuuji@271	1166 @comment node-name, next, previous, up
yuuji@271	1167 @chapter コメントアウト
yuuji@271	1168 @cindex コメントアウト[こめんとあうと]
yuuji@271	1169 @cindex prefix <
yuuji@271	1170 @cindex prefix >
yuuji@271	1171 @cindex prefix .
yuuji@271	1172 @cindex prefix ,
yuuji@271	1173
yuuji@271	1174
yuuji@271	1175 La@TeX{}の編集には試行錯誤がつきものです。ある部分を一括でコメントアウト
yuuji@271	1176 したり、コメントを外したりしたいことがあります。
yuuji@271	1177
yuuji@271	1178 @table @kbd
yuuji@271	1179 @item [prefix] >
yuuji@271	1180 @dots{} リジョンを % でコメントアウト
yuuji@271	1181 @item [prefix] <
yuuji@271	1182 @dots{} リジョンの % のコメントを外す
yuuji@271	1183 @end table
yuuji@271	1184
yuuji@271	1185 @noindent
yuuji@271	1186 は、あらかじめ設定したリジョンに対しての操作、
yuuji@271	1187
yuuji@271	1188 @table @kbd
yuuji@271	1189 @item [prefix] .
yuuji@271	1190 @dots{} 現在のパラグラフをコメントアウト
yuuji@271	1191 @item [prefix] ,
yuuji@271	1192 @dots{} 現在のパラグラフのコメントを外す
yuuji@271	1193 @end table
yuuji@271	1194
yuuji@271	1195 @noindent
yuuji@271	1196 は、カーソルの位置するパラグラフ全体に対しての操作です。なお、ここでいう
yuuji@271	1197 「パラグラフ」は (@code{mark-paragraph}) 関数によりマークされる範囲を指し
yuuji@271	1198 ます(標準設定で@kbd{ESC h}にバインドされている)。なお、既に@code{%}でコメ
yuuji@271	1199 ントアウトされているパラグラフに対して繰り返しパラグラフのコメントを使用し
yuuji@271	1200 た場合の動作は保証しませんので御注意ください。
yuuji@271	1201
yuuji@271	1202 さて、文章に対してだけでなく、時には@code{\begin}, @code{\end} 自体に対
yuuji@271	1203 してもコメントアウトの操作をしたいときがあります。このようなときは、
yuuji@271	1204 @code{\begin@{@}} あるいは @code{\end@{@}} の行にカーソルを合わせ、
yuuji@271	1205
yuuji@271	1206 @table @kbd
yuuji@271	1207 @item [prefix] >
yuuji@271	1208 @dots{} @code{\begin@{@}}～@code{\end@{@}} 全てコメントアウト
yuuji@271	1209 @item [prefix] <
yuuji@271	1210 @dots{} @code{\begin@{@}}～@code{\end@{@}} 全てコメントを外す
yuuji@271	1211 @end table
yuuji@271	1212
yuuji@271	1213 @noindent
yuuji@271	1214 とすることで、@code{\begin～\end}で囲まれる環境全てに対してコメント操作し、
yuuji@271	1215
yuuji@271	1216 @table @kbd
yuuji@271	1217 @item [prefix] .
yuuji@271	1218 @dots{} @code{\begin@{@}} と @code{\end@{@}} をコメントアウト
yuuji@271	1219 @item [prefix] ,
yuuji@271	1220 @dots{} @code{\begin@{@}} と @code{\end@{@}} のコメントを外す
yuuji@271	1221 @end table
yuuji@271	1222
yuuji@271	1223 は、対応する @code{\begin} と @code{\end} 2行だけを、コメント操作の対象と
yuuji@271	1224 します。リジョンをコメントアウトしようとして、マークを設定したのちにカーソ
yuuji@271	1225 ルを移動し@kbd{[preifx] >} を押してもカーソルが @code{\begin@{@}} の上にあ
yuuji@271	1226 ると@code{\begin@{@}}～@code{\end@{@}}モードでコメント機能が働いてしまうの
yuuji@271	1227 で注意して下さい。
yuuji@271	1228
yuuji@271	1229 @node Cursor jump, Modifying/Deleting, Commenting out, Top
yuuji@271	1230 @comment node-name, next, previous, up
yuuji@271	1231 @chapter カーソルジャンプ
yuuji@271	1232 @cindex カーソルジャンプ[かあそるしやんふ]
yuuji@271	1233 @cindex prefix g
yuuji@271	1234
yuuji@271	1235
yuuji@271	1236 @menu
yuuji@271	1237 * 対応オブジェクトへのジャンプ::
yuuji@271	1238 * お絵描きツール起動::
yuuji@271	1239 * メインファイルへのジャンプ::
yuuji@271	1240 * 環境を単位としたジャンプ::
yuuji@271	1241 * 最後の補完位置へのジャンプ::
yuuji@271	1242 @end menu
yuuji@271	1243
yuuji@271	1244 @node 対応オブジェクトへのジャンプ, お絵描きツール起動, Cursor jump, Cursor jump
yuuji@271	1245 @comment node-name, next, previous, up
yuuji@271	1246 @section 対応オブジェクトへのジャンプ
yuuji@271	1247
yuuji@271	1248 文書中のいろいろな場所で
yuuji@271	1249
yuuji@271	1250 @table @kbd
yuuji@271	1251 @item [prefix] g
yuuji@271	1252 @dots{} 対応するオブジェクトにジャンプ
yuuji@271	1253 @end table
yuuji@271	1254
yuuji@271	1255 @noindent
yuuji@271	1256 を押すことにより、カーソル位置のLa@TeX{}コマンドに対応する場所にジャンプ
yuuji@271	1257 します。対応関係が存在すると解釈されるコマンドには以下のものがあります。
yuuji@271	1258
yuuji@271	1259 @itemize @bullet
yuuji@271	1260 @item @code{\begin@{@}} ←→ @code{\end@{@}}
yuuji@271	1261 @item @code{%#BEGIN} ←→ @code{%#END}
yuuji@271	1262 @item 画像ファイルの取り込みマクロ → 対応するviewer/お絵かきツール起動
yuuji@271	1263 @item @code{\label@{@}} ←→ @code{\ref@{@}}
yuuji@271	1264 @item @code{\include(\input)} → 対応するファイル
yuuji@271	1265 @item @code{\bibitem@{@}} ←→ @code{\cite@{@}}
yuuji@271	1266 @end itemize
yuuji@271	1267
yuuji@271	1268 @code{\begin@{@}} か @code{\end@{@}} の行で@kbd{[prefix] g}を押すことに
yuuji@271	1269 より、対応する@code{end/begin}の行にジャンプします。もちろん対応するものが
yuuji@271	1270 ない場合はエラーになります。またこれは、領域固定のための @code{%#BEGIN} と
yuuji@271	1271 @code{%#END} のペアに対しても同様に動作します。なお、@code{label/ref}や
yuuji@271	1272 @code{cite/bibitem}対応するものが別ファイルにある時は、ジャンプ先となるファ
yuuji@271	1273 イルがオープンされていなければなりません。@xref{%#notation}.
yuuji@271	1274 メインの .tex ファイルの @code{\include@{chap1@}} などにカーソルを合わせ、
yuuji@271	1275 @kbd{[prefix] g} を押すと、@file{chap1.tex} にジャンプします。
yuuji@271	1276
yuuji@271	1277 また、
yuuji@271	1278
yuuji@271	1279 @table @kbd
yuuji@271	1280 @item [prefix] 4 g
yuuji@271	1281 @dots{} 別ウィンドウで対応オブジェクトにジャンプ
yuuji@271	1282 @end table
yuuji@271	1283
yuuji@271	1284 @noindent
yuuji@271	1285 を押すと、対応するオブジェクトへのジャンプを別ウィンドウで行います。ただし、
yuuji@271	1286 この機能は @code{begin/end}, @code{%#BEGIN/%#END} 間のジャンプに対しては
yuuji@271	1287 (意味がないと思われるので)機能しないので注意してください。
yuuji@271	1288
yuuji@271	1289 @node お絵描きツール起動, メインファイルへのジャンプ, 対応オブジェクトへのジャンプ, Cursor jump
yuuji@271	1290 @comment node-name, next, previous, up
yuuji@271	1291 @section お絵描きツール起動
yuuji@271	1292 @cindex お絵描きツール起動[おえかきつうるきとう]
yuuji@271	1293
yuuji@271	1294 上記の「画像ファイルの取り込みマクロ」とは、例えば
yuuji@271	1295 @code{\epsfile@{file=foo@}} のような挿絵取り込みコマンドのことで、この行に
yuuji@271	1296 カーソルを合わせて@kbd{[prefix] g}を押すとその画像ファイルの元となったファ
yuuji@271	1297 イルを対応するお絵描きツールを起動してオープンします。起動するツールの判定
yuuji@271	1298 は以下のようになされます。
yuuji@271	1299
yuuji@271	1300 @enumerate
yuuji@271	1301 @item
yuuji@271	1302 カレント行が変数 @code{YaTeX-processed-file-regexp-alist} に定義さ
yuuji@271	1303 れている正規表現のいずれかとマッチしたら、ファイル名に相当する部分を
yuuji@271	1304 \$\$から抜き出して覚えておく(何番目の\$\$かは変数の各リストの cdr 部に
yuuji@271	1305 入れておく)。マッチしなければ何もしない。
yuuji@271	1306 @item
yuuji@271	1307 行末に、変数 @code{YaTeX-file-processor-alist} に登録されているコマンドが
yuuji@271	1308 「%コマンド」のように書いてあれば強制的に「コマンドファイル名.拡張子」を
yuuji@271	1309 起動。
yuuji@271	1310 @item
yuuji@271	1311 なければ、変数 @code{YaTeX-file-processor-alist} の各リストのcdr部に入って
yuuji@271	1312 いる拡張子を「ファイル名」の後ろに足したファイルが存在するか順次調べて、存
yuuji@271	1313 在した場合car部に入っているコマンドを起動する。
yuuji@271	1314 @item
yuuji@271	1315 以上どれかにマッチしなければあきらめる。
yuuji@271	1316 @end enumerate
yuuji@271	1317
yuuji@271	1318
yuuji@271	1319 変数 @code{YaTeX-file-processor-alist} と変数
yuuji@271	1320 @code{YaTeX-file-processor-alist} の設定方法についてはそれぞれの変数につい
yuuji@271	1321 て describe-variable して説明を読んで下さい。うまく設定すると、画像ファイ
yuuji@271	1322 ルにかぎらず、任意の形式のファイルを任意のプロセッサで処理するコマンドを簡
yuuji@271	1323 単に呼び出すことができます。
yuuji@271	1324
yuuji@271	1325 @node メインファイルへのジャンプ, 環境を単位としたジャンプ, お絵描きツール起動, Cursor jump
yuuji@271	1326 @comment node-name, next, previous, up
yuuji@271	1327 @section メインファイルへのジャンプ
yuuji@271	1328
yuuji@271	1329 @file{chap1.tex}のようなサブファイルで、
yuuji@271	1330
yuuji@271	1331 @table @kbd
yuuji@271	1332 @item [prefix] ^
yuuji@271	1333 @dots{} メインファイルにジャンプ
yuuji@271	1334 @item [prefix] 4 ^
yuuji@271	1335 @dots{} 別ウィンドウでメインファイルにジャンプ
yuuji@271	1336 @end table
yuuji@271	1337
yuuji@271	1338 @noindent
yuuji@271	1339 を押すと、メインファイルの編集バッファに切替えます。もし、メインファイルを
yuuji@271	1340 オープンしていない場合は、カレントディレクトリから探して自動的にオープンし
yuuji@271	1341 ます。
yuuji@271	1342
yuuji@271	1343 @node 環境を単位としたジャンプ, 最後の補完位置へのジャンプ, メインファイルへのジャンプ, Cursor jump
yuuji@271	1344 @comment node-name, next, previous, up
yuuji@271	1345 @section 環境を単位としたジャンプ
yuuji@271	1346
yuuji@271	1347 さらに現在の環境を単位として機能するコマンドに以下のものがあります。
yuuji@271	1348
yuuji@271	1349 @cindex 環境の先頭へ[かんきようのせんとうへ]
yuuji@271	1350 @cindex 環境の末尾へ[かんきようのまつひへ]
yuuji@271	1351 @cindex 環境をマーク[かんきようをまあく]
yuuji@271	1352 @cindex M-C-a
yuuji@271	1353 @cindex M-C-e
yuuji@271	1354 @cindex M-C-@@
yuuji@271	1355 @table @kbd
yuuji@271	1356 @item M-C-a
yuuji@271	1357 @dots{} 環境の先頭(@code{\begin})へジャンプ
yuuji@271	1358 @item M-C-e
yuuji@271	1359 @dots{} 環境の末尾(@code{\end})へジャンプ
yuuji@271	1360 @item M-C-@@
yuuji@271	1361 @dots{} 環境全体をマーク
yuuji@271	1362 @end table
yuuji@271	1363
yuuji@271	1364 上記のコマンドは通常の@kbd{[prefix]}キーではなく@kbd{META}キーをプリフィク
yuuji@271	1365 スとして機能するのでご注意下さい。
yuuji@271	1366
yuuji@271	1367 @node 最後の補完位置へのジャンプ, , 環境を単位としたジャンプ, Cursor jump
yuuji@271	1368 @comment node-name, next, previous, up
yuuji@271	1369 @section 最後の補完位置へのジャンプ
yuuji@271	1370
yuuji@271	1371 野鳥は補完入力した位置を常にレジスタ @code{3}に保存しています。
yuuji@271	1372 入力途中で如何なるファイルの如何なる位置に行ったとしても、
yuuji@271	1373 @kbd{C-x j 3}(@code{jump-to-register})を使って直ちに最後の補完入力位置に戻
yuuji@271	1374 ることができます。
yuuji@271	1375
yuuji@271	1376 @node Modifying/Deleting, Filling, Cursor jump, Top
yuuji@271	1377 @comment node-name, next, previous, up
yuuji@271	1378 @chapter 変更/削除
yuuji@271	1379 @cindex 変更/削除[へんこう/さくしよ]
yuuji@271	1380 @cindex prefix c
yuuji@271	1381 @cindex prefix k
yuuji@271	1382
yuuji@271	1383 既に入力されている La@TeX{} コマンドの変更/削除のために以下の機能が用意
yuuji@271	1384 されています。
yuuji@271	1385
yuuji@271	1386 @table @kbd
yuuji@271	1387 @item [prefix] c
yuuji@271	1388 @dots{} カーソル位置の La@TeX{} コマンドの変更
yuuji@271	1389 @item [prefix] k
yuuji@271	1390 @dots{} カーソル位置の La@TeX{} コマンドの削除
yuuji@271	1391 @end table
yuuji@271	1392
yuuji@271	1393
yuuji@271	1394 これらのコマンドは、コマンドを起動する場所によって動作を決定するので注意し
yuuji@271	1395 て下さい。
yuuji@271	1396
yuuji@271	1397 @menu
yuuji@271	1398 * Changing LaTeX command:: La@TeX{} コマンドの変更
yuuji@271	1399 * Killing LaTeX command:: La@TeX{} コマンドの削除
yuuji@271	1400 @end menu
yuuji@271	1401
yuuji@271	1402 @node Changing LaTeX command, Killing LaTeX command, Modifying/Deleting, Modifying/Deleting
yuuji@271	1403 @comment node-name, next, previous, up
yuuji@271	1404 @section La@TeX{} コマンドの変更
yuuji@271	1405
yuuji@271	1406 変更したい La@TeX{} コマンドにカーソルを合わせて @kbd{[prefix] c}
yuuji@271	1407 を押すとそのコマンドを補完入力などを用いて手軽に変えることができます。
yuuji@271	1408 @kbd{[prefix] c} で変更できるコマンドには以下のものがあります。
yuuji@271	1409
yuuji@271	1410 @itemize
yuuji@271	1411 @item @code{begin/end} の環境名
yuuji@271	1412 @item section型コマンドのコマンド名
yuuji@271	1413 @item section型コマンドの引数
yuuji@271	1414 @item section型コマンドのオプションパラメータ([]で囲まれたもの)
yuuji@271	1415 @item large型コマンド
yuuji@271	1416 @item (イメージ補完で入力可能な)数式モード専用のmaketitle型コマンド
yuuji@271	1417 @end itemize
yuuji@271	1418
yuuji@271	1419 変えたいsection型コマンドの引数がさらに La@TeX{} コマンドを含む場合は、
yuuji@271	1420 その引数を囲む中括弧の上で @kbd{[prefix] c} を押すことで中のコマンドを変更
yuuji@271	1421 対象判定から除外することができます。
yuuji@271	1422
yuuji@271	1423 @cindex 環境名の変更[かんきようめいのへんこう]
yuuji@271	1424
yuuji@271	1425 @node Killing LaTeX command, , Changing LaTeX command, Modifying/Deleting
yuuji@271	1426 @comment node-name, next, previous, up
yuuji@271	1427 @section La@TeX{} コマンドの削除
yuuji@271	1428
yuuji@271	1429 @kbd{[prefix] k} は起動する位置により
yuuji@271	1430 次のような動作を行います。
yuuji@271	1431 @cindex 環境の削除[かんきようのさくしよ]
yuuji@271	1432
yuuji@271	1433
yuuji@271	1434 @example
yuuji@271	1435 起動位置動作
yuuji@271	1436 \begin, \endの行 @code{\begin\end}ペアの削除
yuuji@271	1437 %#BEGIN, %#END の行 %#BEGIN,%#ENDペアの削除
yuuji@271	1438 section型コマンドの上(中) section型コマンドの削除
yuuji@271	1439 フォント指定括弧の上フォント指定の削除
yuuji@271	1440 括弧の上対をなす括弧の削除
yuuji@271	1441 @end example
yuuji@271	1442
yuuji@271	1443
yuuji@271	1444 @code{\begin, \end} および @code{%#BEGIN, %#END} を削除する場合、
yuuji@271	1445 @code{\begin, \end} や @code{%#BEGIN, %#END} の存在する行は
yuuji@271	1446 まるごと削除されるので、それらの一行に @code{\begin} などを二つ以上連ねて
yuuji@271	1447 書かないように注意してください。
yuuji@271	1448 上記のものはすべて本文を囲う「容器」を削除するように働きますが、
yuuji@271	1449 universal-argument (@kbd{C-u}) を打った後で@kbd{[prefix] k}をタイプすると、
yuuji@271	1450 それぞれの「容器」に含まれる「中身」も一気に削除します。以下の例を参考にし
yuuji@271	1451 て下さい。
yuuji@271	1452
yuuji@271	1453 @example
yuuji@271	1454 元のテキスト: [prefix] k C-u [prefix] k
yuuji@271	1455 本文\footnote@{脚注@}です。本文脚注です。本文です。
yuuji@271	1456 ↑(カーソル位置)
yuuji@271	1457 @end example
yuuji@271	1458
yuuji@271	1459 @node Filling, Includeonly, Modifying/Deleting, Top
yuuji@271	1460 @comment node-name, next, previous, up
yuuji@271	1461 @chapter 桁揃え
yuuji@271	1462 @cindex 桁揃え[けたそろえ]
yuuji@271	1463
yuuji@271	1464 @section itemの桁揃え
yuuji@271	1465 @cindex itemなどの桁揃え[itemなとのけたそろえ]
yuuji@271	1466 @cindex prefix i
yuuji@271	1467
yuuji@271	1468 itemize 環境中にある@code{\item}の項目(文章)が複数行に渡る場合に、項
yuuji@271	1469 目の先頭を桁揃えしたい場合には、
yuuji@271	1470
yuuji@271	1471 @c @table @kbd
yuuji@271	1472 @c @item [prefix] i
yuuji@271	1473 @c @dots{} itemの桁揃え
yuuji@271	1474 @c @end table
yuuji@271	1475
yuuji@271	1476 @table @kbd
yuuji@271	1477 @item M-q
yuuji@271	1478 @dots{} 桁揃え
yuuji@271	1479 @end table
yuuji@271	1480 @cindex NTT-jTeX[えぬていいていいしえいてつく]
yuuji@271	1481
yuuji@271	1482 @noindent
yuuji@271	1483 によって、その item のインデントの深さに応じて fill されます。なお、古い
yuuji@271	1484 NTT jTeX を使用している場合には、Lisp 変数@code{NTT-jTeX}を@code{t}にセッ
yuuji@271	1485 トして下さい。
yuuji@271	1486
yuuji@271	1487 @cindex YaTeX-item-regexp
yuuji@271	1488 このとき、変数@code{YaTeX-item-regexp}の値(標準では @code{"\\\\item"})を
yuuji@271	1489 項目指定コマンドの正規表現として検索に使用します。itemize 環境で、独自のコ
yuuji@271	1490 マンドを定義して項目を列挙している場合(例えば@code{\underlineitem})は、
yuuji@271	1491 @file{~/.emacs} で次のように指定して下さい。
yuuji@271	1492
yuuji@271	1493 @lisp
yuuji@271	1494 (setq YaTeX-item-regexp
yuuji@271	1495 "\$\\\\\\(sub\$*item\\)\\\|\$\\\\underlineitem\$")
yuuji@271	1496 @end lisp
yuuji@271	1497
yuuji@271	1498
yuuji@271	1499 この変数の指定の仕方がよく分からない場合は、独自の項目列挙コマンドの名前を
yuuji@271	1500 @code{@code{"\item"}で始まるものにして下さい(例えば"\itembf"})。
yuuji@271	1501
yuuji@271	1502 野鳥の @kbd{M-q} では @code{\item} を環境に応じて以下のように「ハングイン
yuuji@271	1503 デント」します。
yuuji@271	1504
yuuji@271	1505 @example
yuuji@271	1506 itemize, enumerate環境:
yuuji@271	1507 >\item[ほげほげ] 英語では、特に意味のない単語を `foo' であらわしま
yuuji@271	1508 > すが、これの日本語版ともいえる単語が「ほげほげ」
yuuji@271	1509 > です。
yuuji@271	1510 description環境:
yuuji@271	1511 > \item[へろへろ] 「ほげほげ」をでたらめが単語として使った時に、第
yuuji@271	1512 > 2のでたらめな単語として「へろへろ」が使われることが多
yuuji@271	1513 > いようです。
yuuji@271	1514 @end example
yuuji@271	1515
yuuji@271	1516 @section パラグラフの桁揃え
yuuji@271	1517 @cindex パラグラフの桁揃え[はらくらふのけたそろえ]
yuuji@271	1518 @cindex M-q
yuuji@271	1519
yuuji@271	1520 itemize環境以外でのパラグラフの桁揃え(fill)は、基本的に他のモードと同じ
yuuji@271	1521 ように機能しますが、verbatim環境や、tabular環境など桁揃えをすると悲惨な状
yuuji@271	1522 況になるような環境中では機能しません。また、\verb で括ってあるものは決して
yuuji@271	1523 行分割されません(変数 @code{YaTeX-verb-regexp} で制御) )。さらに、一時的に
yuuji@271	1524 インデントの深さを変えてある箇所では、そのインデントの先頭で@kbd{M-q}を押
yuuji@271	1525 すことにより fill-prefix をいちいち変更しなくて桁揃えができます。
yuuji@271	1526
yuuji@271	1527
yuuji@271	1528 @node Includeonly, What column, Filling, Top
yuuji@271	1529 @comment node-name, next, previous, up
yuuji@271	1530 @chapter 勝手にincludeonly
yuuji@271	1531 @cindex 勝手にincludeonly[かつてにincludeonly]
yuuji@271	1532 @cindex includeonly
yuuji@271	1533
yuuji@271	1534 ファイルを分割して文章を入力している時には、メインファイル中に
yuuji@271	1535
yuuji@271	1536 @example
yuuji@271	1537 \includeonly@{現在編集中のファイル名@}
yuuji@271	1538 @end example
yuuji@271	1539
yuuji@271	1540 @noindent
yuuji@271	1541 のように書いておくことで、タイプセットの時間を節約できますが、ちょっと他の
yuuji@271	1542 ファイルを手直ししたい時には
yuuji@271	1543 @cindex 他のファイルの手直し[ほかのふあいるのてなおし]
yuuji@271	1544
yuuji@271	1545 @example
yuuji@271	1546 \includeonly@{ちょっと手直ししたいファイル名@}
yuuji@271	1547 @end example
yuuji@271	1548
yuuji@271	1549
yuuji@271	1550 と書き直さなければならず手間がかかります。野鳥では現在編集しているファイル
yuuji@271	1551 名がメインファイルの@code{\includeonly}にない場合には自動的にこれを検出し、
yuuji@271	1552 次の指示を仰ぎます。
yuuji@271	1553
yuuji@271	1554 @example
yuuji@271	1555 A)dd R)eplace %)comment?
yuuji@271	1556 @end example
yuuji@271	1557
yuuji@271	1558
yuuji@271	1559 現在編集中のファイルを @code{\includeonly} のリストに加えたい時には@kbd{a}
yuuji@271	1560 を、現在編集中のファイルだけを @code{\includeonly} にしたい時は@kbd{r}を、
yuuji@271	1561 @code{\includeonly} の行をコメントアウトして無効化したい時には、@kbd{%}を
yuuji@271	1562 それぞれ押して下さい。
yuuji@271	1563
yuuji@271	1564 @node What column, Intelligent newline, Includeonly, Top
yuuji@271	1565 @comment node-name, next, previous, up
yuuji@271	1566 @chapter ここはどこ?
yuuji@271	1567 @cindex ここはどこ?[ここはとこ?]
yuuji@271	1568 @cindex prefix &
yuuji@271	1569 @cindex 複雑なtabular[ふくさつなtabular]
yuuji@271	1570
yuuji@271	1571 項目数の多い tabular などをたくさん書いていると下の方の行で、いま書いて
yuuji@271	1572 いる桁がどこに対応するのかわからなくなってしまうことがあります。例えば、以
yuuji@271	1573 下のような tabular において、
yuuji@271	1574
yuuji@271	1575 @example
yuuji@271	1576 \begin@{tabular@}@{\|c\|c\|c\|c\|c\|c\|c\|c\|@}\hline
yuuji@271	1577 氏名&所属&〒&住所&電話&FAX&帰省先&帰省先電話\\ \hline
yuuji@271	1578 矢上二郎 & 6 & 223 & 横浜市港北区日吉 & xxx-yyy &
yuuji@271	1579 zzz-www & トンガ & 9876-54321 \\
yuuji@271	1580 日吉小僧 & 2 & \multicolumn@{2@}@{c\|@}@{教えない@}
yuuji@271	1581 &&&(???)
yuuji@271	1582 \\ \hline
yuuji@271	1583 \end@{tabular@}
yuuji@271	1584 @end example
yuuji@271	1585
yuuji@271	1586
yuuji@271	1587 (???)の部分がどの項目なのかすぐに判断するのは難しいでしょう。こんな時は、
yuuji@271	1588
yuuji@271	1589 @table @kbd
yuuji@271	1590 @item [prefix] &
yuuji@271	1591 @dots{} 現在のカラム表示
yuuji@271	1592 @end table
yuuji@271	1593 @cindex 現在のカラム表示[けんさいのからむひようし]
yuuji@271	1594
yuuji@271	1595 @noindent
yuuji@271	1596 を押すとカーソル位置のカラムがどの項目に該当するかをミニバッファに表示しま
yuuji@271	1597 す。tabular/array環境の第1行目を項目名の並びとみなして対応するものを探しま
yuuji@271	1598 す。もし項目名として別のものを表示して欲しい場合は、行頭を@code{%}にしてダ
yuuji@271	1599 ミーの項目並びを作っておくと良いでしょう。
yuuji@271	1600
yuuji@271	1601 @node Intelligent newline, Usepackage cheker, What column, Top
yuuji@271	1602 @comment node-name, next, previous, up
yuuji@271	1603 @chapter おまかせ改行
yuuji@271	1604 @cindex おまかせ改行[おまかせかいきよう]
yuuji@271	1605 @cindex &入力[&にゆうりよく]
yuuji@271	1606
yuuji@271	1607 tabular[*], array, itemize, enumerate, tabbing 環境をbegin型補完で入力し
yuuji@271	1608 た時、または各環境内で
yuuji@271	1609
yuuji@271	1610 @table @kbd
yuuji@271	1611 @item ESC RET
yuuji@271	1612 @dots{} おまかせ改行
yuuji@271	1613 @end table
yuuji@271	1614
yuuji@271	1615
yuuji@271	1616 を押すと、その環境に応じた行エントリを次の行に挿入します(begin型補完時に自
yuuji@271	1617 動挿入されたエントリが不要な場合は undo によって消去できます)。例えば、
yuuji@271	1618 tabular環境では、その環境のカラム数に対応した個数の @code{&} に加え、行末
yuuji@271	1619 の @code{\\} を入れます。この時それ以前に @code{\hline} があればそれも付け
yuuji@271	1620 加えます。環境とそれに応じて自動入力するものの対応は以下のようになります。
yuuji@271	1621
yuuji@271	1622 @itemize
yuuji@271	1623 @item @code{tabular}, @code{tabular*}, @code{array}
yuuji@271	1624
yuuji@271	1625 カラム数-1 だけの @code{&} と @code{\\}。必要に応じて @code{\hline}
yuuji@271	1626
yuuji@271	1627 @item @code{tabbing}
yuuji@271	1628
yuuji@271	1629 一行目で定義している @code{\=} と同じ個数の @code{\>}。
yuuji@271	1630
yuuji@271	1631 @item @code{itemize}, @code{enumerate}, @code{description}, @code{list}
yuuji@271	1632
yuuji@271	1633 @code{\item} または @code{item[]}
yuuji@271	1634 @end itemize
yuuji@271	1635
yuuji@271	1636 tabular 環境の例のように、本機能は各環境の一行目の内容を参考にして動作す
yuuji@271	1637 るので、なるべく二行目以降で呼び出すようにしてください。
yuuji@271	1638
yuuji@271	1639 もし、その他の環境、例えば @code{foo}、に対して@code{おまかせ改行}を動作
yuuji@271	1640 させたい時は、@code{YaTeX-intelligent-newline-foo} という名前の関数を定義
yuuji@271	1641 します。定義した関数は、現在の行に改行を挿入した直後の行頭の位置で呼ばれま
yuuji@271	1642 す。関数 @code{YaTeX-indent-line} を呼ぶと現在の環境のネストに応じた深さに
yuuji@271	1643 インデントされるので、これを呼んでから何かを挿入するようなコードを書くとよ
yuuji@271	1644 いでしょう。@file{yatexenv.el}内の関数
yuuji@271	1645 @code{YaTeX-intelligent-newline-itemize} の定義などを参考にしてください。
yuuji@271	1646
yuuji@271	1647
yuuji@271	1648 @node Usepackage cheker, Changing mode of YaTeX, Intelligent newline, Top
yuuji@271	1649 @comment node-name, next, previous, up
yuuji@271	1650 @chapter 先回りusepackage
yuuji@271	1651 @cindex 先回りusepackage[さきまわり]
yuuji@271	1652
yuuji@271	1653 begin型、section型、maketitle型、いずれかのLaTeX2eマクロを補完入力すると、
yuuji@271	1654 そのマクロの利用に外部パッケージを必要とする場合、そのパッケージを
yuuji@271	1655 本文中で @code{\usepackage@{@}} しているかどうかを調査し、もししていなければ
yuuji@271	1656 プリアンブルに対応するパッケージを引数にした @code{\usepackage} 文を
yuuji@271	1657 (確認後に)挿入します。
yuuji@271	1658
yuuji@271	1659 ただしこの機能が働くためには、パッケージ名とその中で定義されているマクロ
yuuji@271	1660 群をalistの形式で変数 @code{YaTeX-package-alist-private} に設定しておく必
yuuji@271	1661 要があります。
yuuji@271	1662
yuuji@271	1663 @node Changing mode of YaTeX, Online help, Usepackage cheker, Top
yuuji@271	1664 @comment node-name, next, previous, up
yuuji@271	1665 @chapter 野鳥の動作モード切り替え
yuuji@271	1666 @cindex モード切り替え[もうときりかえ]
yuuji@271	1667 @cindex prefix w
yuuji@271	1668
yuuji@271	1669 @table @kbd
yuuji@271	1670 @item [prefix] w
yuuji@271	1671 @dots{} 野鳥動作モード切り替えメニュー
yuuji@271	1672 @end table
yuuji@271	1673
yuuji@271	1674 @noindent
yuuji@271	1675 で野鳥自身の動作を決定する以下のモードを切り替えます。
yuuji@271	1676
yuuji@271	1677 @itemize @bullet
yuuji@271	1678 @item 修正モード
yuuji@271	1679 @item 野鳥数式モード
yuuji@271	1680 @end itemize
yuuji@271	1681
yuuji@271	1682 修正モードは、開き括弧入力時の処理をコントロールし、修正モードONの時は開き
yuuji@271	1683 括弧の入力は開き括弧のみの入力になり、修正モードOFFの時は開き括弧の入力だ
yuuji@271	1684 けで閉じ括弧まで入力します。デフォルト(起動時)の設定は@emph{OFF}です。
yuuji@271	1685
yuuji@271	1686 野鳥数式モードは、変数 @code{YaTeX-auto-math-mode} が @code{nil} の時の
yuuji@271	1687 み有効で、このとき@kbd{;}や@kbd{:}を押した時(@ref{Image completion}参照)に、
yuuji@271	1688 どのようなイメージ補完を機能させるか、通常のキーとして機能させるかを手動で
yuuji@271	1689 切り替えます。自動判定が遅いマシンでは@code{YaTeX-auto-math-mode}
yuuji@271	1690 @code{nil}にセットし、野鳥数式モードを手動で切り替えると良いでしょう。
yuuji@271	1691
yuuji@271	1692
yuuji@271	1693 @node Online help, Inclusion hierarchy browser, Changing mode of YaTeX, Top
yuuji@271	1694 @comment node-name, next, previous, up
yuuji@271	1695 @chapter オンラインヘルプ
yuuji@271	1696 @cindex オンラインヘルプ[おんらいんへるふ]
yuuji@271	1697 @cindex apropos
yuuji@271	1698 @cindex キーワード検索[きいわあとけんさく]
yuuji@271	1699 @cindex prefix ?
yuuji@271	1700 @cindex prefix /
yuuji@271	1701
yuuji@271	1702 使おうとする La@TeX{} コマンドの用法がよく分からない時は、オンラインヘル
yuuji@271	1703 プをひきましょう。ヘルプに関するキーには以下のものがあります。
yuuji@271	1704
yuuji@271	1705 @table @kbd
yuuji@271	1706 @item [prefix] ?
yuuji@271	1707 @dots{} オンラインヘルプ
yuuji@271	1708 @item [prefix] /
yuuji@271	1709 @dots{} オンラインapropos
yuuji@271	1710 @end table
yuuji@271	1711
yuuji@271	1712 @section オンラインヘルプ
yuuji@271	1713 @cindex グローバルヘルプ[くろおはるへるふ]
yuuji@271	1714 @cindex プライベートヘルプ[ふらいへえとへるふ]
yuuji@271	1715 @cindex YaTeX-help-file
yuuji@271	1716 @cindex YaTeX-help-file-private
yuuji@271	1717
yuuji@271	1718 「オンラインヘルプ」は、一般的な La@TeX{} コマンド(デフォルトでカーソル
yuuji@271	1719 位置のコマンド)に対する説明を隣のバッファに表示します。この時参照されるヘ
yuuji@271	1720 ルプ用ファイルには「グローバルヘルプ」と「プライベートヘルプ」の二種類があ
yuuji@271	1721 り、前者は La@TeX{} の標準コマンドの主なものの説明を含むファイルで、変数
yuuji@271	1722 @code{YaTeX-help-file}の値で指定されます。このファイルは通常公共の場所(デ
yuuji@271	1723 フォルトで@code{$EMACSEXECPATH})に置かれ、誰もがその内容を更新できるように
yuuji@271	1724 全員に書き込み権が与えられるべきものです。後者は、非標準もしくは個人的なマ
yuuji@271	1725 クロ定義に関する説明が書かれているファイルで、変数
yuuji@271	1726 @code{YaTeX-help-file-private}の値で指定されます。こちらはユーザのホームディ
yuuji@271	1727 レクトリの下などに置かれます。
yuuji@271	1728
yuuji@271	1729 @section オンラインapropos
yuuji@271	1730
yuuji@271	1731 「オンラインapropos」は GNU Emacs の apropos と同様、ユーザが指定したキー
yuuji@271	1732 ワードを説明文に含む項目すべてを隣のバッファに表示します。
yuuji@271	1733
yuuji@271	1734 もし、調べようとしたLa@TeX{}コマンドに対する説明がヘルプファイル中に見つ
yuuji@271	1735 からなかった場合は、説明文の入力を求めてくるので、可能であれば参考書などを
yuuji@271	1736 調べてそのコマンドの説明を入力してください。もし、なにか標準的なコマンドに
yuuji@271	1737 対する説明を書いたならばぜひ私までその説明をお送り下さい。次回の配布に含め
yuuji@271	1738 たいと思います。
yuuji@271	1739
yuuji@271	1740 @node Inclusion hierarchy browser, Cooperation with other packages, Online help, Top
yuuji@271	1741 @comment node-name, next, previous, up
yuuji@271	1742 @chapter インクルード構造ブラウザ
yuuji@271	1743 @cindex インクルード構造[いんくるうとこうそう]
yuuji@271	1744 @cindex prefix d
yuuji@271	1745
yuuji@271	1746 複数のファイルに分割しているドキュメントを書いている場合、
yuuji@271	1747
yuuji@271	1748 @table @kbd
yuuji@271	1749 @item [prefix] d
yuuji@271	1750 @dots{} インクルード構造ブラウズ
yuuji@271	1751 @end table
yuuji@271	1752
yuuji@271	1753 @noindent
yuuji@271	1754 を押すと、そのドキュメントの親ファイルを聞いて来ます。ここで全てのファイル
yuuji@271	1755 の親となるファイル(デフォルトが示されているので大抵はRETのみ)を入力すると
yuuji@271	1756 インクルードしている全てのファイルを解析し、インクルード状況を視覚的に表示
yuuji@271	1757 します。このバッファでは以下のキー操作が有効です。
yuuji@271	1758
yuuji@271	1759 @table @kbd
yuuji@271	1760 @item n
yuuji@271	1761 @dots{} 次の行に移動し対応するファイルを隣のバッファに表示
yuuji@271	1762 @item p
yuuji@271	1763 @dots{} 上の行に移動し対応するファイルを隣のバッファに表示
yuuji@271	1764 @item N
yuuji@271	1765 @dots{} 同じインクルードレベルの次のファイルに移動
yuuji@271	1766 @item P
yuuji@271	1767 @dots{} 同じインクルードレベルの前のファイルに移動
yuuji@271	1768 @item j
yuuji@271	1769 @dots{} 次の行に移動
yuuji@271	1770 @item k
yuuji@271	1771 @dots{} 上の行に移動
yuuji@271	1772 @item u
yuuji@271	1773 @dots{} 一代親にあたるファイルに移動
yuuji@271	1774 @item .
yuuji@271	1775 @dots{} カーソル位置のファイルを隣のバッファに表示
yuuji@271	1776 @item SPC
yuuji@271	1777 @dots{} 隣のバッファの対応ファイルをスクロールアップ
yuuji@271	1778 @item DEL, b
yuuji@271	1779 @dots{} 隣のバッファの対応ファイルをスクロールダウン
yuuji@271	1780 @item <
yuuji@271	1781 @dots{} 隣のバッファの対応ファイルの先頭を表示
yuuji@271	1782 @item >
yuuji@271	1783 @dots{} 隣のバッファの対応ファイルの末尾を表示
yuuji@271	1784 @item '
yuuji@271	1785 @dots{} (@kbd{<}や@kbd{>}の後で)元の表示位置に戻る
yuuji@271	1786 @item RET, g
yuuji@271	1787 @dots{} カーソル位置のファイルを隣のバッファでオープン
yuuji@271	1788 @item mouse-2
yuuji@271	1789 @dots{} RETと同じ(ウィンドウ使用時のみ)
yuuji@271	1790 @item o
yuuji@271	1791 @dots{} 隣のウィンドウに移動
yuuji@271	1792 @item 1
yuuji@271	1793 @dots{} 他のウィンドウを消す
yuuji@271	1794 @item -
yuuji@271	1795 @dots{} ブラウズウィンドウを小さくする
yuuji@271	1796 @item +
yuuji@271	1797 @dots{} ブラウズウィンドウを大きくする
yuuji@271	1798 @item ?
yuuji@271	1799 @dots{} ヘルプ表示
yuuji@271	1800 @item q
yuuji@271	1801 @dots{} 表示前の状態に戻る
yuuji@271	1802 @end table
yuuji@271	1803
yuuji@271	1804 ただし、隣のウィンドウのファイルの内容を表示する機能に関しては、対応する
yuuji@271	1805 ファイルをクローズしてしまうとうまく働きませんのでご注意ください。
yuuji@271	1806
yuuji@271	1807 @node Cooperation with other packages, Customizations, Inclusion hierarchy browser, Top
yuuji@271	1808 @comment node-name, next, previous, up
yuuji@271	1809 @chapter 他パッケージとの連携
yuuji@271	1810 @cindex 他パッケージとの連携[たはつけえしとのれんけい]
yuuji@271	1811
yuuji@271	1812 @section gmhist
yuuji@271	1813 @cindex gmhist
yuuji@271	1814 @cindex コマンドヒストリ[こまんとひすとり]
yuuji@271	1815 @cindex ヒストリ[ひすとり]
yuuji@271	1816
yuuji@271	1817 @file{gmhist.el}と@file{gmhist-mh.el} をロードしている場合、プレヴューコ
yuuji@271	1818 マンドの入力(@kbd{[prefix] tp]})、印刷コマンドの入力(@kbd{[prefix] tl})の
yuuji@271	1819 時に独立したヒストリを利用できます。それぞれのプロンプトで、@kbd{M-p} を押
yuuji@271	1820 すと直前に利用したコマンド文字列をくり返し呼び出すことができます。
yuuji@271	1821
yuuji@271	1822 @section min-out
yuuji@271	1823 @cindex min-out
yuuji@271	1824
yuuji@271	1825 @file{min-out.el} (@code{outline-minor-mode}) と野鳥を組み合わせて使うこ
yuuji@271	1826 とももちろん可能です。設定の方法に関しては@file{yatexm-o.el}をご覧ください。
yuuji@271	1827
yuuji@271	1828 @node Customizations, Etc, Cooperation with other packages, Top
yuuji@271	1829 @comment node-name, next, previous, up
yuuji@271	1830 @chapter カスタマイズ
yuuji@271	1831 @cindex カスタマイズ[かすたまいす]
yuuji@271	1832 @cindex キーアサイン[きいあさいん]
yuuji@271	1833
yuuji@271	1834 野鳥の動作を制御する種々の変数を独自に設定することにより、補完入
yuuji@271	1835 力を起動するキーアサインを変えたり、環境名の補完候補をさらに充実さ
yuuji@271	1836 せることなどができます。
yuuji@271	1837
yuuji@271	1838 @menu
yuuji@271	1839 * Lisp variables:: lisp 変数
yuuji@271	1840 * Add-in functions:: 付加関数(アドイン関数)
yuuji@271	1841 @end menu
yuuji@271	1842
yuuji@271	1843 @node Lisp variables, Add-in functions, Customizations, Customizations
yuuji@271	1844 @comment node-name, next, previous, up
yuuji@271	1845 @section lisp 変数
yuuji@271	1846 @cindex prefixキー変更[prefixきいへんこう]
yuuji@271	1847
yuuji@271	1848 例えば prefix キーを @kbd{C-c} 以外のキーにしたい場合は、
yuuji@271	1849 @code{YaTeX-prefix}に prefix キーにしたいシンボルを定義してください。さら
yuuji@271	1850 に、「@kbd{C-c 英字}」というキーバインドは独自の関数が割り当ててあるので使
yuuji@271	1851 いたくない。このような時は、@code{YaTeX-inhibit-prefix-letter} を @code{t}
yuuji@271	1852 に設定することにより、@kbd{C-c 英字…}のバインドが全て、対応する@kbd{C-c
yuuji@271	1853 C-英字…}に変わります(ただし、begin型 large型補完の大文字起動によるリジョ
yuuji@271	1854 ン指定は可能なままです。これも無効にしたい場合は@code{t}ではなく 1 にセッ
yuuji@271	1855 トして下さい。)。
yuuji@271	1856
yuuji@271	1857 @menu
yuuji@271	1858 * All customizable variables:: カスタマイズ変数一覧
yuuji@271	1859 * Sample definitions:: カスタマイズ変数設定例
yuuji@271	1860 * Hook variables:: hook変数
yuuji@271	1861 * Hook file:: hook用ファイル
yuuji@271	1862 @end menu
yuuji@271	1863
yuuji@271	1864 @node All customizable variables, Sample definitions, Lisp variables, Lisp variables
yuuji@271	1865 @comment node-name, next, previous, up
yuuji@271	1866 @subsection カスタマイズ変数一覧
yuuji@271	1867 @cindex カスタマイズ変数一覧[かすたまいすへんすういちらん]
yuuji@271	1868
yuuji@271	1869 yatex-mode における次の変数がカスタマイズ可能です。@file{~/.emacs} で
yuuji@271	1870 @code{setq} しておけば、そちらの定義が優先されます。括弧の中はデフォルト値
yuuji@271	1871 です。実際に変数の値を変更する場合は @kbd{M-x describe-variable} で
yuuji@271	1872 変数の詳細な説明を参照してください。
yuuji@271	1873
yuuji@271	1874 @defvar YaTeX-prefix
yuuji@271	1875 yatex-mode 中のプリフィクスキー (@kbd{\C-c})
yuuji@271	1876 @end defvar
yuuji@271	1877
yuuji@271	1878 @defvar YaTeX-inhibit-prefix-letter
yuuji@271	1879 prefix キーの直後のキーバインドで @kbd{英字} のものを @kbd{C-英字} に変更
yuuji@271	1880 (@code{nil})
yuuji@271	1881 @end defvar
yuuji@271	1882
yuuji@271	1883 @defvar YaTeX-fill-prefix
yuuji@271	1884 本文を書く時の行頭に挿入する接頭辞すなわち fill-prefix (@code{""(nil)})
yuuji@271	1885 @end defvar
yuuji@271	1886
yuuji@271	1887 @defvar YaTeX-user-completion-table
yuuji@271	1888 学習したLa@TeX{}コマンド保存ファイル名 (@code{"~/.yatexrc"})
yuuji@271	1889 @end defvar
yuuji@271	1890
yuuji@271	1891 @defvar YaTeX-kanji-code
yuuji@271	1892 文書を作成する時の漢字コード
yuuji@271	1893 nil=既存のコードのまま 0=no-conversion 1=Shift JIS,
yuuji@271	1894 2=JIS, 3=EUC, 4=UTF-8 (2 (MS-DOSでは1))
yuuji@271	1895 @end defvar
yuuji@271	1896
yuuji@271	1897 @defvar tex-command
yuuji@271	1898 La@TeX{}タイプセッタコマンド名 (@code{"platex"})
yuuji@271	1899 @end defvar
yuuji@271	1900
yuuji@271	1901 @defvar dvi2-command
yuuji@271	1902 プレヴューアコマンド名 (@code{"xdvi -geo +0+0 -s 4"})
yuuji@271	1903 @end defvar
yuuji@271	1904
yuuji@271	1905 @defvar dviprint-command-format
yuuji@271	1906 dviファイルの印刷に使われるコマンド式 (@code{"dvi2ps %f %t %s \| lpr"})
yuuji@271	1907 @end defvar
yuuji@271	1908
yuuji@271	1909 @defvar dviprint-from-format
yuuji@271	1910 上の@code{%f}に相当する開始ページ指定書式、@code{%b} が開始ページ番号に変
yuuji@271	1911 わる (@code{"-f %b"})
yuuji@271	1912 @end defvar
yuuji@271	1913
yuuji@271	1914 @defvar dviprint-to-format
yuuji@271	1915 @code{%t} に相当する終了ページ指定書式、@code{%e}が終了ページ番号に変わる
yuuji@271	1916 (@code{"-t %e"})
yuuji@271	1917 @end defvar
yuuji@271	1918
yuuji@271	1919 @defvar makeindex-command
yuuji@271	1920 makeindexコマンド (@code{"makeindex"} (MS-DOSでは@code{"makeind"}))
yuuji@271	1921 @end defvar
yuuji@271	1922
yuuji@271	1923 @defvar YaTeX-dvipdf-command
yuuji@271	1924 dviをPDFに変換するコマンド (@code{"dvipdfmx"})
yuuji@271	1925 @end defvar
yuuji@271	1926
yuuji@379	1927 @defvar YaTeX-on-the-fly-preview-interval
yuuji@392	1928 @kbd{[prefix] t e}で環境即時previewをする場合の変換処理までの
yuuji@379	1929 無操作時間(秒) (0.9)
yuuji@379	1930 @code{nil} の場合は即時プレヴューをしない。
yuuji@379	1931 @end defvar
yuuji@379	1932
yuuji@392	1933 @defvar YaTeX-on-the-fly-math-preview-engine
yuuji@392	1934 @kbd{[prefix] t e}で数式環境を即時previewする時に用いるエンジン
yuuji@392	1935 (latex-math-previewが利用可能なときは latex-math-preview-expression を呼ぶ
yuuji@392	1936 @code{'YaTeX-typeset-environment-by-lmp}
yuuji@392	1937 そうでないときは内蔵関数を呼ぶ @code{'YaTeX-typeset-environment-by-builtin})
yuuji@392	1938 @end defvar
yuuji@392	1939
yuuji@336	1940 @defvar YaTeX-cmd-gimp
yuuji@336	1941 GIMPを起動するコマンド (code{"gimp"})
yuuji@336	1942 @end defvar
yuuji@336	1943 @defvar YaTeX-cmd-tgif
yuuji@336	1944 tgifを起動するコマンド (code{"tgif"})
yuuji@336	1945 @end defvar
yuuji@336	1946 @defvar YaTeX-cmd-inkscape
yuuji@336	1947 Inkscapeを起動するコマンド (code{"inkscape"})
yuuji@336	1948 @end defvar
yuuji@336	1949 @defvar YaTeX-cmd-dia
yuuji@336	1950 Diaを起動するコマンド (code{"dia"})
yuuji@336	1951 @end defvar
yuuji@336	1952 @defvar YaTeX-cmd-ooo
yuuji@336	1953 OpenOffice.orgまたはLibreOfficeを起動するコマンド (code{"soffice"})
yuuji@336	1954 @end defvar
yuuji@336	1955 @defvar YaTeX-cmd-gs
yuuji@336	1956 Ghostscriptを起動するコマンド (code{"gs"})
yuuji@336	1957 @end defvar
yuuji@363	1958 @defvar YaTeX-cmd-dvips
yuuji@363	1959 dvipsを起動するコマンド(環境によってはpdvipsなど) (code{"dvips"})
yuuji@363	1960 @end defvar
yuuji@363	1961 @defvar YaTeX-cmd-displayline
yuuji@363	1962 displaylineを起動するコマンド
yuuji@363	1963 (code{"/Applications/Skim.app/Contents/SharedSupport/displayline"})
yuuji@363	1964 @end defvar
yuuji@336	1965 @defvar YaTeX-cmd-edit-ps
yuuji@336	1966 PostScriptファイルを編集するコマンド (変数code{"YaTeX-cmd-gimp"}の値)
yuuji@336	1967 @end defvar
yuuji@336	1968 @defvar YaTeX-cmd-edit-pdf
yuuji@336	1969 PDFファイルを編集するコマンド (変数code{"YaTeX-cmd-ooo"}の値)
yuuji@336	1970 @end defvar
yuuji@336	1971 @defvar YaTeX-cmd-edit-ai
yuuji@336	1972 .aiファイルを編集するコマンド (変数code{"YaTeX-cmd-inkscape"}の値)
yuuji@336	1973 @end defvar
yuuji@336	1974 @defvar YaTeX-cmd-edit-svg
yuuji@336	1975 SVGファイルを編集するコマンド (変数code{"YaTeX-cmd-inkscape"}の値)
yuuji@336	1976 @end defvar
yuuji@336	1977 @defvar YaTeX-cmd-edit-images
yuuji@336	1978 その他画像ファイルを編集するコマンド (変数code{"YaTeX-cmd-gimp"}の値)
yuuji@336	1979 @end defvar
yuuji@336	1980
yuuji@271	1981 @defvar YaTeX-need-nonstop
yuuji@271	1982 @code{\nonstopmode@{@}}を自動的に付加するか (@code{nil})
yuuji@271	1983 @end defvar
yuuji@271	1984
yuuji@271	1985 @defvar latex-warning-regexp
yuuji@271	1986 latexコマンドの出力するウォーニング行の正規表現 (@code{"line.* [0-9]*"})
yuuji@271	1987 @end defvar
yuuji@271	1988
yuuji@271	1989 @defvar latex-error-regexp
yuuji@271	1990 同じくエラー行の正規表現 (@code{"l\\.[1-9][0-9]*"})
yuuji@271	1991 @end defvar
yuuji@271	1992
yuuji@271	1993 @defvar latex-dos-emergency-message
yuuji@271	1994 MS-DOS上で動作する latex コマンドが、エラーにより停止するとき出力するメッ
yuuji@271	1995 セージ (@code{"Emergency stop"})
yuuji@271	1996 @end defvar
yuuji@271	1997
yuuji@271	1998 @defvar latex-message-kanji-code
yuuji@271	1999 タイプセッタの出力するメッセージの漢字コード.タイプセットバッファ
yuuji@271	2000 の出力が化ける時は、これを設定する (2, Nemacsでのみ有効)
yuuji@271	2001 @end defvar
yuuji@271	2002
yuuji@271	2003 @defvar NTT-jTeX
yuuji@271	2004 古いNTT-j@TeX{}使用時のようにインデントした行の先頭と前の行の
yuuji@271	2005 (タイプセット後の)字間が空いてしまうのを嫌う場合は@code{t}にする
yuuji@271	2006 (@code{nil})
yuuji@271	2007 @end defvar
yuuji@271	2008
yuuji@271	2009 @defvar YaTeX-item-regexp
yuuji@271	2010 itemの桁揃えの時に用いる、itemの正規表現 (@code{"\\\$sub\$*item"})
yuuji@271	2011 @end defvar
yuuji@271	2012
yuuji@271	2013 @defvar YaTeX-verb-regexp
yuuji@271	2014 verbコマンドの正規表現。先頭の\\\\はつけない (@code{"verb\\*?\\\|path"})
yuuji@271	2015 @end defvar
yuuji@271	2016
yuuji@271	2017 @defvar YaTeX-nervous
yuuji@271	2018 ローカル辞書を用いる時 @code{t} (@code{t})
yuuji@271	2019 @end defvar
yuuji@271	2020
yuuji@271	2021 @defvar YaTeX-sectioning-regexp
yuuji@271	2022 セクション区切り設定コマンドの正規表現
yuuji@271	2023 (@code{"\$part\\\|chapter\\?\\\|\\(sub\$\$section\\\|paragraph\$\\*?\\)\\b"})
yuuji@271	2024 @end defvar
yuuji@271	2025
yuuji@271	2026 @defvar YaTeX-fill-inhibit-environments
yuuji@271	2027 fill を抑止する環境名のリスト
yuuji@271	2028 (@code{'("tabular" "tabular" "array" "picture" "eqnarray" "eqnarray" "equation" "math" "displaymath" "verbatim" "verbatim*")})
yuuji@271	2029 @end defvar
yuuji@271	2030
yuuji@271	2031 @defvar YaTeX-uncomment-once
yuuji@271	2032 領域uncommentで行頭の複数の@code{%}を全て削除するか (@code{nil})
yuuji@271	2033 @end defvar
yuuji@271	2034
yuuji@271	2035 @defvar YaTeX-close-paren-always
yuuji@271	2036 開き括弧の入力で常に閉じ括弧を入力する (@code{t})
yuuji@271	2037 @end defvar
yuuji@271	2038
yuuji@271	2039 @defvar YaTeX-auto-math-mode
yuuji@271	2040 数式モードの切り替えを自動的に行う (@code{t})
yuuji@271	2041 @end defvar
yuuji@271	2042
yuuji@271	2043 @defvar YaTeX-math-key-list-private
yuuji@271	2044 数式イメージ補完で用いる (プリフィクスキー . 対応補完テーブル) の
yuuji@271	2045 alist (@code{nil})。補完テーブルの書き方については@file{yatexmth.el}を参照。
yuuji@271	2046 @end defvar
yuuji@271	2047
yuuji@271	2048 @defvar YaTeX-default-pop-window-height
yuuji@271	2049 1画面の時にタイプセットバッファを初めて作成する時の高さ。数値で行数、数字
yuuji@271	2050 文字列でEmacsウィンドウに対する百分率 (10)
yuuji@271	2051 @end defvar
yuuji@271	2052
yuuji@271	2053 @defvar YaTeX-help-file
yuuji@271	2054 共用ヘルプファイル (@file{$doc-directory/../../site-lisp/YATEXHLP.jp})
yuuji@271	2055 @end defvar
yuuji@271	2056
yuuji@271	2057 @defvar YaTeX-help-file-private
yuuji@271	2058 個人用ヘルプファイル (@file{"~/YATEXHLP.jp"})
yuuji@271	2059 @end defvar
yuuji@271	2060
yuuji@271	2061 @defvar YaTeX-no-begend-shortcut
yuuji@271	2062 @kbd{[prefix] b ??} のショートカットを使わず、@kbd{[prefix] b} だけで補完
yuuji@271	2063 入力に入る (@code{nil})
yuuji@271	2064 @end defvar
yuuji@271	2065
yuuji@271	2066 @defvar YaTeX-hilit-pattern-adjustment-private
yuuji@271	2067 正規表現とそれにマッチするものの論理的意味をシンボルであらわしたものの
yuuji@271	2068 リスト…のリスト。hilit19 を組み込んでいる時のみ有効。
yuuji@271	2069 詳しくは @code{(assq 'yatex-mode hilit-patterns-alist)}
yuuji@271	2070 した結果と、変数 @code{YaTeX-hilit-pattern-adjustment-default} の値(と場合
yuuji@271	2071 によっては hilit19 のドキュメント)を参照せよ。
yuuji@271	2072 @end defvar
yuuji@271	2073
yuuji@271	2074 @defvar YaTeX-sectioning-level
yuuji@271	2075 LaTeXのセクション単位宣言コマンドとその論理的高さのalist。
yuuji@271	2076 @end defvar
yuuji@271	2077
yuuji@271	2078 @defvar YaTeX-hierarchy-ignore-heading-regexp
yuuji@271	2079 Hierarchy バッファは通常ファイルヘッダとして、LaTeXのセクション宣言コマン
yuuji@271	2080 ドの引数を検索し、それがなければコメント行を探すが、その際にヘッダとしては
yuuji@271	2081 意味を持たないパターンをこの変数に設定する。デフォルトでは RCS ヘッダとモー
yuuji@271	2082 ド指定行(-- xxx --)が設定されている。
yuuji@271	2083 @end defvar
yuuji@271	2084
yuuji@271	2085 @defvar YaTeX-skip-default-reader
yuuji@271	2086 Non-nil に設定するとsection型コマンドの引数入力時、アドイン関数がなければ
yuuji@271	2087 ミニバッファでの読み込みをせずに入力を完了させる (@code{nil})
yuuji@271	2088 @end defvar
yuuji@271	2089
yuuji@271	2090 @defvar YaTeX-create-file-prefix-g
yuuji@271	2091 @code{\include}などで @kbd{prefix g}した時に、ジャンプ先が存在しないファイ
yuuji@271	2092 ルであってもオープンする (@code{nil})
yuuji@271	2093 @end defvar
yuuji@271	2094
yuuji@271	2095 @defvar YaTeX-simple-messages
yuuji@271	2096 各種補完時のメッセージ出力を簡素化する (@code{nil})
yuuji@271	2097 @end defvar
yuuji@271	2098
yuuji@271	2099 @defvar YaTeX-hilit-sectioning-face
yuuji@271	2100 色付けが有効な時の @code{\part} の色
yuuji@271	2101 (@code{'(yellow/dodgerblue yellow/slateblue)})。
yuuji@271	2102 リストの第一要素は @code{hilit-background-mode} が @code{'light} の時の、
yuuji@271	2103 第二要素は @code{'dark} の時の @code{\chapter} の色で、文字色/背景色のよ
yuuji@271	2104 うに指定する。
yuuji@271	2105 @end defvar
yuuji@271	2106
yuuji@271	2107 @defvar YaTeX-hilit-sectioning-attenuation-rate
yuuji@271	2108 色付けが有効な時の、@code{\subparagraph} の色を @code{\chapter} の濃度の何
yuuji@271	2109 %薄くしたものにするか (@code{'(15 40)}) @code{YaTeX-hilit-sectioning-face}
yuuji@271	2110 の項参照。
yuuji@271	2111 @end defvar
yuuji@271	2112
yuuji@271	2113 @defvar YaTeX-use-AMS-LaTeX
yuuji@271	2114 AMS-LaTeX を使用する場合は @code{t} に設定する (@code{nil})
yuuji@271	2115 @end defvar
yuuji@271	2116
yuuji@271	2117 @defvar YaTeX-use-LaTeX2e
yuuji@271	2118 LaTeX2e を使用する場合は @code{t} に設定する (@code{t})
yuuji@271	2119 @end defvar
yuuji@271	2120
yuuji@271	2121 @defvar YaTeX-template-file
yuuji@271	2122 新規ファイル作成時に自動挿入するファイル名 (@code{~/work/template.tex})
yuuji@271	2123 @end defvar
yuuji@271	2124
yuuji@271	2125 @defvar YaTeX-search-file-from-top-directory
yuuji@271	2126 inputするファイルを探すときの基準ディレクトリをmainファイルのあるディレクト
yuuji@271	2127 リにするか (@code{t})
yuuji@271	2128 @end defvar
yuuji@271	2129 @defvar YaTeX-use-font-lock
yuuji@271	2130 ソースの色づけパッケージとして font-lock を利用するかどうか
yuuji@271	2131 (@code{(featurep 'font-lock)})
yuuji@271	2132 @end defvar
yuuji@271	2133
yuuji@271	2134 @defvar YaTeX-use-hilit19
yuuji@271	2135 ソースの色づけパッケージとして hilit19 を利用するかどうか
yuuji@271	2136 (@code{(featurep 'hilit19)})
yuuji@271	2137 @end defvar
yuuji@271	2138
yuuji@271	2139 @defvar YaTeX-use-italic-bold
yuuji@271	2140 italic, boldフォントを野鳥が探すかどうか (Emacs20以降なら@code{t})
yuuji@271	2141 font-lock利用時のみ有効。
yuuji@271	2142 (@code{(featurep 'hilit19)}
yuuji@271	2143 @end defvar
yuuji@271	2144
yuuji@271	2145 @defvar YaTeX-singlecmd-suffix
yuuji@271	2146 全てのmaketitle型コマンドの補完入力直後に挿入する文字列。
yuuji@271	2147 @code{"@{@}"} などがお勧め。
yuuji@271	2148 @end defvar
yuuji@271	2149
yuuji@271	2150 @defvar YaTeX-package-alist-private
yuuji@271	2151 LaTeX2eのパッケージ名とその中に含まれるマクロのリスト。
yuuji@271	2152 適切に設定しておくと本文入力時にマクロを補完入力すると
yuuji@271	2153 そのマクロに必要なパッケージを usepackage するか自動的に検査してくれる。
yuuji@271	2154 していなければ \usepackage を自動追加することもできる。
yuuji@271	2155 リストは
yuuji@271	2156 @lisp
yuuji@271	2157 '((パッケージ名1
yuuji@271	2158 (補完タイプマクロのリスト……)
yuuji@271	2159 (補完タイプマクロのリスト……))
yuuji@271	2160 (パッケージ名2
yuuji@271	2161 (補完タイプマクロのリスト……)
yuuji@271	2162 (補完タイプマクロのリスト……))………)
yuuji@271	2163 @end lisp
yuuji@271	2164 という形式にする。補完タイプは @code{env, section, maketitle} のどれか。
yuuji@271	2165 具体例は変数 @code{YaTeX-package-alist-default}
yuuji@271	2166 の値参照。
yuuji@271	2167 @end defvar
yuuji@271	2168
yuuji@271	2169 @defvar YaTeX-tabular-indentation
yuuji@271	2170 tabular/array 環境で現在行の先頭位置が表の第Nカラムのときは
yuuji@271	2171 標準インデント位置から N*YaTeX-tabular-indentation 桁下げた
yuuji@271	2172 インデントにする。
yuuji@271	2173 @end defvar
yuuji@271	2174
yuuji@271	2175 @defvar YaTeX-noindent-env-regexp
yuuji@271	2176 別の環境内にあっても \begin@{@} が行頭から始まるべき環境名の正規表現。
yuuji@271	2177 verbatim環境などを指定する。
yuuji@271	2178 @end defvar
yuuji@271	2179
yuuji@409	2180 @defvar YaTeX-electric-indent-mode
yuuji@409	2181 Emacs 24.4 で導入された改行時の、自動インデントをどうするか。
yuuji@409	2182 この値がそのまま electric-indent-local-mode に渡される。
yuuji@409	2183 -1でoff。
yuuji@409	2184 @end defvar
yuuji@409	2185
yuuji@271	2186 @defvar YaTeX-ref-default-label-string
yuuji@271	2187 \ref@{@} のラベル補完でラベル未設定のものに自動的に生成する
yuuji@271	2188 ラベル名の書式。strftime(3)関数に似た日付ベースで指定する。
yuuji@271	2189 利用できる書式は以下のとおり。
yuuji@271	2190 %y -> 西暦下二桁, %b -> 月の英名, %m -> 月(1～12)
yuuji@271	2191 %d -> 日, %H -> 時, %M -> 分, %S -> 秒,
yuuji@271	2192 %qx -> アルファベットで26進数化した yymmdd.
yuuji@271	2193 %qX -> アルファベットで26進数化した HHMMSS.
yuuji@271	2194 デフォルトは "%H%M%S_%d%b%y"
yuuji@271	2195 @end defvar
yuuji@271	2196
yuuji@271	2197 @defvar YaTeX-ref-generate-label-function
yuuji@271	2198 \ref@{@}のラベル名自動生成のときに使う関数のシンボル。
yuuji@271	2199 デフォルトは標準の YaTeX::ref-generate-label 関数が割り当ててある。
yuuji@271	2200 引数を2つ取る関数を定義して、この変数にセットするとその関数を呼んだ
yuuji@271	2201 結果をデフォルトのラベル名候補とする。設定例:
yuuji@271	2202 @lisp
yuuji@271	2203 (setq YaTeX-ref-generate-label-function 'my-yatex-generate-label)
yuuji@271	2204 (defun my-yatex-generate-label (command value)
yuuji@271	2205 (and (string= command "caption")
yuuji@271	2206 (re-search-backward "\\\\begin@{\$figure\\\|table\$@}" nil t)
yuuji@271	2207 (setq command (match-string 1)))
yuuji@271	2208 (let ((alist '(("chapter" . "chap")
yuuji@271	2209 ("section" . "sec")
yuuji@271	2210 ("subsection" . "subsec")
yuuji@271	2211 ("figure" . "fig")
yuuji@271	2212 ("table" . "tbl"))))
yuuji@271	2213 (if (setq command (cdr (assoc command alist)))
yuuji@271	2214 (concat command ":" value)
yuuji@271	2215 (YaTeX::ref-generate-label nil nil))))
yuuji@271	2216 @end lisp
yuuji@271	2217 @end defvar
yuuji@271	2218
yuuji@271	2219 @node Sample definitions, Hook variables, All customizable variables, Lisp variables
yuuji@271	2220 @comment node-name, next, previous, up
yuuji@271	2221 @subsection カスタマイズ変数設定例
yuuji@271	2222 @cindex 設定例[せつていれい]
yuuji@271	2223
yuuji@271	2224 たとえば、prefix キーとして@kbd{ESC}を使用し、新たな補完候補を格納するファ
yuuji@271	2225 イルを、@file{~/src/emacs/yatexrc} にし、行頭の prefix をタブ文字一つに変
yuuji@271	2226 えたいときは、
yuuji@271	2227
yuuji@271	2228 @lisp
yuuji@271	2229 (setq YaTeX-prefix "\e"
yuuji@271	2230 YaTeX-user-completion-table "~/src/emacs/yatexrc"
yuuji@271	2231 YaTeX-fill-prefix " ")
yuuji@271	2232 @end lisp
yuuji@271	2233
yuuji@271	2234 @noindent
yuuji@271	2235 を @file{~/.emacs} に加えます。
yuuji@271	2236
yuuji@271	2237 @node Hook variables, Hook file, Sample definitions, Lisp variables
yuuji@271	2238 @comment node-name, next, previous, up
yuuji@271	2239 @subsection hook変数
yuuji@271	2240 @cindex hook変数[hookへんすう]
yuuji@271	2241 @cindex yatex-mode-hook
yuuji@271	2242 @cindex yatex-mode-load-hook
yuuji@271	2243
yuuji@271	2244 また、hook 変数 @code{yatex-mode-hook}, @code{yatex-mode-load-hook} を用
yuuji@271	2245 意しています。すべての yatex-mode のバッファで作用させたいものは、
yuuji@271	2246 @code{yatex-mode-hook} に記述し、@file{yatex.el} をロードする時だけ作用さ
yuuji@271	2247 せたいものは@code{yatex-mode-load-hook} に記述します。例えば、
yuuji@271	2248 @code{outline-minor-mode} を利用する場合、それぞれのバッファで
yuuji@271	2249 @code{outline-minor-mode} を有効にしたいので、@code{yatex-mode-hook} を次
yuuji@271	2250 のように設定します。
yuuji@271	2251
yuuji@271	2252 @lisp
yuuji@271	2253 (setq yatex-mode-hook
yuuji@271	2254 '(lambda () (outline-minor-mode t)))
yuuji@271	2255 @end lisp
yuuji@271	2256
yuuji@271	2257
yuuji@271	2258 逆に、独自のキー定義を行いたい時などは、@code{yatex-mode-load-hook} を利用
yuuji@271	2259 します。例えば、begin 型補完において、 document や、enumerate 以外の環境名
yuuji@271	2260 もショートカットキーで入れたいなどという時は、次のようにします。以下の例は、
yuuji@271	2261 @kbd{[prefix] ba} で @code{\begin@{abstract@}}, @code{\end@{abstract@}} を
yuuji@271	2262 挿入します。
yuuji@271	2263
yuuji@271	2264 @lisp
yuuji@271	2265 (setq yatex-mode-load-hook
yuuji@271	2266 '(lambda() (YaTeX-define-begend-key "ba" "abstract")))
yuuji@271	2267 @end lisp
yuuji@271	2268
yuuji@271	2269 なお、新たなキーの定義には、関数 @code{YaTeX-define-key}
yuuji@271	2270 @code{YaTeX-define-begend-key}を利用するようにしてください。
yuuji@271	2271
yuuji@271	2272 @node Hook file, , Hook variables, Lisp variables
yuuji@271	2273 @comment node-name, next, previous, up
yuuji@271	2274 @subsection hook用ファイル
yuuji@271	2275
yuuji@271	2276 変数 @code{yatex-mode-load-hook} で定義する内容が多い時は、
yuuji@271	2277 @file{yatexhks.el}というファイルを作り、その中に野鳥関連の設定を書く事で、
yuuji@271	2278 初期化の時に自動的にロードします。
yuuji@271	2279
yuuji@271	2280
yuuji@271	2281 @node Add-in functions, , Lisp variables, Customizations
yuuji@271	2282 @comment node-name, next, previous, up
yuuji@271	2283 @section 付加関数(アドイン関数)
yuuji@271	2284
yuuji@271	2285 各種補完時に、環境名やコマンド名に応じたきめ細やかな補完入力機能を実現す
yuuji@271	2286 るための関数を作成することができます。この関数の作成方法や、組み込み方法に
yuuji@271	2287 関しては、@code{yatexadd.doc} をご覧ください。
yuuji@271	2288
yuuji@271	2289 @node Etc, Copying, Customizations, Top
yuuji@271	2290 @comment node-name, next, previous, up
yuuji@271	2291 @chapter その他
yuuji@271	2292
yuuji@271	2293 野鳥の標準の La@TeX{} コマンドの辞書には、作者が頻繁に使うものしか登録さ
yuuji@271	2294 れていません。これは、補完候補に使いそうもないコマンドが存在して、補完した
yuuji@271	2295 いコマンドを出すまでのストローク数を増やしてしまう事を防止するためです。標
yuuji@271	2296 準辞書にないコマンドも、できるだけ補完入力方式を利用し、ユーザ辞書を充実さ
yuuji@271	2297 せることで、あなたの La@TeX{} スタイルにあった野鳥へと育っていくことでしょ
yuuji@271	2298 う。
yuuji@271	2299
yuuji@271	2300 @node Copying, Concept Index, Etc, Top
yuuji@271	2301 @comment node-name, next, previous, up
yuuji@271	2302 @chapter 取り扱い
yuuji@271	2303
yuuji@271	2304 本プログラムはフリーソフトウェアです。本プログラムを使用して生じたいかな
yuuji@271	2305 る結果に対しても作者は責任を負わないこととします。転載等に関しては制限いた
yuuji@271	2306 しません。常識的に扱ってください。また、本プログラムに含まれるコードを利用
yuuji@271	2307 すること、改造することも自由に行なって構いませんが、流用することにより契約
yuuji@271	2308 締結の必要が生じる場合、私はいかなる契約も締結しません。具体的にはGPLへの
yuuji@271	2309 サインはしませんので、GNUに寄贈するものを作っている場合私の作品から取り込
yuuji@271	2310 んだコードを流用すると苦労するかもしれません。いかなるコード流用も拒否しま
yuuji@271	2311 せんが契約締結は辞退します。
yuuji@271	2312
yuuji@271	2313 苦情、希望、バグ報告、感想等は歓迎いたします。
yuuji@271	2314 連絡は yuuji@@yatex.org まで(2004年1月現在)。
yuuji@271	2315 継続的に使用してくださる方はメイリングリスト「fj野鳥の会」に
yuuji@271	2316 是非加入してください。加入方法については本パッケージの @file{docs/qanda}
yuuji@271	2317 ファイルの「その他」の章を御覧ください。
yuuji@271	2318
yuuji@271	2319 仕様は、予告なく確実に(気分次第で)変更されます:-p。
yuuji@271	2320
yuuji@271	2321 @flushright
yuuji@271	2322 広瀬雄二
yuuji@271	2323 @end flushright
yuuji@271	2324
yuuji@271	2325 @node Concept Index, , Copying, Top
yuuji@271	2326 @comment node-name, next, previous, up
yuuji@271	2327 @unnumbered 索引
yuuji@271	2328 @printindex cp
yuuji@271	2329
yuuji@271	2330 @c カスタマイズ変数索引を索引と分離する場合にはコメントアウトを外す!!!
yuuji@271	2331 @c @node Variable Index
yuuji@271	2332 @c @comment node-name, next, previous, up
yuuji@271	2333 @c @unnumbered カスタマイズ変数索引
yuuji@271	2334 @c @printindex vr
yuuji@271	2335
yuuji@271	2336 @contents
yuuji@271	2337
yuuji@271	2338 @bye
yuuji@271	2339
yuuji@271	2340 @c Local Variables:
yuuji@271	2341 @c fill-column: 74
yuuji@271	2342 @c fill-prefix: nil
yuuji@272	2343 @c buffer-file-coding-system: sjis
yuuji@271	2344 @c End:
yuuji@271	2345
yuuji@271	2346 Tag table:
yuuji@271	2347
yuuji@271	2348 End tag table