Check Installation of TeX (Windows)

DVIwareとしてのdviout, dvioutにおけるトラブルシューティング, dvioutでのプレゼンテーション

# Windowsにおける
日本語TeX のインストールのチェック

May, 2021

誤りや補足すべき点があればお知らせ下さい --> dviout@tug.org

日本語TeXのパッケージのインストールが正しく行われているかどうかのチェック、あるいは、インストールやパッケージの変更後、うまくTeXが動作しない場合の問題点の見つけ方に関して記します。

TeXを使うためのユーザ・インタフェース（たとえば、WinShell, GuiShell やエディタのマクロ --- 秀丸のTeXMACなど ---）がうまく動作しないときななども含みます。

TeXのシステムは、インタネットからダウンロードしてインストールする（たとえば、角藤氏によるパッケージについてのTeXのインストール手順 参照） ことや、（乙部氏、奥村氏、アスキー出版局などによって書かれた）TeXに関する本に付属の CD-ROM からインストールすることができます。

### --- 次の手順で、簡単なTeXのファイルからdviファイルを作成し、
それが previewer (dviout)で表示できるかどうかテストします。 ---

### 1. ここ をマウスの右ボタンでクリックし、testtex.bat を適当なフォルダ（たとえば、c:\windows\temp）に保存します。

### 2. 保存したフォルダの中にある testtex.bat を実行します。

> アクセサリの中のMS-DOSプロンプト あるいは コマンド プロンプト を起動し、cd コマンドなどを使って保存したフォルダへ移動して testtex.bat を実行します。

> あるいは、デスクトップの マイコンピュータ、またはデスクトップのスタートからたどれるアクセサリの中のエクスプローラ を起動してそのフォルダに移動し、testtex.bat のアイコンをダブルクリックします。

> あるいは、たとえば、そのフォルダ名が c:\windows\temp であったなら、デスクトップの スタート → ファイル名を指定して実行 を選んで、c:\windows\temp\testtex と入力して [Enter] キーを押します。

### 3. testtex.bat 実行中の画面表示に注意しましょう。

testtex.bat を実行すると、以下が表示された時点で画面が止まるので、[Enter] キーを押して進行させます。
ただし、最後は [Enter] か Ctrl+C（その後 Y [Enter]）かを選択してください。

      ----- 1. Check the existence of latex -----
      ----- 2. Check for making a DVI file by tex! -----
      ----- 3. Check the existence of ptex -----
      ----- 4. Check the existence of mktextfm and cmr10.tfm -----
      ----- 5. Check the existence of kpsewhich -----
      ----- 6. Check for making a DVI file by ptex! -----
      ----- 7. Check the existence of gswin32c -----
      ----- 8. Check Environment variables! -----
      ----- 9. END -----
      メモ帳で testtex.txt を見る場合は [Enter] 、終了する場合は Ctrl+C を押します！

このとき、画面にエラーらしいメッセージが出ないかどうか、注意しましょう。
また、上記以外のところで止まった場合も何らかのエラーと考えられますので、そのときのメッセージに注意しましょう。
エラーメッセージが表示された場合は、ここを参照してください。

### 4. testtex.dvi と testtexj.dvi を dviout で表示します（dviout のインストールが完了していない場合は、5. へ）。

testtex.bat の存在するフォルダーに testtex.dvi と testtexj.dvi という２つのファイルが出来ていることを確かめて、 これらが dviout で正しく表示されることをチェックします。

> dviファイルと dviout との関連づけが設定してあれば、testtex.dvi や testtexj.dvi のアイコン のダブルクリックで dviout が起動されて、それらが表示されます。

> dviout を起動して、メニューバーの File → Open からこれらの dvi ファイルを選んで表示することもできます。

dviファイル作成中にエラーが生じなくて、dviout での表示でエラーが生じるときは、以下の 5. のチェックを行いましょう。 問題なければ dviout のパッケージに付属の test_a4x.dvi が正しく表示できるかどうかを調べるとともに、 dvioutにおけるトラブルシューティングを参照してください。

### 5. testtex.txt をチェックします。

testtex.bat のあるフォルダーに生成された testtex.txt を、メモ帳 などのエディタで開いてみます。
TeXが正しくインストールされている場合の testtex.txt の例

#### 5.1. 環境変数 TEXMF, TEXMFMAIN, TEXMFCNF のチェック

