LaTeX スタートアップ

はじめに †

このページでは、LaTeX に初めて触れる皆さんにお届けするトピックをまとめています。

LaTeX とは †

そもそも LaTeX とはなにか、というところから疑問の方もいると思います。 そこで、とりあえずLaTeXで文章を書く上で必要となる点だけをまとめてみます。

• LaTeX（ラテフまたはラテック）とは組版ソフト「TeX(テフまたはテック)」のマクロパッケージ。
• プログラムを書くノリでテキストを編集(構造化文章を作成)し、コンパイルして文書を作る。
• テンプレートが用意されているのでそんなに難しいことを覚える必要はない。
• ソースファイル(*.tex)をコンパイルすると dvi という形式のファイルや、中間ファイルが生成される。
• 最終的にはこの dvi 形式からおなじみの pdf に変換し、印刷や提出を行う。

以上のような流れになります。 この LaTeX を使ってもらうために必要な作業は、

• LaTeX の環境をセットアップ
• テキストエディタを LaTeX 用にカスタマイズ
• テンプレートをコンパイルしてみる

という流れになります。

LaTeX のセットアップ †

研究室のデスクトップPCにも、LaTeXのセットアップが必要です。

まずは環境のセットアップですが、 LaTeX のセットアップは「TeXLive」と呼ばれるパッケージを利用します。

TeXLive https://www.tug.org/texlive/

1. 事前に、6G程度ディスクを空けておくこと。
2. 「download」のリンクから、install-tl.zip を取得する。 install-tl-windows.exe を実行するように解説しているWebページもあるが、 exe だとインストールがうまくいかないことがあるようなので、ここでは推奨しない。
3. 展開後、install-tl-windows.bat を実行する。 その際、環境変数を自動で追加するため、必ず管理者権限のユーザで行うこと。
4. 「規定リポジトリを変更」にチェックを入れて「次へ」をクリックする。
5. 「リポジトリデータベースが組み込まれるまでお待ち下さい。」が出たらしばらく待つ。 5分くらい経っても画面が変わらないようなら、 接続に失敗している模様なのでインストーラーを終了してもう一度やりなおす。
6. インストールする場所が C ドライブで良いならそのまま、 D ドライブ等に変更したければインストールパスを変更する。
7. 「TeXworksをインストール」のチェックを外しておく。(このページではTeXworksの利用を前提としないが、利用したければチェックをいれててもよい。)
8. 後は流れに任せて画面をクリックしていけばインストールが開始される。
9. インストーラーを実行してしばらくすると数千個のパッケージのインストールが始まるが、 そのときの「time/total」の横に「01:02/44:15」というような数字が表示される。 この分母の側の時間がインストール完了予測時間となるが、これが1時間半以上かかるようであれば かなり遅いサーバーに接続してしまった可能性が高いので、一度中断して最初からやり直した方が手っ取り早い。
10. なお、インストールを途中で中止した場合、 最初からやりなおしになってしまうので、 インストール作業は時間に余裕があるときに行うこと。

エディタの設定 (VSCode の場合) †

LaTeX で扱う tex ファイルは単なるテキストファイルなので、 エディタはメモ帳でもなんでも良いのですが、 この Wiki では便利に利用できるエディタとして「VSCode」を紹介します。 VSCode は Windows 版だけでなく MacOSX 版や Linux 版もあります。

インストール †

以下の URL からインストーラーをダウンロードして実行して下さい。

https://code.visualstudio.com/download

パッケージのインストール †

まずは、日本語メニューをインストールします。以下の手順に従って下さい。

1. 「File」→「Preferences」→「Extensions」を選ぶ。(または、左側のアイコンのうち正方形4個のアイコンを選択する。
2. 検索テキストボックスに「Japanese」と入力する。
3. 検索結果の中にある「Japanese Language Pack for Visual Studio Code」の欄にある「Install」をクリックする。
4. 直後に出てくるダイアログ中にある「Change Language and Restart」をクリックする。

メニューを日本語化したら、同じような手順で「LaTeX」で検索し、「LaTeX Workshop」をインストールしてください。

論文用テンプレートファイルのコンパイル †

論文用テンプレートファイルをコンパイルしてみましょう。 まずは、研究室のサーバーから必要なファイルをダウンロードしましょう。

LaTeX資料集 https://gamescience.jp/GS_LaTeX/index.html

解凍すると、色々ファイルが出てきます。 最も重要なのは、main.tex または「*_Main.tex」という名称のファイルです。

この main.texを VSCode で開いてみましょう。 「\コマンド{引数}」のように色々書いてあるファイルだと思います。

このままコンパイルしてみましょう。 VSCode の左側に並んでいるアイコンのうち、「TeX」と書かれているものを選択します。 すると、LaTeXソースの左側にダイアログが表示されますので、その中の「Build LaTeX project」 をクリックします。しばらく経ってから「View LaTeX PDF」を選択すれば、 LaTeX ソースコードから生成された PDF を閲覧できます。

ほら、何かもう大層な論文を書いた気分に浸れませんか？ 論文全体を表示するとやや文字がかすれて見えますが、 Ctrlキーを押しながらホイールを上下することで拡大縮小ができます。 拡大すると、様々な文字が実際はかなり綺麗なフォントで表記されていることがわかります。

Build がうまくいかなかった場合、 VSCode の右下の方に「Recipe terminated with error.」という文字列が表示されます。 そこをクリックするとエラーメッセージが表示されますので、 これを見て改めて編集しなおします。 このエラーメッセージは今時の開発環境と比較するとかなり見づらいので、 慣れが必要です。

書き始めるにあたって †

中間報告書の場合 †

中間報告書では、main.tex に本文を記述していきます。

サンプルをよく読みながら、手始めに論文のタイトルや学籍番号、 氏名を自分のものに変更してコンパイルしてみましょう。

編集した main.tex を保存して、Build を実行するだけです。

main.pdfを開いて反映されたか確認してみましょう。

あとは、先輩の中間報告書などを参考に書き進めましょう。

LaTeXのコマンドなどが分からなかったら、 LaTeX Tips＆FAQ を読んでみてください。

卒業論文の場合 †

では、テンプレートファイルのコンパイルから先に進むにはどうするかを説明します。 本文そのものは、main.tex とは別のファイルに記述していきます。 M01xxyyy\_main.tex の中に、

% ここから本文ファイルを挿入

% \input{chap1}
% \input{chap2}
% \input{chap3}

という欄があると思います。 行頭の % はコメントアウト(C++/Java の // に相当)になっていて、 メモ書きやボツ文章を残しておくのに使えます。

で、別ファイルに記述した文書は、こうやって input 文で挿入するわけです。 自分が追加したファイルに応じて、コメントを解除するなり、自分で input 文を追加するなりしてください。

肝心の中身ファイルの書き方ですが、これはもう、世の資料などを参照してもらうしかありません。 全部書くくらいなら私は LaTeX の本を出せてしまいます。 とりあえず最低限は、そのファイルで書く章の名前を、

\chapter{はじめに}

のように最初に入れておくくらいです。後は Try & Error でがんばりましょう。