TeXをAtomで書くための環境構築をMacでやってみる

## はじめに
この投稿は僕の後輩含め、TeXで書きたい人に簡単に環境を構築してもらいたいと思い書きました。
うちの学科ナイズされている部分もあるかと思いますがご了承ください。
あと環境はMacでの構築になるのでWinの人はごめんなさい

- - - -
## TeXって何？
一言で言うと文書整形のためのシステムです
WordやInDesignとかとなにが違うの？というと
* 複雑な数式でもきれいに書ける
* 論文に適している
* Windows、Mac OS X、Linuxなど多くのOSで使える
* フリーソフト
 
TeXは便利ですが、文法を学ぶ必要があるので慣れるまでは少し時間がかかるかもしれません。それだけ覚えれば文書を書くことに集中できるのでとても便利です。（参考文献の引用なども簡単に出来ます。）

- - - -
## 動作環境
* Mac OSX 10.12 (Sierra)　　
* Atom 1.12.6

- - - -
## インストール
### Atomをインストール
AtomはGitHub社が作ったテキストエディタです。
これを使わなくてもできるのですが、まあ何かと便利なエディタなので触っておいて損はないです。
[Atom](https://atom.io/)
こちらのURLからダウンロードします。
![F89CD7A3-A296-4F4F-8C13-28914F06C75F.png](https://qiita-image-store.s3.amazonaws.com/0/55608/2a5ea347-e9a7-1e2e-5150-d0c1a77ff7ff.png "F89CD7A3-A296-4F4F-8C13-28914F06C75F.png")

インストールが終わったらAtomを開きます
#### パッケージをインストール
Atomを開いて上のメニューから
`Atom > Preferences`を開きます
（`command` + `,`でも開けます）

![4E7BA7D4-86F6-49EF-92F5-45235C202B07.png](https://qiita-image-store.s3.amazonaws.com/0/55608/1d2470be-35a8-5d9b-6e20-4c7d7d3b2674.png "4E7BA7D4-86F6-49EF-92F5-45235C202B07.png")

左のメニューのInstallから以下のパッケージをインストールします。
![E76DFA27-5CD4-474F-987F-5CFBD183F74C.png](https://qiita-image-store.s3.amazonaws.com/0/55608/578ab11d-2d0f-2ae4-cf53-cfaae2bb577d.png "E76DFA27-5CD4-474F-987F-5CFBD183F74C.png")


* latex
* language-latex
* pdf-view
↓こちら２つはなくてもいいです

* latexer
* latextools

入れ終わったパッケージは`Packages`を見ればわかります。

### MacTeXのインストール
#### Homebrewをインストールします
HomebrewはMac用のパッケージマネージャーです（ライブラリとか管理できるものくらいに思っていてください）

ターミナルを起動します
![7EABED65-3410-4D10-A2EB-BBE7D7926AEE.png](https://qiita-image-store.s3.amazonaws.com/0/55608/288db86c-9c8f-9abd-91f4-5d5cd20cde2a.png "7EABED65-3410-4D10-A2EB-BBE7D7926AEE.png")

これです

![AE4B099F-CD06-4432-9F0F-1A1FF67A485F.png](https://qiita-image-store.s3.amazonaws.com/0/55608/53c0f525-0128-1525-2473-a5f9254cdd32.png "AE4B099F-CD06-4432-9F0F-1A1FF67A485F.png")
これです。
ターミナルが起動したらこんな感じで入力します。

```bash
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```

![8428D284-F128-4737-9549-317198B2A029.png](https://qiita-image-store.s3.amazonaws.com/0/55608/69c0a38c-8e6f-4072-1578-4edf6f7ad11e.png "8428D284-F128-4737-9549-317198B2A029.png")
↑筆者はターミナルをカスタマイズしてしまっているのでちょっと見た目は違うかもしれません

入力したらエンターを押します。
（パスワードを聞かれたらPCのパスワードを入力してください、パスワードはセキュリティの関係で表示はされませんが、入力できているので大丈夫です。入力後エンターを押します。）
インストールが終わったら
再びターミナルで

```bash
brew tap caskroom/cask
```

と入力し、エンターを押します。
（パスワード聞かれたらまた入力）
### ようやくMacTeXをインストール
再びターミナルで

```bash
brew cask install mactex
```

と入力し、しばらく待ちます
（パスワード聞かれたらまた入力）
これでソフトは準備OKです

### Atomのパッケージの設定
`Atom > Preferences > Packages > latex`を検索します。
![21FA7856-2E6C-4C63-A201-332760F3A824.png](https://qiita-image-store.s3.amazonaws.com/0/55608/53db0ba4-68b8-3777-6941-5f2b81c8646b.png "21FA7856-2E6C-4C63-A201-332760F3A824.png")
このSettingsを押します。
![8CBA8372-9105-4165-99EE-A4BA31776F6C.png](https://qiita-image-store.s3.amazonaws.com/0/55608/c9cb2922-e942-b97d-a4bc-854e395f55f9.png "8CBA8372-9105-4165-99EE-A4BA31776F6C.png")
こんな感じに設定します。（Engineはuplatexで）
※atom-latex 0.42.0以降はBuilderの欄が削除されましたので気になさらず

![FF9FA82A-4F27-4F1F-B8C7-EC794F0AEA72.png](https://qiita-image-store.s3.amazonaws.com/0/55608/e42f3a9b-9376-89be-735e-2363f66cb197.png "FF9FA82A-4F27-4F1F-B8C7-EC794F0AEA72.png")
その下をスクロールすると
吐き出されるPDFについての設定があるのですが、僕はAtomだけでプレビューもしたいので
`Open Result after Successful Build`と
`Open Result in Background`はチェックを外しています。
（Acrobatでリアルタイムにプレビューしたい場合はチェックを入れましょう）

### 実際にプレビューしてみる
任意のディレクトリに`main.tex`を作り、以下をコピペしてみましょう

```main.tex
\documentclass[uplatex]{jsarticle}
\begin{document}
Hello,\LaTeX!
\end{document}
```

この状態で`command`+ `S`を押して保存すると同じディレクトリ内にpdfが生成されるのでそのpdfを選択し、開きます
![44B9C6FF-8207-4AC6-B965-5E8C7DB9113D.png](https://qiita-image-store.s3.amazonaws.com/0/55608/6d5ffea4-b7b8-04f9-eeea-833a2899cbda.png "44B9C6FF-8207-4AC6-B965-5E8C7DB9113D.png")

右にセパレートすると保存するたびに更新が見られるようになります。
![6CDDCB9D-0C08-4D6B-BE54-36FD84442132.png](https://qiita-image-store.s3.amazonaws.com/0/55608/59fe076c-6847-8185-dbca-03ada2417a75.png "6CDDCB9D-0C08-4D6B-BE54-36FD84442132.png")


- - - -
## TeXの書き方（ちょっと触れる）
### *タイトルを出力する*
`\title`…タイトル（文書名）
`\author`…著者名（複数いる場合は \and で区切る）
`\date`…日付
`\maketitle`…上記で指定したタイトルの出力

実際にタイトルを出力するコマンドは \maketitle です．\title，\author，\data は必ず \maketitle の前に記述しておく必要があります．

例）

```latex
\documentclass[uplatex]{jarticle}

% プリアンブル
\title{タイトル}
\author{著者名1 \and 著者名2}
\date{2009/05/24}

\begin{document}
  % タイトルを出力
  \maketitle

  \section{節}
  文章
\end{document}
```

こんな感じで書くことが出来ます。
↓詳しくはこちらで確認してみてください！
[LaTeXコマンド集](http://www.latex-cmd.com/)
- - - -
## 小技集
この章はあったら便利だよー的な小技を入れていきます！

### セクション毎に外部ファイルに分けてあげる
文章量が増えてくるとどんどん縦にスクロールする量が多くなり管理が大変になってきますね。
そこで

```main.tex
\section{hoge}
\subsection{fuga}
\end
```

となっているものを

```main.tex
\input{./hoge.tex}
```

```hoge.tex
\section{hoge}
\subsection{fuga}
\end
```
のように外部ファイルに切り分けてあげることで文章を小出しにすることが可能です。
`./hoge.tex`の部分は`main.tex`からみた相対パスを指定してあげます。

```
folder/
L main.tex
L hoge.tex
```
今回であればこのようなディレクトリになっています。

### コンパイル時に画像を非表示にする
修士論文を書いてるとページ数や画像が膨大になり、ビルドにめちゃくちゃ時間がかかるようになります。画像の体裁は最後に整えればよいので提出直前に表示できれば良いわけです。
main.texの先頭あたりに以下のマクロを貼り付けます

```main.tex
\usepackage{}
.
.
.
\newif\iffigure
\figurefalse
%\figuretrue
%画像を出したい時は\figurefalseをコメントアウトし、\figuretrueのコメントアウトを外します。
```
その後、画像の部分を以下のように`\iffigure`と`\fi`挟んであげます。

```main.tex
\iffigure
  \begin{figure}[h]
    \begin{center}
      \includegraphics[width=0.95\hsize]{./images/tdw_place.jpeg}
      \caption{ほげ}
      \label{fig:hoge}
    \end{center}
  \end{figure}
 \fi
```
これで上の設定を切り替えるだけで画像の表示非表示を切り替えられ、高速でビルドできます！

### 画像や表を記述した場所に出したい

```main.tex
\begin{figure}[h]
    \begin{center}
      \includegraphics[width=0.95\hsize]{./images/tdw_place.jpeg}
      \caption{ほげ}
      \label{fig:hoge}
    \end{center}
  \end{figure}
```
のように`\begin{figure}[h]`と画像を指定するとhereが適用されその場に画像が出るはずですが、うまくいかないときがあります．なので「Here」というパッケージを追加し、記述した場所に図や表を出せるようにしましょう。

```main.tex
\documentclass[uplatex]{jsarticle}
\usepackage{iapaper}
\usepackage[dvipdfmx]{graphicx}
\usepackage{here}
```
main.texの上部に`\usepackage{here}`を指定してあげます。

```main.tex
\begin{figure}[H]
    \begin{center}
      \includegraphics[width=0.95\hsize]{./images/tdw_place.jpeg}
      \caption{ほげ}
      \label{fig:hoge}
    \end{center}
  \end{figure}
```
その後上記の用に小文字の`h`だった部分を大文字の`H`に変えてあげるだけでその場に図や表を出せるようになります。簡単ですね。
- - - -
## 最後に
インストールなどできなかった場合環境なども併記して教えていただけるとありがたいです。
もっといいのあるよ！とかもお願いします！

- - - -
## 参考
[TeX入門](https://www.ja2yka.org/~hosono/teirei/tex/)
[TeX Wiki](https://texwiki.texjp.org/)
[TetsuakiBaba.jp](http://tetsuakibaba.jp/tmu/Grad2016.php)←うちの論文フォーマットです
[画像非表示マクロ](http://blog.livedoor.jp/tmako123-programming/archives/42210596.html)