- TEXMF=, TEXMFMAIN= の両方が定義されている（すなわち、その右辺が""でない）場合は、設定に誤りがあります。以前設定したものが残っている可能性もありますので、インストールの説明書きなどを見て修正します。

- testtex.txt を最初から見て

  > TeX(Web2C 7.3.7)3.14159
  > .........
  > pTeX(Web2C 7.3.7) p3.0.1 (SJIS), based on TeX 3.14159
  > .........

  のような記述があれば、Web2C のVersion が 7.3.7 であることを示しています。
  Web2C のVersion が 7.3.7（またはそれ以降である場合）や、淺山和典氏によるパッケージのようにレジストリにこれらのデータを記録するものの場合は、これらの環境変数は設定不要なことが考えられます。
  実際、角藤氏のWeb2C 7.3.7(またはそれ以降)に対応するパッケージの通常のインストールでは、これら3つの環境変数は設定不要で、間違った設定があるとエラーになります。
  詳しくは、対応するインストールの説明書きをご覧下さい。

  これらの環境変数が設定されていない場合 --- 角藤氏のWeb2C 7.3.7(またはそれ以降)では、これが基本 --- は、testtex.txtでは

  > TEXMF=""
  > TEXMFMAIN=""
  > TEXMFCNF=""

  となります。

- TEXMF= , TEXMFMAIN= , TEXMFCNF= の右側の文字列はフォルダ名を示しますが、区切り記号は通常の \ でなくて / になっている必要があります。和文文字が入っていないこと、文字の間に空白が混ざっていないこと、存在する正当なフォルダ名であることを確かめます。

さらに、Windows NT/2000/XP の場合も、\autoexec.bat での設定（定義の削除）が必要な場合があるので、それにも注意が必要です。

#### 5.2. その他の環境変数のチェック

- TEMP= やTMP= の右辺の文字列に、和文文字が入っていないこと、文字の間に空白が混ざっていないことを確かめます。 また、右辺の文字列で指定されたフォルダが存在して書き込み可能になっていることを確かめます。複数のフォルダ名を並べて指定してはいけません。

- Ghostscript を使う場合は、GS_LIB= の右辺が、正しく定義されていることを確かめます。

以上のテストで問題なければ、TeXのインストールにおいて基本的な設定が正しく出来ている可能性が高く、ここでのチェックは終わりです。 テストのために作成された全てのファイル（testtex.bat, testtex.txt, testtex,tex, testtex.dvi, testtex.log, testtex.aux, testtexj.tex, testtexj.dvi, testtexj.log, testtexj.log）を消すには、たとえばコマンド・プロンプトから以下のように入力します。

> del testtex*.*

先頭に戻る

## エラーメッセージ

以下に対応するメッセージがあれば、それをクリックしてください。

> コマンドまたはファイル名が違います

> 'latex' は、内部コマンドまたは外部コマンド、
> 操作可能なプログラムまたはバッチ ファイルとして認識されていません。

> 'platex' は、内部コマンドまたは外部コマンド、
> 操作可能なプログラムまたはバッチ ファイルとして認識されていません。

> Cannot find cmr10.mf.

> Failed to find cnffile fmtutil.cnf.

> I can't find the format file `latex.fmt'!

> ! LaTeX Error: File `article.cls' not found.

> I can't find the format file `platex.fmt'!

