LaTeX について調べるにあたって


# LaTeX について調べるにあたって

LaTeX についてパッケージなどを調べるときに，何を参考にすればいいのかを紹介しておきたい．

tips やコマンド等，さまざまな記事がインターネット上にあるが，どれが正しいかなど判断が難しいところも多々ある．最終的な判断材料としてこれらを解決する情報源を提示しておきたい．(動けば正解というのは一部でﾀﾀﾞｼｲと思うけれど．)
また，私が何を見て記事を書いているのかを明らかにしておきたい．

# ○ 書籍

LaTeX2e の入門書と言えば，記述評論社から出ている「LaTeX2e 美文書作成入門」だろう．一通り目を通しておけば，ある程度理解することが出来るはずだ．
→ [TeX・LaTeX ：書籍ジャンル｜技術評論社](https://gihyo.jp/book/genre?s=0709)

大学であれば，図書館や研究室配架に1冊くらいは置いてあるだろう．
また，[TeXの本 - TeX Wiki](https://texwiki.texjp.org/?TeXの本) でより多くの書籍が紹介されている．これらを読むのも有意義だろう．

あとはLeslie Lamport 著の「LaTeX: A Document Preparation System [[Buy at Amazon](https://www.amazon.com/LaTeX-Document-Preparation-System-2nd/dp/0201529831)][^googlepdf]」だろうか．

[^googlepdf]: Google で[[LaTeX: A Document Preparation System pdf](https://www.google.com/search?q=LaTeX%3A+A+Document+Preparation+System+pdf&oq=LaTeX%3A+A+Document+Preparation+System+pdf&aqs=chrome..69i57j69i58.367j0j9&sourceid=chrome&ie=UTF-8)] と検索するとPDF が出てくるとはあまり大声では言えないナ．



# ○ インターネット

インターネットからでも十分に情報を得ることが出来る．
玉石混交なLaTeX に関する文書があるので，非常にインターネットリテラシが問われるように思う．

確実に信じられるページを紹介しておきたい．(さぁて，この記事は信用に値する記事になっているかな．)

## ■ LaTeX のプロジェクトページ

- [LaTeX - A document preparation system](https://www.latex-project.org/)

このプロジェクトページ内にある[LaTeX Documentation](https://www.latex-project.org/help/documentation/) では以下の文書が公開されている．
これを参照していきたい．

※ 直接PDF のリンクを貼っておきますが，バージョン変更に伴ってリンク切れが生じる場合があります．

### ▼ LaTeX ガイド

- [LaTeX2e for authors](https://www.latex-project.org/help/documentation/usrguide.pdf) [PDF]
- [User’s Guide for the amsmath Package (Version 2.1)](http://texdoc.net/texmf-dist/doc/latex-dev/amsmath/amsldoc.pdf) [PDF]
- [Short Math Guide for LaTeX](http://tug.ctan.org/info/short-math-guide/short-math-guide.pdf) [PDF]

全編英文なので，あまり読む気が起きない人もいるのではないだろうか．(当人がそれ)
以下に日本語訳版があるので，そちらから読んでも良いのではないだろうか．

### ▼ LaTeX ガイド 日本語版

[LaTeX Documentation](https://www.latex-project.org/help/documentation/) で紹介されているYukitoshi FUJIMURA 氏が作成した以下の3つの文書がもっとも読みやすいのではないだろうか．この文書は上に上げた3つの文書の日本語訳に対応している．

ただし，以下のようなコメントがなされていることも踏まえて，原文となるガイドを読むこともオススメしておきたい．[^addcomments] ([Japanese translation readme](https://www.latex-project.org/help/documentation/readme_jpn/) より抜粋)

[^addcomments]: ガイド等は英語で発行されるので，日本語訳のガイドは必ず遅れて出てくるか誰も訳さずに出てこないかのいずれかである．極力は最新のものを原文で読んでおきたい．

> これらの日本語訳は、もともとは私的目的で，上記の機関とは無関係につくりました． 内容の正確性については原文を確認してください．

- [著者のためのLaTeX 2e](https://www.latex-project.org/help/documentation/usrguide_jpn.pdf) [PDF]
- [amsmathパッケージユーザガイド (Version 2.1)](https://www.latex-project.org/help/documentation/amsldoc_jpn.pdf) [PDF]
- [はやわかり LaTeX で数式組版](https://www.latex-project.org/help/documentation/short-math-guide_jpn.pdf) [PDF]

また，Koji Aoyama 氏が作成した以下の文書も比較的読みやすいものとなっている．

- [「Short Math Guide for LaTeX」を読んで](http://bm.skr.jp/tex/short-math-guide.pdf) [PDF]

## ■ AMS-LaTeX

- [American Mathematical Society :: Homepage](https://www.ams.org/home/page)
- [AMS-LaTeX](http://www.ams.org/arc/resources/amslatex-about.html)

AMS-LaTeX はアメリカ数学会(America Mathematical Sciety: AMS) によって開発されたパッケージおよびクラスファイルです．([AMS-LaTeX - TeX Wiki](https://texwiki.texjp.org/?AMS-LaTeX) より．)
amsmath やamsthm など頭に"ams" と付くものはアメリカ数学会が作成したものとなっている．


数式モードを利用して数式を作成する場合，amsmath はほぼ必ず使用されるので，これらを参照しても良いだろう．
理系なら呪文のように`\usepackage{amsmath}` としているが，誰が作った何者なのかくらいは知っておいても損はないだろうというお気持ちで紹介している．



## ■ CTAN

[Comprehensive TeX Archive Network: CTAN](https://www.ctan.org/) とは，TeX に関連するファイルやソフトウェアを収集したウェブサイトの集合体．([CTAN - TeX Wiki](https://texwiki.texjp.org/?CTAN) より．)すでに6000近いパッケージが収録されている．(2020/10 現在)
TeX Live をダウンロードするために利用したりする[^mirror]が，ここからパッケージガイド等を参照することが出来る．

[^mirror]: 本当はCTAN から直接ダウンロードするのではなく，[CTAN # mirror-sites - TeX Wiki](https://texwiki.texjp.org/?CTAN#mirror-sites) を参照してミラーリングサイトからダウンロードするのが一般的である．

Google 等で`[CTAN  "package name"]` と検索すれば，CTAN にあるパッケージのページを参照することが出来る．

amsmath に関してはすでにパッケージガイドを紹介しているが，他のパッケージガイドはCTAN から見ていきたい．

**例**
: Google で[[CTAN  mathtools](https://www.google.com/search?q=ctan+mathtools&oq=ctan+mathtools&aqs=chrome..69i57j69i64.4178j0j9&sourceid=chrome&ie=UTF-8)] と検索してみる．

※ CTAN のパッケージガイドは最新のものになっているので，パッケージを更新していない場合にはバージョンが一致しない場合があります．

CTAN からパッケージガイドを参照することが出来るが，TeX Live の場合ではローカルに保存されたパッケージガイドを検索することが出来るので，そちらで探す方が楽だろう．[参照節 # コマンドラインから](#-コマンドラインから)

## ■ TeX Wiki

TeX, LaTeX, PDF, PostScript などに関する情報を提供する，読者参加型ページである．
TeX について基本的な情報がそろっている．この記事のほとんどにはTeX Wiki のページを参照して紹介している．

- [TeX Wiki](https://texwiki.texjp.org/)

個人的にはあまり見ていない[^texwikinoyokunaitokoro]が，ヒントは多い．
また，以下のページは参考になるのではないだろうか．

- [目的別パッケージ簡易リファレンス - TeX Wiki](https://texwiki.texjp.org/?目的別パッケージ簡易リファレンス)

[^texwikinoyokunaitokoro]: たまにリンク切れが目立つページがある.(ブログサイト等で紹介されている記事がブログサイトごと閉鎖されている等)

## ■ 質問箱

**日本**

- [QA: 一般フォーラム](https://oku.edu.mie-u.ac.jp/tex/mod/forum/view.php?id=2)

**海外**

- [TeX - LaTeX Stack Exchange](https://tex.stackexchange.com/)

これらから有意義な答えやヒントを得ることが出来る．
正しいのか正しくないのかあまり分からないので，最終的にはパッケージガイドを参照している．

# ○ コマンドラインから

TeX Live がPC に導入されている場合，以下の方法を用いてローカルに保存されているパッケージガイドをコマンドライン[^commandline]で検索することが出来る．

ちなみに，TeX Live とは TeX のディストリビューションです． TeX の超巨大な集大成ともいえるもので，現在では国際的に最も普及している最新の TeX ディストリビューションです．([TeX Live - TeX Wiki](https://texwiki.texjp.org/?TeX%20Live) より．)

[^commandline]: Windows ではコマンドプロンプト，macOS ではターミナルとか言われるアレ．

以下で紹介する*Texdoc* と*tlmgr* はコマンドラインツールであり，TeX Live を導入している場合に付属されている．

## ■ Texdoc

Texdoc はTeX Live に含まれるドキュメントを検索・閲覧するためのコマンドラインツールです．([Texdoc - TeX Wiki](https://texwiki.texjp.org/?Texdoc) より．)

- [Texdoc - find and view TeX Live documentation](https://tug.org/texdoc/)
- [GitHub - TeX-Live/texdoc: Find and view documentation in TeX Live](https://github.com/TeX-Live/texdoc/)

以下のようにするとCTAN と同様のパッケージガイドを見ることが出来る．


```
$ texdoc <package name>
```

> 以下の記事でより紹介されている．
> [TeX Live ドキュメント案内 - Qiita](https://qiita.com/wtsnjp/items/f8d853cccb9fd95b012c)

例を示しておきたい．

**例 :**

```
$ texdoc short-math-guide
$ texdoc jsarticle
$ texdoc mathtools
```

既定のPDF ビューワによってファイルが開かれる．これによって開かれる~~すべて~~おおよそのドキュメントは英文で構成されている．[^japanesetexdoc]
また，これらのファイルは以下のディレクトリに入っている．このディレクトリにはsty ファイルは入っていない．

[^japanesetexdoc]: jsclasses やBXjscls は日本語向けクラスファイルなので日本語で書かれていたりする．しかし，多くのパッケージでは英語である．

```
~\texlive\2020\texmf-dist\doc\latex
```

よく参照するパッケージガイドがあれば，ショートカットを作成しておくと良いだろう．


## ■ tlmgr

tlmgr はTeX Live のパッケージを管理するためのコマンドラインツールです．([tlmgr - TeX Wiki](https://texwiki.texjp.org/?tlmgr) より．)
tlmgr という名前は，"the native TeX Live Manager" から来ているようです．

- [tlmgr - the native TeX Live Manager](http://www.tug.org/texlive/doc/tlmgr.html)

TeX Live を更新する際にtlmgr を使って更新するが，今回はパッケージのバージョン確認の方法を紹介しておきたい．
パッケージのバージョンを確認したい場合には以下のようにすると良い．

```
tlmgr info <package name>
```

**※ パッケージが見つからない**
: 以下でも紹介されているが，`\usepackage` で使用する名前とインストール時の名前が異なる場合がある．

> [tlmgrの使用例とトラブルシューティング | tm23forest.com](https://tm23forest.com/contents/tlmgr-usage-troubleshooting)

包括的な解決方法は分からない．

# ○ Twitter

日本人でLaTeX に貢献している人がいるので，私が把握している範囲で紹介しておきたい．
個人的な繫がりはないので，こそっとTwitter のリンクを貼っておきます．

[@h_okumura](https://twitter.com/h_okumura)
[@zr_tex8r](https://twitter.com/zr_tex8r)
[@munepixyz](https://twitter.com/munepixyz)
[@aminophen](https://twitter.com/aminophen)
[@wtsnjp](https://twitter.com/wtsnjp)

ともかく，みなさんすごい人です(語彙力)!!
この辺りの人たちを追っていると何となくわかります．

TL を追っているとたまにTeX Live の大きな更新の際にツイートしていただいていたりして，ありがたいです．(最近このようなツイートがあった)
頻繁に雪だるま:snowman:が回っています．寿司も飛びます:sushi:

実際に回っている様子が観測されました！

<blockquote class="twitter-tweet"><p lang="ja" dir="ltr">貼っておきますね☃🍣☺<a href="https://twitter.com/hashtag/TeX?src=hash&amp;ref_src=twsrc%5Etfw">#TeX</a> <a href="https://twitter.com/hashtag/TeXLaTeX?src=hash&amp;ref_src=twsrc%5Etfw">#TeXLaTeX</a> <a href="https://twitter.com/hashtag/%EF%BE%85%EF%BE%9D%EF%BE%84%EF%BD%B6?src=hash&amp;ref_src=twsrc%5Etfw">#ﾅﾝﾄｶ</a> <a href="https://t.co/2jKHYNyz0Y">pic.twitter.com/2jKHYNyz0Y</a></p>&mdash; 某ZR（ざんねん🙃） (@zr_tex8r) <a href="https://twitter.com/zr_tex8r/status/1313114345669226497?ref_src=twsrc%5Etfw">October 5, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

また，某ZR さんにはいくつかの記事にLGTM をしていただいていてすごく嬉しいです．ありがとうございます！

# 余談

書籍に関して私は，一度だけ研究室にあった「LaTeX2e 美文書作成入門」を一通り読んだ程度で，それ以外は読んだことはない．
インターネット上に上げられている情報を得ることが多い．

プロジェクトページにあるガイドやパッケージガイドを読めば，書籍を読まずともおおよそは作成することが出来ると思う．(と言っても，初めてLaTeX を扱う人は「LaTeX2e 美文書作成入門」を一度読んでおくと良いと思う．)

(いまだに線引きはよく分かっていないが)TeX レベルでの編集をすると挙動がよく分からない．正しいのか正しくないのか判断がつかない部分がある．
したがって，LaTeX レベルでの編集を心掛けているし，パッケージガイドに載っている範囲での記事を書くようにしている．

LaTeX レベルと言いつつ，パッケージで出来る範囲での記事であればLaTeX レベルでもないような気もする．
少なくとも，いじったら何がどのように変わるかが説明されている範囲でしか記事にしていない．

LaTeX 関連の記事を書くお気持ちとしては，卒論等の一時期でしかLaTeX を使用せず，tips 程度にしか必要としない場合であれば，動けばそれで良くパッケージガイドを参照している時間はないと思う．
その意味で，パッケージガイドをある程度かみ砕いたような記事を作成しておいた方が後々にそれを読んで役に立ってくれる人が現れるのではないかと期待している．

# 追記

- 2021/05/28 : 乱雑な言葉を軽微修正しました．また，Twitter で雪だるまが回り寿司が飛び交う様子が観測されたので追加しました．