Mercurial > hgrepos > hgweb.cgi > yatex
changeset 387:04ee01ddb7ab dev
Simplify installation step. Update Q&A.
| author | HIROSE Yuuji <yuuji@gentei.org> |
|---|---|
| date | Tue, 06 Jan 2015 23:22:15 +0900 |
| parents | 8d17b1902bdd |
| children | ad62fb00a393 |
| files | docs/qanda docs/qanda.eng install makefile yatex.new |
| diffstat | 5 files changed, 77 insertions(+), 155 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/qanda Tue Jan 06 23:20:53 2015 +0900 +++ b/docs/qanda Tue Jan 06 23:22:15 2015 +0900 @@ -5,9 +5,8 @@ %% (新項目:・RefTeXは使えますか? + ・bibtexとlatexとかを交互にかけるのが面倒なんですけど ・自分で定義したカウンタを\ref補完でのラベル候補対象として認識させたい - ・font-lock はどうやって使えばいいんでしょ? - ・XEmacsでも色は着きますか? ・{\it }内部では斜体に {\bf }では太字になるという噂を聞いたんですが…) ■インストール関連 @@ -36,38 +35,18 @@ ・まだしたっぱなので Info ディレクトリに書き込む権利がないっすう… - rootにしてもらいましょう。それがだめなときは Mule2 をインストー - ルしてもらいましょう。してくれない時は、ホームディレクトリにイン - ストールして、ほーらディスクの無駄遣いだよ〜んといって脅せば入れ - てくれるはずです。Mule2 なら、~/.emacs に + rootにしてもらいましょう。それがだめなときは以下のようにして個人 + 所有の Info ディレクトリをEmacsに認識させましょう。 (setq Info-default-directory-list (cons "自分のInfoディレクトリ" Info-default-directory-list)) - と書くことで、info を起動した時に個人用のファイルもメニューに加 - わります。それでもMule2をなかなか入れてくれない時は、新しいinfo - ファイルを拾って来るたびに管理者に「入れてくださーい。あ、すみま - せーん毎度。でもMule2なら自分のディレクトリを追加できるんですけ - どねぇ…」を繰り返しましょう。 - ・LaTeXのヘルプファイルがないといわれる。 - Nemacs, Mule1 では $EMACS/etc/, Mule2 では $EMACS/site-lisp/ に - 置かれているとみなすようになっています。もし公共の場所に置く権限 - がない時は、ホームディレクトリの下のどこかに置いて、変数 - YaTeX-help-file にそのファイル名を設定して下さい。 - -・Nemacsで info が読めない。 - - Muleでformatしているので、内部日本語処理の異なるNemacs(または - NemacsベースのDemacs)では(バイト数がずれるため)正しく読むことが - できません。Muleで御覧ください。なお、Texinfoファイルのフォーマッ - トには texinfo-3.1.tar.gz にある Emacs-Lisp ファイルを用いてくだ - さい。 - - また、九州大学の井上さんによると、Info の dir 画面で，M-x - Info-tagify とやると info ファイルのコンバートができるそうです。 + もし公共の場所に置く権限がない時は、ホームディレクトリの下のどこ + かに置いて、変数 YaTeX-help-file にそのファイル名を設定して下さ + い。 ■操作関連 ・間違って変なLaTeXコマンドを学習させてしまった。 @@ -174,20 +153,12 @@ ・直前に入れた \foo{引数だよ} の「引数だよ」をもう一回使いたい。 - gmhist というパッケージを導入しましょう。野鳥は gmhist に対応し - ています。ミニバッファで \foo{???}: と聞かれた時に M-p (ESC p)を + ミニバッファで \foo{???}: と聞かれた時に M-p (ESC p)を 押すと今まで入力した文字の履歴を逆方向にたどって表示します。M-n と押すと順方向にたどります。これらの入力履歴は begin 型補完、 section 型補完、プレヴューア起動、プリントアウトコマンド起動それ ぞれに対し独立に設定されます。 - gmhist は多くの Emacs-Lisp アーカイブサイトに置いてあります。 - ftp.ae.keio.ac.jp:pub/emacs-lisp/util/gmhist.tar.gz - にもあります。 - - ただし、Mule2 以降を用いている場合は、gmhistを用いなくてもミニバッ - ファでのヒストリが使えます。 - ・ref←→label間ジャンプで存在するはずのref/labelにジャンプしない。 C-c g とだけ打つと対応するref/labelの前方検索から始めます。 @@ -216,24 +187,30 @@ ・いつも雛型として使っている template.tex を簡単に入れたい - autoinsert.el (Emacs19/Mule2付属)を使いましょう。もしくは、それ - の機能強化版 auto-insert-tkld を使いましょう。後者は、 - ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/auto-inset-tkld.tar.Z - で入手できます。 + ~/work/template.tex に置きましょう。置き場所を変えたい場合は + (setq YaTeX-template-file "~/hogehoge/fugafuga.tex") + のようにして変更できます。 ・bibtexとlatexとかを交互にかけるのが面倒なんですけど - latexmk というスグレもののツールがあります。これは、.tex, - .bib, .idx などのファイル間の依存関係をドキュメントを走査して調 - べ、自動的に bibtex, makeindex, jlatex などを必要な順序で必要な - 回数起動してくれます。これをインストールし、各ドキュメントの先頭 - に - %#!latexmk + yatex1.76からラベルやbibtexでの文献番号不整合を自動的に検知して、 + 再処理が必要なときは自動的に再起動するようになりました(auto rerun)。 + ほとんどの場合、野鳥の auto rerun で対処できるはずです。ただし、 + 以下で述べるlatexmkを利用する場合は重複処理になるため野鳥の + auto rerun を無効化してください。無効化は + (setq YaTeX-typeset-auto-rerun nil) + します。 - などと書いてタイプセッタとして latexmk を指定すれば複雑な依存関 - 係に悩んだ日々とはおさらばです。なお、latexmk は CTAN サイトの - support/latexmk/ ディレクトリに置いてあります。 - (例えば ftp.kdd.lab.kdd.co.jp:/CTAN/) + 同じ目的のツールに latexmk というツールがあります。これは、.tex, + .bib, .idx などのファイル間の依存関係を調べ、自動的に bibtex, + makeindex, platex などを必要な順序で必要な回数起動してくれます。 + これをインストールし、各ドキュメントの先頭に + + %#!latexmk + + などと書いてタイプセッタとして latexmk を指定することで利用でき + ます。なお、latexmk は CTAN サイトにあります。 + (http://www.ctan.org/pkg/latexmk/) ・タイプセットとプレヴューでキーが違うのが面倒ですね? @@ -413,13 +390,6 @@ ん。光らないだけで実害はないので、気にしないか、あるいは次の Meadow が登場するまで hilit19 を利用して下さい。 -・メニューバーの YaTeX をクリックした時にハングしたかと思うほど遅い。 - - わかりません、Emacs のせいです。我慢してください。二回目からは遅 - くありません。ふつ〜メニューなんか使わないでしょ? サルのようにメ - ニューバーを使う友達に野鳥を勧めてはいけません。言いすぎでした、 - ごめんなさいごめんなさい。 - ・\it をイタリック表示できませんか?(Mule2) まず、普段使用しているサイズの斜体フォントを探します。 @@ -611,7 +581,7 @@ 境に括り入れます。 「じゃあpreviewしてみよっか、でもこの部分だけでいいやね」と いってもっぺんcenter環境全体をマーク(ESC C-@)して - [prefix] % b してcenter環境を %#BEGIN〜%#ENDで括ってから + [prefix] % B してcenter環境を %#BEGIN〜%#ENDで括ってから 領域タイプセットします。[prefix] t r。 「さてpreviewじゃ」 といいつつ [prefix] t p します。 @@ -622,22 +592,23 @@ めます。 「はい、次の行」 と言いながら ESC RET します。また適当に埋めて - 領域タイプセットして xdvi をraiseします。muleに戻りcenter環境 - の外に『この表は重要ネ〜』と書きます。 + 今度は [prefix] t e で隣のバッファに on-the-fly preview を出し、 + 表の中味を書き換えては自動的に隣のpreview画像が書き変わる様を + 眺めます。 + 続いて、center環境の外に『この表は重要ネ〜』と書きます。 「うむ、『重要』にはアンダーラインを引こう」 といって『重要』をリジョン指定して [prefix] S(大文字) で - underline を補完入力し、またpreviewします。 + underline を補完入力し、悩んだふりをして 「やっぱアンダーラインはやめ」と言いながら \underline または { か } にカーソルを合わせて [prefix] k して - \underline{} を消します。またpreviewして、 + \underline{} を消します。さらに悩むふりをして 「やっぱセンタリングは要らんかもしれんなあ…」と言いつつ \end{center} にカーソルを合わせて [prefix] . を押します。 - すると \begin{center}, \end{center} に % がつくのでまた - previewします。 + すると \begin{center}, \end{center} に % がつきます。 「うむ、やっぱりセンタリングはぽいっ」と言って \end{center}の行で [prefix] k をおして begin/end 対を消します。 「さて、ファイルがでかくなって来たので分割するか」と言って - \include{foo} などを補完入力します。 + \include{foo} などを [prefix] s で補完入力します。 「じゃあ foo.tex を作らなきゃ…」と言って [prefix] g します。 foo.tex が勝手に作られるので適当にごちゃごちゃ書いて [prefix] t j でタイプセットします。 @@ -649,7 +620,7 @@ こんな感じですかね。 あとは、イメージ補完、数式モード自動判定、先回りusepackageなんて - のもAUCにはありません。 + のもアドバンテージでしょう。 ・なんで構成ファイルがいまさらSJISなの? だっせー。
--- a/docs/qanda.eng Tue Jan 06 23:20:53 2015 +0900 +++ b/docs/qanda.eng Tue Jan 06 23:22:15 2015 +0900 @@ -32,39 +32,25 @@ *I ain't got the privilege to write in the Info directory... - Get yourself made root. If you can't, have them install Mule2 - and add + Get yourself made root. If you can't, write this: (setq Info-default-directory-list (cons "YOUR INFO DIRECTORY" Info-default-directory-list)) to your ~/.emacs. Now your personal files will be added to the - menu when you invoke info. By the way, Mule1 will not release - memories, so processes will pile up and be heavier on the system - compared to Mule2. Nemacs has already become obsolete by the - developers, so no further comments for usage of Nemacs. Get - yourself Mule2 with flying colors :-) + menu when you invoke info. *Emacs can't find the help file. - - The help file is set to be placed in $EMACS/etc/ for Nemacs, - Mule1 and $EMACS/site-lisp/ for Mule2. If you don't have the - privilege to put them in a public location, copy it to your home - directory and set YaTeX-help-file to that file name. -*I can't read info on Nemacs + If you don't have the privilege to put them in a public + location, copy it to your home directory and set YaTeX-help-file + to that file name. - The info file was formatted on Mule, so it can't be read - correctly on Nemacs (or Demacs based on Nemacs) because the - internal Japanese processing is different. Read it on Mule. - Use the Emacs-Lisp package in texinfo-3.1.tar.gz to format the - Texinfo file. - [Operations] ============ -*I accidentally learned in a wrong LaTeX command. +*I accidentally learned in a wrong LaTeX macro in my dictionary. There should be a line with the wrong command in the .yatexrc file in your home or current directory. Erase or fix that line, @@ -209,19 +195,24 @@ *Is it possible to include personal template file template.tex handily? - Try Emacs-19's standard package `autoinsert.el' please. Or its - upper compatible package auto-insert-tkld might also be good. - You can get auto-insert-tkld via anonymous ftp - ftp://ftp.ae.keio.ac.jp/pub/emacs-lisp/util/ - ftp://archive.cis.ohio-state.edu/pub/gnu/elisp-archive/ + Put your template.tex into your ~/work directory where YaTeX + seeks by default. If you change the location to another place, + set the lisp-variable as below. + (setq YaTeX-template-file "~/other/location/template.tex") *It is bothering for me to determine I should call bibtex or latex... - Why don't you try `latexmk' perl script, which is a TeX specific - tool as `make'? It detects the dependency among the TeX-related - files such as .tex, .bib, and so on, and will execute suitable - commands in a suitable sequence. You can find `latexmk' script - in a directory of supports/latexmk in some CTAN ftp directory. + Since version 1.76, YaTeX automatically call bibtex/latex twice + if needed. In most case, you don't have to repeat to call + typesetter or bibtex. If you use `latexmk' described below, + YaTeX's auto rerun functionality should be disabled by setting + like this: + (setq YaTeX-typeset-auto-rerun nil) + + The `latexmk' perl script, which is a TeX specific tool to + automate generation of LaTeX document. You can find `latexmk' + some CTAN ftp directory. + (eg. http://www.ctan.org/pkg/latexmk/) *Can I inhibit auto-filling against very long <a href="..."> line? @@ -276,12 +267,6 @@ you are thinking of graduating from hilit19, it might be better to keep old setting about it... -*It's sooo slow when I click YaTeX on the menu bar. - - I don't know why. Probably a problem with Emacs-19. You'll - just have to bear with it. It won't be so slow the second time. - Anyway, you probably won't use the menu at all, do you? - *Is there any way of displaying `\it' strings in the italic font? First, you should find the available italic font on your
--- a/install Tue Jan 06 23:20:53 2015 +0900 +++ b/install Tue Jan 06 23:22:15 2015 +0900 @@ -3,30 +3,25 @@ Installation of YaTeX / 野鳥のインストール ****************************************** -Put these expressions into your ~/.emacs -まず ~/.emacsに下の2項目を加えます。 - - (setq auto-mode-alist - (cons (cons "\\.tex$" 'yatex-mode) auto-mode-alist)) - (autoload 'yatex-mode "yatex" "Yet Another LaTeX mode" t) - -Then, add certain path name where you put files of YaTeX to your -load-path. If you want to put them in `~/src/emacs', write -次に野鳥の emacs-lisp ファイル群を置くディレクトリを load-path に加えます。 -たとえば、`~/src/emacs/yatex'に置くのであれば、 - - (setq load-path (cons (expand-file-name "~/src/emacs/yatex") load-path)) - -in your ~/.emacs. -などとします。 - -Then edit makefile and exec the next command. -続いて makefile を編集し、 +First, take a look at makefile to confirm or modify EMACS= and PREFIX= +lines and exec the next command. +このディレクトリにある makefile の EMACS= と PREFIX= の行を確認し、 +必要なら修正した後に以下のコマンドを起動してください。 % make install (or "sudo make install") -でインストールを行ってください。 +Then, type `make show-init' on the shell in this directory as below +and ou will get elisp expressions. Add the expressions to your ~/.emacs. +続いて以下のようにコマンドを起動し、得られた結果出力を ~/.emacs +に足してください。 + + % make show-init + +After copying output from make command to your ~/.emacs, you will be able to +use yatex-mode for *.tex files. +以上で、初期設定は終わりです。 + Without installing to default-dir, you can use yatex by adding the elisp obtained by below to ~/.emacs. @@ -36,36 +31,6 @@ % make show-init2 -If `make install' fails, do as follows; -もし `make install' でうまく行かない時は下記のように手動でインストール -を行ってください。 - -First, copy `*.el' to suitable directory. -最初に、野鳥の emacs-lisp ファイル群を適当なディレクトリにコピーします。 - -Then copy `help/YATEXHLP.eng' to $EMACS/etc directory, which is -displayed by typin `exec-directory C-j' in the *scratch* buffer -(on Emacs19, $exec-directory/../../site-lisp). -つぎに、help/YATEXHLP.jp を Emacs の etc ディレクトリに入れます。 -(*scratch* バッファで「exec-directory C-j」とうって示されるところです - Emacs19以降の場合 doc-directory の ../../site-lisp) - - -Finally, copy `docs/yatexe' and `docs/yahtmle' to Info directory and -append the contents of `dir' in this directory to `dir' of Info directory. -最後に、info ディレクトリに docs/yatexj, docs/yatexe, docs/yahtmlj, -docs/yahtmle をコピーし、info ディレクトリの dir というファイルにこのディ -レクトリの dir ファイルの中身を追加します。 - -Note that when you byte-compile yatex19.el, do it on window system. -This file cannot be compiled on terminal Emacs because it requires -hilit19.el, which cannot be loaded on terminal Emacs. But you don't -have to byte-compile it. -注意: yatex19.el をバイトコンパイルする時はウィンドウシステム上の emacs -で行って下さい。emacs -nw では、hilit19.el がロードできず、正常にコンパ -イルできません。うまくいかない場合はバイトコンパイルしなくて構いません。 - - About yahtml / yahtmlについて *****************************
--- a/makefile Tue Jan 06 23:20:53 2015 +0900 +++ b/makefile Tue Jan 06 23:22:15 2015 +0900 @@ -135,11 +135,12 @@ done show-init: - @printf '%s\n%s\n%s\n%s\n' \ + @printf '%s\n' \ '(setq auto-mode-alist' \ " (cons (cons \"\\.tex$$\" 'yatex-mode) auto-mode-alist))" \ "(autoload 'yatex-mode \"yatex\" \"Yet Another LaTeX mode\" t)" \ - "(add-to-list 'load-path \"${LISPDIR}\")" + "(add-to-list 'load-path \"${LISPDIR}\")" \ + "(setq YaTeX-help-file \"${LISPDIR}/help/YATEXHLP.eng\")" @printf '(setq tex-command "%s")%s\n' \ `CMDS='platex pdflatex ptex2pdf lualatex' DFLT=latex \ make search-cmd`