> ! LaTeX Error: File `jarticle.cls' not found.

> Fatal format file error; I'm stymied

> ****** エラー: 環境変数 TEMP と TMP が共に定義されていない！ ******

> ****** エラー: c:\windows\temp が存在しないか、書き込みが出来ない ******

> ****** エラー：環境変数 TEXMF と TEXMFMAIN の両方が設定されています！ ******

> *** エラー：環境変数 TEXMF/TEXMFMAIN/TEXMF を全て削除する必要があります！ ***

注意：gswin32c にはパスが通っていなくても問題ないことが多いので、

    ----- 7. Check the existence of gswin32c -----

で、コマンドが認識されなくても、エラーではありません。 gswin32c でなくて、mktextfm や kpsewhich で同様なことが起こる場合は、mktextfm.exe や kpsewhich.exe が存在しないか、それらに PATH が設定されていないことが原因です。角藤氏のパッケージでこのようなことが起きたならば、次の項と同様なエラーですので、次の項を参照してください。

### A. コマンドが認識されず、latex や platex が起動しない

latex.exe および platex.exe がどこに存在するか、デスクトップから スタート → 検索 によって検索します。

#### A.1. latex.exe および platex.exe が見つかった

以前使っていたものの残骸などでなく、正しくインストールされたものが見つかった場合、そこにPATH が設定されていないことがエラーの原因です。 インストールの説明書きを読んで環境変数 PATH を設定してください。

#### A.2. latex.exe あるいは platex.exe が見つからなかった

TeX のシステムのインストール（＝展開）に失敗しています。 インストールの説明書きを読んで、再度インストールしてください。以下のような原因が考えられます。

- 説明通りにインストールしていなかった
- インターネットからダウンロードし忘れたパッケージがあった
- インターネットからダウンロードするときに使ったプログラムに問題があった（たとえば、iria などのプログラムを使ってダウンロードすると、ファイル名が変更されたり、内容が変更されてダウンロードされることがあります）。
- CD-ROM などに入っているパッケージを、インストーラを使ってインストールした場合、ハード的な問題やインストーラの不具合などが原因で、インストールに失敗することがあります。 このようなとき、手動でインストールするとうまくいくことがあります。
  それぞれのパッケージのサポートページ（最新情報を得るには、インターネット上がよい） をご覧下さい。

### B. Failed to find cnffile fmtutil.cnf.
! LaTeX Error: File `article.cls' not found.
! LaTeX Error: File `jarticle.cls' not found.
Cannot find cmr10.mf.
I can't find the format file `latex.fmt'!
I can't find the format file `platex.fmt'!

見つからないと言われたファイル fmtutil.cnf あるいは article.cls あるいは jarticle.cls などの存在をデスクトップから スタート → 検索 によってチェックし、結果に応じて、次項の「存在しなかった場合は、...」、 あるいは「存在した場合は、...」以下を参照。

### C. Fatal format file error; I'm stymied

TeX が、LaTeX や pLaTeX のフォーマットファイルを見つけることが出来ない、あるいは、それらが正しい版のものでない、などの理由によってエラーが生じたことを意味しています。
次のようなチェックをしましょう

latex.fmt や platex.fmt が存在するかどうか、デスクトップから スタート → 検索 によって探します。

- 存在しなかった場合は、

インストールし直します。

- 存在した場合は、プログラムから正しく使われるよう設定します。
  特に、２箇所に同じ名前のものが存在した場合は、注意が必要です。

  環境変数 TEXMFMAIN, TEXMFCNF, TEXMF の設定をチェックしましょう。
  これらの設定が正しくないと、正しいフォーマットファイルなどを見つけることが出来ず、このようなエラーが起こることがあります。

  角藤氏のパッケージでWeb2C 7.3.7 またはそれ以降の場合は、これら3つの環境変数を全て未定義にすれば、正しい場所にあるものが使われます。

  環境変数 TEXMFMAIN と TEXMF の両方が定義されている場合は、不要なものを未定義にしてください。
  環境変数 TEXMFMAIN を使うのがより新しいやりかたで、パッケージを新しくして、古い環境変数 TEXMF がそのまま残っていたためエラーになった、というケースが多々あります。

  > これらの環境変数の設定値は testtex.txt に書かれています。

- latex.fmt や platex.fmt が壊れている場合や正しくない版の場合、あるいは存在しない場合、角藤氏のパッケージでは、コマンド（MS-DOS）プロンプトから

  >     fmtutil --byfmt  platex

  とすると、platex.fmt が作成されます。 latex.fmt についても同様です。
  なお、このコマンドを実行したとき

           Failed to find file ....

  などというエラーが出る場合は、環境変数の設定がおかしいか、インストールが不完全かのどちらかが原因と思われます。
先頭に戻る

### TeXのシステムが正しくインストールされている場合の testtex.txt の例

