- 追加された行はこの色です。
- 削除された行はこの色です。
*[[Microsoft Windows:http://www.windows.com/]] [#i4bf0c85]
*[[Microsoft Windows:https://www.windows.com/]] での TeX の利用 [#headline]
#ref(http://upload.wikimedia.org/wikipedia/commons/thumb/8/83/Windows_logo_and_wordmark_-_2012.svg/500px-Windows_logo_and_wordmark_-_2012.svg.png,right,around,nolink,Microsoft Windows)
//Windows に TeX をインストールして使えるようになるまでの大まかな流れとしては,[[TeX 入手法>TeX入手法]]で簡単に述べたとおり
//
//+TeX の処理系(“TeX ディストリビューション”)のインストールと設定
//+統合環境またはエディタ,PDF ビューアなどの周辺ツールのインストールと設定
//
//が必要です.
&color(White,#5F2F2F){ ''◆CONTENTS◆'' };&br;
----
#contents
----
*TeX ディストリビューション [#vb660ba1]
Microsoft Windows に TeX をインストールする場合,TeX ディストリビューションの選択肢が複数存在します.~
日本語を扱う場合は,問題点の少なさや日本人ユーザの数,日本語情報の多さなどの理由から,TeX Live または W32TeX を選択されることをお薦めします.~
*インストール[#install]
[[TeX Live/Windows - TeX Wiki>TeX Live/Windows]]を参考にしてTeX Liveをインストールしてください.
-CTAN の豊富なパッケージを使いたい場合は TeX Live
-最新バイナリを使いたい場合は W32TeX
を選択するといいと思います.
**[[W32TeX]] &aname(w32tex); [#yd4deb73]
*TeX を使い始める前に:拡張子の表示 [#extension]
W32TeX のインストールについては [[W32TeX - TeX Wiki>W32TeX]] を参照してください.
// 拡張子表示は書いておいた方がよいかも?
// // というわけなので,表に出すことにします.
**[[TeX Live]] (Win64, Win32) &aname(texlive);&aname(texlive-win64-win32); [#ia336ed2]
TeX を使い始める前に(あるいはインストールする前に),拡張子や隠しファイル,隠しフォルダを表示するように変更しておくと便利かもしれません.
拡張子の表示は,LaTeX 処理の周辺での思いがけない勘違いを予防することに役立ちますし,そのほかにも .jpg や .png といった画像ファイルの違いを普段から意識する助けにもなります.
詳細は[[拡張子の表示(基礎知識)>Microsoft Windows/基礎知識#extension]]を参照してください.
TeX Live に関する詳細は [[TeX Live - TeX Wiki>TeX Live]] を参照してください.
*TeX を使い始める前に:環境変数 Path の確認 [#o4ae5c5c]
***TeX Live のインストール [#ca517ea6]
TeX を使うには環境変数 Path の設定が必要です.
-http://www.tug.org/texlive/quickinstall.html
-http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#installation
-[[TeX Live on Windows:http://www.tug.org/texlive/windows.html]]
環境変数 Path は以下のように確認できます.
>
スタート > 設定 > 「設定の検索」と書かれた入力欄に「環境変数」と入力して検索 > 「環境変数を編集」を選択
<
//-Windows PowerShell の場合
//
// $Env:Path
//
//あるいは
//
// echo %Env:Path
//
//-コマンド プロンプトの場合
//
// path
//
//あるいは
//
// echo %PATH%
[[Installing TeX Live over the Internet:https://www.tug.org/texlive/acquire-netinstall.html]] から install-tl-windows.exe をダウンロード後,ダブルクリックします.
全ユーザーに対してインストールする場合は 右クリック → 管理者として実行 を選択します.
基本的には Next や次へなどを押していればインストールはおわります.相当に時間がかかります.1時間くらいは覚悟してください.[[アラベのPC関連メモ:http://arb-computer.seesaa.net/article/406943877.html]]にはスクリーンショットがあります.
システム環境変数 Path に以下のパスが含まれているか,いま一度確認してください.
// これらが %PATH% にないことにより,
// ptex2pdf.lua が動かない(実際には os.execute())など致命的自体に陥る.
>
%SystemRoot%\system32&br;
%SystemRoot%&br;
<
なお,%SystemRoot%(環境変数 SystemRoot)は,通常 C:\WINDOWS です.
***アップデート [#g130b940]
スタートメニューから TeX Live Manager を起動することで,アップデートが可能です.
*TeX のインストールが成功したかどうかテストする [#test]
Windows PowerShell またはコマンド プロンプトから
tlmgr update --self --all
でも行えます.
インストールされたかのチェックを兼ねて,基本的な使い方を試してみましょう.
ただし,アップデートによってパッケージや設定が変更されて,今まで動いていたものが動かなくなったりすることがあるかもしれません.~
LaTeX ソース編集には統合環境やテキストエディタが必要です.
すでにお気に入りのエディタがある場合は,LaTeX 用のマクロがあるか探してみるとよいでしょう.
特にこだわりのない方は,TeX Live とともにインストールされる [[TeXworks]] がお勧めです.
そのほかのエディタなどについては,この後の[[統合環境やエディタのインストール>Microsoft Windows#editor]]でも紹介しています.
-C:\texlive\2014\tlpkg\backups
以下では,TeXworks をもちいてみます.
TeXworks は
スタートメニューの「TeX Live 2024」→「TeXworks editor」から
起動することができます.
にパッケージのバックアップが保存されます.~
アップデートによって動作しなくなった場合は以前のバージョンに戻してください.~
次の四行を入力してみます.
パッケージは
\documentclass{article}
\begin{document}
Hello World!
\end{document}
- [[tlmgr]] (コマンドライン)
- [[TeX Live Manager]] (GUI)
メニューから「ファイル」→「保存」と選び,適当な場所に保存します.(ツールバーの「保存」ボタンを押すか Ctrl + S を押しても保存されます.)名前は半角英数からなるものならば何でもよいです.拡張子は.texとしてください.
保存後,左上の緑の三角の入ったボタンを押してみてください.「Hello World!」と表示されれば成功です.
で管理できます.~
日本語も試してみましょう.今度は次のようにします.
***extractbb の追加 [#tf06ef9d]
画像などをうめこむ際には,extractbbが自動で実行されるようにしておくと便利です.スタートメニューなどからメモ帳を起動し次のようなファイルを作成してください.(メモ帳ではなくてもテキストエディタならば何でもよいです.)
\documentclass{jlreq}
\begin{document}
こんにちは,\LaTeX
\end{document}
shell_escape_commands = \~
bibtex,pbibtex,jbibtex,repstopdf,epspdf,extractbb,\~
makeindex,mendex,mpost,pmpost,upmpost,kpsewhich
同様にしてみて「こんにちは,LaTeX」と表示されれば成功です.(LaTeX は大文字 A が上がり,大文字 E が下がった「本来の方法」で表示されているはずです.)
以上で LaTeX のインストールは終了です.
また,TeXworks による編集も行えるようになりました.
後は [[LaTeX入門]] などを参照しつつ文書の作成を行ってみてください.
これを C:\texlive\texmf-local\web2c\texmf.cnf として保存します.なお,メモ帳の場合は,保存画面にて「ファイルの種類」を「全てのファイル (*.*)」に変更しておく必要があります.(余計な拡張子 .txt が付加されてしまいます.)
***TeXworksの設定 [#wa1faa7d]
LaTeX 用のエディタとして TeXworks が TeX Live とともにインストールされています.
手軽で便利なエディタですので,特にこだわりのエディタがなければ使ってみてください.
スタートメニューから起動することで動きます.
ただし,日本語用の設定が必要です.[[TeXworks/設定/Windows]]もご覧ください.
** エラー時 [#error]
エラーが起こったからといって,「インストールに失敗した!」と判断するのは早すぎます.打ち込んだものにミスがあるかもしれません.
***トラブル対策 [#w1959e65]
失敗しても,再度実行することで成功することがあります.繰り返してみてください.(ダウンロードされているものがまたダウンロードされることはないので,初回よりは早くなります.)
***「プログラム"***"が見付かりません」というエラー [#error01]
TeX Live をインストールするときにウイルス対策ソフトが原因でインストールできない場合はウイルス対策ソフトを無効にしてから TeX Live をインストールしてください.~
残念ながらインストールに失敗しているでしょう.もう一度インストールを試してみてください.または,インストール後手動で設定した場合は,その際にミスをしているかもしれません.もう一度確認をしてみてください.
-[http://www.baldanders.info/spiegel/log2/000698.shtml TeX Live へようこそ!]
-[http://oku.edu.mie-u.ac.jp/tex/mod/forum/discuss.php?d=1226 「セキュリティソフト」がインストールの障害になっている例]
***LaTeX のエラー [#error02]
以下も参考に.
-[[windowsにtexliveをインストール出来ません:http://oku.edu.mie-u.ac.jp/tex/mod/forum/discuss.php?d=1126]]
-[[インストーラーの初期化に失敗しました。:http://oku.edu.mie-u.ac.jp/tex/mod/forum/discuss.php?d=1124]]
コンパイルでエラーが発生すると,TeXworks 下段の「ログの表示」にエラーに関する情報が表示されます.たとえば
\ddocumentclass{jlreq}
***インストールのやり方などの事例 [#w0a33f0d]
としてしまうと(dが一つ多い)次のように表示されます.
:[[TeX Live(TeX環境)のインストール:http://ryskiwt.blog.fc2.com/blog-entry-28.html]] | 2014-10-14
! Undefined control sequence.
l.1 \ddocumentclass
{jlreq}
:[[Texインストール:http://arb-computer.seesaa.net/article/406943877.html]] | 2014-10-11
「x」または「e」を入力することで,ファイルの編集に戻ることができます.このようにエラーのある箇所が表示されるので,そこを中心に確認してみてください.エラー内容に関しては[[LaTeX のエラーメッセージ]]も参考にしてください.
:[[TeX Live と TeXstudio でサクッと Windows 上に LaTeX 環境を構築:http://yksris.hatenablog.com/entry/2014/10/01/143744]] | 2014-10-01
:[[TeX Live 2014 for Windows:http://www.baldanders.info/spiegel/log2/000730.shtml]] | 2014-09-03
*統合環境やエディタのインストール [#editor]
:[[Windows 8.1 に TeX Live 2014 をインストール:http://qiita.com/ignorant/items/21545cde3c9bbafaa264]] | 2014-08-29
LaTeX での文書作成を支援するための統合環境・エディタが各種開発されています.上記 TeXworks もそのような統合環境の一つです.
これらは,LaTeX のソース中に書かれた特別な命令を色付けしてくれたり,LaTeX によるタイプセットをボタンやショートカットキー一つで実行してくれたりと,便利なものです.
初心者の方はまずは LaTeX 用の統合環境を使用して LaTeX に慣れるのが良いでしょう.
:[[docs/TeX/TeX on Windows - kyogoku42's:http://www.kyogoku.biz/docs/TeX/TeX%20on%20Windows]] | 2014-08-11
エディタ・マクロ・プラグインの種類によって得手不得手があったり不具合が発生したりする場合があります.
問題が発生した場合は別のエディタを使用してください.
人によってエディタの好みは様々なので自分にあったエディタを見つけてください.
TeXworks がよいならばそれでもよいですし,下記のを色々と試してみるのも楽しいかもしれません.
:[[Windows7で,TeX MAKER+TeX LiveでTeXの執筆環境を構築する.:http://qiita.com/ConHumi/items/f0d12ab1ad433591c192]] | 2014-07-31
このほかにも
:[[TeX/Install - PukiWiki:http://glc.l.u-tokyo.ac.jp/pukiwiki/index.php?TeX%2FInstall]] | 2014-06-21
-[[TeX Wiki 内の「TeX 用エディタ」紹介ページ>TeX用エディタ]]
-[[Wikipedia:Comparison_of_TeX_editors]]
-[[LaTeX Editors/IDEs:http://tex.stackexchange.com/questions/339/latex-editors-ides]]
には,Microsoft Windows で使用可能な LaTeX 用の統合環境・エディタが紹介されています.
*[[統合環境・エディタ>TeX用エディタ]] [#e8efca0f]
**フリーソフトウェア(オープンソースソフトウェア) [#editor-free]
LaTeX での文書作成を支援するための統合環境・エディタが各種開発されています.~
すでにお気に入りのエディタがある場合は,LaTeX 用のマクロがあるか探してみるとよいでしょう.
特にこだわりのない方は,TeX Live とともにインストールされる TeXworks がお勧めです.(長らく推奨されていた WinShell よりお勧めです.WinShell に関しては[[古い情報]]もご覧ください.)
// Windows でエディタを選びたいときに,別に
// 「Windows, macOS, Linux で動くか,Windows でしか動かないか」
// なんて不要だと思うので,統合環境か汎用エディタかで分類しなおします.
-[[Wikipedia:Comparison_of_TeX_editors]]
-[[LaTeX Editors/IDEs:http://tex.stackexchange.com/questions/339/latex-editors-ides]]
// ここに並べる統合環境は
// 1. TeX ディストリビューションにバンドルされているもの (TeXworks)
// 2. そうではないが,広く使われていて TeX Wiki にも情報が充実しているもの
// の順のつもり.従来の「アルファベット順」は無意味なので変更.
にも Microsoft Windows で使用可能な LaTeX 用の統合環境・エディタが紹介されています.
-統合環境(TeX, LaTeX に特化した機能を備えています)
--''[[TeXworks]]'' ← TeX Live (windows) に標準で含まれています.
--''[[TeXstudio]]''
--''[[LyX]]''
--[[Texmaker]]
--[[TeXnicCenter]]
**フリーソフトウェア (オープンソースソフトウェア) [#e2433aac]
-汎用エディタ(TeX, LaTeX 用のパッケージが用意されているものがあります)
--[[Visual Studio Code]]
---[[LaTeX>Visual Studio Code/LaTeX]]
--[[Emacs]]
---[[Org mode>Emacs/Org mode]]
---[[TeX mode>Emacs/TeX mode]]
---[[AUCTeX]]
---[[YaTeX]](野鳥)
--[[Vim]]
---[[VimTeX]]
--[[Eclipse]]
---[[TeXlipse]]
--[[gedit]]
--[[Geany]]
--[[Notepad++]]
---[[NppExec]]
---[[jN]]
--[[サクラエディタ]]
---[[Happy]]
***Windows, OS X, Linux [#aa9eced6]
-[[LyX]]
-[[TeXstudio]]
-[[Texmaker]]
-[[TeXworks]]
-[[TexitEasy]]
-[[Eclipse]]
--[[TeXlipse]]
-[[Emacs]]
--[[Org mode>Emacs/Org mode]] + [[YASnippet]]
--[[TeX mode>Emacs/TeX mode]] + [[YASnippet]]
--[[AUCTeX]]
--[[YaTeX]]
-[[Vim]]
--[[tex.vim>Vim/tex.vim]] + ([[vim-latex]] or [[LaTeX Box]]) + [[quickrun]] + [[neocomplete & neosnippet>neocomplete]]
--[[Vim-LaTeX]]
--[[ATP]]
-[[Atom]]
-[[Brackets]]
-[[Light Table]]
-[[gedit]]
-[[Geany]]
*PDF ファイルビューア [#pdfviewer]
***Windows [#p928a24e]
長らく LaTeX ファイルの編集は,dvi によるプレビューがもちいられてきました.
ただ,最近は様々な理由から PDF によるプレビューが推奨されています([[古い情報]]も参考に).
TeXworks, TeXstudio などの統合環境には PDF 用のビューアが組み込まれています.
単独の LaTeX 用 PDF プレビューアとしては
-[[TeXnicCenter]]
-[[Notepad++]]
--[[NppExec]]
--[[jN]]
--[[Python Script]]
-[[サクラエディタ]]
--[[Happy]]
-''[[SumatraPDF]]'':軽量な LaTeX 用の PDF ビューアとして最適で,特にお勧めします.
-[[MuPDF]]:軽量な PDF/XPS ビューア.SumatraPDF などで使われています.
-[[Poppler]]:PDF のレンダリングライブラリ.TeXworks, TeXstudio などで使われています.
*PDF ファイルビューア [#y17ec745]
長らく LaTeX ファイルの編集は,dvi によるプレビューがもちいられてきました.
ただ,最近は様々な理由から PDF によるプレビューが推奨されています.([[古い情報]]も参考に.)
TeXworks には PDF 用のビューアが組み込まれています.
単独の LaTeX 用 PDF プレビューアは [[SumatraPDF]] がお勧めです.
などがあります.
*周辺ツールの利用 [#tools]
**文献管理ツール [#bibtex]
オープンソースの文献管理ツールとして,以下を挙げておきます。
-[[Zotero:https://www.zotero.org/]]
-[[JabRef:http://www.jabref.org/]]
このほかにも
-[[TeX Wiki 内の「BibTeX 関連ツール」紹介ページ>BibTeX関連ツール]]
には,Microsoft Windows で使用可能な文献管理ツールが紹介されています。
*その他の選択肢 [#others]
TeX Live 以外にも Windows で利用可能な TeX ディストリビューションが存在します.
-Cygwin での利用:Windows 上に UNIX のような環境を提供する Cygwin 用にも TeX Live が提供されています.[[Cygwin]] をご覧ください.
-[[MiKTeX]]:主に国外で使われている(と思う)TeX ディストリビューションです.[[MiKTeX]] をご覧ください.
*入出力関連の機能 [#t84cfc3e]
**漢字入出力対応状況 [#effb8e13]
コンソールやファイル名等での漢字(日本語)の入出力の対応状況をまとめました(2023/7/16 現在).
Windowsではコンソールやファイル名でのワイド文字・Unicodeの扱いがLinux系と異なるので,それに対応するため「command_line_encoding」という kpathsearch の変数が導入されました.当初W32TeX上のupTeX系のみでしたが,現在はWindows版TeX Live上でXeTeX系, pdfTeX系にも導入されています.
| コマンド | command_line_encoding | コマンドライン&br;入力 |>| コンソール入力 |>| コンソール出力 | 入出力&br;ファイル名 | special &br;ファイル名 |h
|~|~|~| キーボード | パイプ | スクリーン | パイプ |~|~|h
| p(la)tex.exe -kanji=sjis | (無視される) | CP932 | CP932 | Shift_JIS |CP932 | Shift_JIS | CP932 | Shift_JIS |
| p(la)tex.exe&br;p(la)tex.exe -kanji=utf8 | (無視される) | CP932 | CP932 | UTF-8 | CP932(UTF-8) | UTF-8 | CP932 | Shift_JIS |
| up(la)tex.exe | utf-8 | Unicode | Unicode | UTF-8 | Unicode | UTF-8 | Unicode | UTF-8 |
| xe(la)tex.exe | utf-8 | Unicode | Unicode | UTF-8 | Unicode | UTF-8 | Unicode | UTF-8 |
| dvipdfmx.exe&br;pdf(la)tex.exe | none | CP932 | --- | --- | CP932 | Shift_JIS | CP932 | Shift_JIS |
|~| utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | UTF-8 |
| xdvipdfmx.exe | utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | UTF-8 |
| xbb.exe&br;extractbb.exe | utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | --- |
| dvips.exe | none | CP932 | --- | --- | CP932 | Shift_JIS | CP932 | Shift_JIS |
|~| utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | UTF-8 |
| dvi2tty.exe | none | CP932 | --- | --- | CP932 | Shift_JIS | CP932 | --- |
| dvi2tty.exe -Eu | utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | --- |
| upmendex.exe | (無視される) | Unicode | Unicode | UTF-8 | Unicode | UTF-8 | Unicode | --- |
| dvibook.exe&br;dviconcat.exe&br;dviselect.exe&br;dvitodvi.exe&br;dvidvi.exe | utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | --- |
| bibtex8.exe&br;bibtexu.exe | none | CP932 | --- | --- | CP932 | Shift_JIS | CP932 | --- |
|~| utf-8 | Unicode | --- | --- | Unicode | UTF-8 | Unicode | --- |
| kpsewhich.exe | (-progname= &br;指定先に依存する) | CP932 | CP932 | Shift_JIS | CP932 | Shift_JIS | CP932 | Shift_JIS |
|~|~| Unicode | Unicode | UTF-8 | Unicode | UTF-8 | Unicode | UTF-8 |
| gswin32c.exe&br;gswin64c.exe | --- | Unicode | --- | --- | ??? | ??? | Unicode | --- |
| GSview | --- | ??? | --- | --- | ??? | ??? | CP932 | --- |
この表は,日本語版 Windows におけるものです。
「command_line_encoding」とは,texmf.cnf のオプション設定です.
「コンソール入力」は標準入力 (STDIN) からの入力を指し,「コンソール出力」は標準出力 (STDOUT) や標準エラー出力 (STDERR) への出力を指します.
「special ファイル名」とは,挿入する画像のファイル名など,special 命令によって dvi ファイルに書き込まれるファイル名の文字コードを指します.
「CP932」「Unicode」は文字集合の意味で,「Shift_JIS」「UTF-8」は文字エンコーディングの意味で用いています.
スクリーンが「Unicode」「CP932(UTF-8)」のものは,そのままでも文字化けせずに表示させることができます.
以下はその例です.
C:\work>platex -kanji=utf8 sourcename.tex
C:\work>uplatex sourcename.tex
dvi2tty の場合,コードページを UTF-8 に設定することで,文字化けせずに表示させることができます.
以下はその例です.
C:\work>chcp 65001
C:\work>dvi2tty -Eu sourcename.dvi
あるいは、ページャーを使用しない場合はそのまま,文字化けせずに表示させることができます.
以下はその例です.
C:\work>dvi2tty -Eu -q sourcename.dvi
最新の Windows版 TeX Live の場合は,texmf.cnf に
command_line_encoding = utf-8
と設定するとよいでしょう.
現在の TeX Live における
デフォルトは
command_line_encoding = utf-8
となっています。
最新の TeX Live では dvipdfmx, dvips は command_line_encoding の値によらず,
OS のデフォルト code page (日本語 Windows の場合 CP932) で DVI に名前が書かれて
いるファイルを見つけることができます。
なお,マクロ,パッケージやフォントなどのファイル名は ASCII の範囲にとどめ,漢字(日本語)や他言語の Unicode 文字を使用しないことをお勧めします.
文字エンコーディングの齟齬により,ソフトウェアによっては kpathsea 経由で探し出すことに失敗するケースがあるためです.
また,p(la)tex において special の種類によっては 0x5c を含むファイル名の場合,失敗することがあります.
この場合も ASCII の範囲で使用してください.( → [[KANJI file name in special in dvi (uptex):https://okumuralab.org/tex/mod/forum/discuss.php?d=1210]])