ドキュメントへのアクセス方法とヘルプの求め方
このレッスンではLaTeX関連のソフトウェアやパッケージのドキュメントにアクセスする主要な方法を紹介します。さらに問題が発生した場合に、どのようにヘルプを求めればいいかも見ていきます。
パッケージや文書クラスのドキュメントにアクセスする方法はいくつかあります。
texdoc
TeXディストリビューション（TeX LiveやMiKTeX）をドキュメント込みでインストールしている場合、texdocというコマンドラインツールを使用してローカルに保存されたドキュメントにアクセスすることができます。
texdoc 〈パッケージ名〉
を実行すると〈パッケージ名〉に対応するドキュメントが開きます。このツールは利用可能なドキュメントを検索し、検索ワードに最も関連性が高いと判断したものを開きます。また次のようにすることで、見つかった利用可能なドキュメントを一覧表示させることもできます：
texdoc -l 〈パッケージ名〉
texdoc.org
texdocコマンドと同様の機能を提供するウェブサイトもあります。このサイトでは、ちょうどtexdoc -lのようにドキュメントを検索して選択肢の中から好みのものを選んで閲覧することができます。
CTAN
CTAN（Comprehensive TeX Archive Network）はTeX関連の成果物を集積するネットワークです。ほとんどのLaTeXパッケージはここに登録されています。このサイトでパッケージを検索してドキュメントを閲覧することも可能です。一般にパッケージはctan.org/pkg/〈パッケージ名〉という位置に保存されているので、そこにアクセスするとREADMEをはじめCTANにアップロードされているドキュメントを見ることができます。
LaTeXに関する書籍（英語）
LaTeXについてもっと詳しく学ぶのに役立つ本は数多く出版されています。LaTeX初心者の場合は、初心者向けに構成された入門書を読むのがよいでしょう。そうした本には、このチュートリアルよりもさらに詳しい解説が載っているはずです。以下では、具体的に文献を紹介していきます。
LaTeX 開発チームは書籍のリストを公開しています。このリストに載っている本の多くはLaTeXチームのメンバーによって執筆されたものです。最も重要なものは Lamportの公式ガイドと網羅的な解説書である『LaTeXコンパニオン』です。
その他のLaTeX学習本には次のようなものがあります。
- Helmut Kopka、Patrick Daly著 Guide to LaTeX：電子書籍
- Nicola Talbot著 LaTeX for Complete Novices：無償の電子書籍、廉価の紙書籍
- Nicola Talbot著 Using LaTeX to write a PhD thesis：無償の電子書籍、廉価の紙書籍
- Stefan Kottwitz著 LaTeX Beginner’s Guide：電子書籍、紙書籍
- Marc van Dongen著 LaTeX and Friends：電子書籍、紙書籍
LaTeXに関する書籍（日本語）
日本語のLaTeX学習本には次のようなものがあります。
- 奥村晴彦、黒木祐介 著 『LaTeX美文書作成入門』：電子書籍、紙書籍
- 吉永徹美 著 『独習LaTeX2e』：紙書籍
- 水谷正大 著 『LaTeX超入門 ゼロからはじめる理系の文書作成術』：電子書籍、紙書籍
- 坂東慶太 著 『インストールいらずのLaTeX入門 ― Overleafで手軽に文書作成』：紙書籍
ヘルプを求める
LaTeXに関する質問をすることができるオンラインフォーラムはたくさんあります。現在最も人気の高いQAサイトはおそらく以下の通りです。
こうした場所で質問をする場合は常に、再現手順を明確にすることが最重要です。つまり、いわゆる最小再現コード例（Minimal Working Example；MWE）を作ることが大事です。これは問題を自己解決する必要はありませんが（それができるなら質問しないですよね）、できる限り明確で、自己完結していて、最小のコード例を作りましょう。言い換えると、問題を再現するのに最低限必要なもののみに絞り込むということです。
MWEの作り方
ではどうすればMWEを作ることができるのでしょうか？ 基本的には、まず次のような文書を作成します。
\documentclass{article}
\begin{document}
Text
\end{document}
そして、困っている問題が発生するまで一行ずつコードを追加していきます。もちろん実際に作成しているファイルから「切り落とす」ことで MWE を作成することもできますが、手順が長くなるかもしれません。
改ページやその他の影響を与えるために、より長いテキストが必要になる場合もあります。そのような場合はlipsumパッケージ（日本語のテキストが必要な場合はbxjalipsumパッケージ）を使用すると、ダミーの段落を生成することができるのでテストファイルを簡潔に保つのに役立つでしょう。
ログファイル
またログファイルを見ることも重要です。これはLaTeXを実行する度に作成されるもので、作成している文書ソースのファイル名と同一の名前で拡張子.logを持っています。
デスクトップ環境によっては「拡張子を表示する」のようなオプションを使用しないとどのファイルかわからないかもしれません。
ログファイルの中には、常にフルのエラーメッセージが書かれています。LaTeXのエラーメッセージはなるべくわかりやすくなるようにと努力がなされていますが、一般のワープロのようにはいきません。
エディタによってはエラーの「フル」テキストの閲覧を難しくするものもあります。そのような場合、重要な情報が隠されてしまっている可能性があります。
何か問題が発生した場合、経験豊富なLaTeXユーザはしばしばログファイルを添付して欲しいとお願いをします。
さらに学ぶ
これで本チュートリアルのメインレッスンは終わりです。付録レッスンでは日本語独自の話題などを取り上げていますので、興味のある方は確認してみてください。