角藤氏のTeXのパッケージ（Web2C 7.5.2, TeX 3.142592, pTeX 3.1.2）と Ghostscript 8.00 を、標準のディレクトリにインストールした場合の例です。

    TeX (Web2C 7.5.2) 3.141592
    kpathsea version 3.5.2
    Copyright (C) 1997-2003 D.E. Knuth.
    Kpathsea is copyright (C) 1997-2003 Free Software Foundation, Inc.
    There is NO warranty.  Redistribution of this software is
    covered by the terms of both the TeX copyright and
    the GNU General Public License.
    For more information about these matters, see the files
    named COPYING and the TeX source.
    Primary author of TeX: D.E. Knuth.
    Kpathsea written by Karl Berry and others.

    - cmr10.tfm -
    c:/usr/local/share/texmf/fonts/tfm/public/cm/cmr10.tfm
    - min10.tfm -
    c:/usr/local/share/texmf/fonts/tfm/ptex/min10.tfm
    - TEXMF -
    C:/usr/local/share/texmf
    - MFINPUTS -
    .;C:/usr/local/share/texmf/metafont//;C:/usr/local/share/texmf/fonts/source//;c:/var/tex/fonts/source//
    - MAKETEX_MODE -
    /
    - PKFONTS -
    .;C:/usr/local/share/texmf/fonts/pk////;c:/var/tex/fonts/pk////;C:/usr/local/share/texmf/fonts/pk/modeless//;c:/var/tex/fonts/pk/modeless//;/pk////;/pk/modeless//
    -----
    pTeX (Web2C 7.5.2) 3.141592-p3.1.2 (SJIS)
    kpathsea version 3.5.2
    Copyright (C) 1997-2003 D.E. Knuth.
    Kpathsea is copyright (C) 1997-2003 Free Software Foundation, Inc.
    There is NO warranty.  Redistribution of this software is
    covered by the terms of both the pTeX copyright and
    the GNU General Public License.
    For more information about these matters, see the files
    named COPYING and the pTeX source.
    Primary author of TeX: D.E. Knuth.
    Kpathsea written by Karl Berry and others.
    -----
    AFPL Ghostscript 8.00 (2002-11-21)
    Copyright (C) 2002 artofcode LLC, Benicia, CA.  All rights reserved.
    Usage: gs [switches] [file1.ps file2.ps ...]
    Most frequently used switches: (you can use # in place of =)
     -dNOPAUSE           no pause after page   | -q       `quiet', fewer messages
     -gx  page size in pixels   | -r  pixels/inch resolution
     -sDEVICE=  select device         | -dBATCH  exit after last file
     -sOutputFile= select output file: - for stdout, |command for pipe,
                                             embed %d or %ld for page #
    Input formats: PostScript PostScriptLevel1 PostScriptLevel2 PostScriptLevel3 PDF
    Available devices:
       display mswindll mswinpr2 epson eps9high eps9mid epsonc ibmpro deskjet
       djet500 laserjet ljetplus ljet2p cdeskjet cdjcolor cdjmono cdj550
       uniprint djet500c declj250 lj250 ijs st800 stcolor bj10e bj200 t4693d2
       t4693d4 t4693d8 tek4696 pcxmono pcxgray pcx16 pcx256 pcx24b pcxcmyk pbm
       pbmraw pgm pgmraw pgnm pgnmraw pkmraw tiffcrle tiffg3 tiffg32d tiffg4
       tifflzw tiffpack bmpmono bmpgray bmp16 bmp256 bmp16m tiff12nc tiff24nc
       psmono bit bitrgb bitcmyk pngmono pnggray png16 png256 png16m jpeg
       jpeggray pdfwrite pswrite epswrite pxlmono pxlcolor bbox ljet3 ljet3d
       ljet4 ljet4d pj pjxl pjxl300 jetp3852 r4081 lbp8 m8510 necp6 bjc600
       bjc800 pnm pnmraw ppm ppmraw spotrgb spotcmyk devicen bmpsep1 bmpsep8
       bmp32b psdcmyk psdrgb nullpage
    Search path:
       . ; c:/gs/gs8.00/lib ; c:/gs/gs8.00/kanji ; c:/gs/fonts ;
       c:/gs/gs8.00/lib ; c:/gs/gs8.00/kanji ; c:/gs/fonts
    For more information, see c:/gs/gs8.00/doc/Use.htm.
    Report bugs to bug-gs@ghostscript.com, using the form in Bug-form.htm.
    -----
    TEXMF=""
    TEXMFMAIN=""
    TEXMFCNF=""
    TEMP="C:\WINDOWS\TEMP"
    TMP="C:\WINDOWS\TEMP"
    GS_LIB="c:/gs/gs8.00/lib;c:/gs/gs8.00/kanji;c:/gs/fonts"
    PATH="C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;c:\usr\local\bin;c:\gs\gs8.00\bin;c:\dviout"

先頭に戻る

以上です。 dviout@tug.org