Atom Flight Manual（Atom Editorのチュートリアル）をざっと訳してみるテストw(2)

## [訳注] この文章について

本文章はAtom Flight Manual ( http://flight-manual.atom.io/ ) の日本語抄訳です。
配布条件はCC SA BY で、Atom Flight Manualに準じます。
全てを翻訳するつもりはなくて、最初から、できるところまでを対象にしたいと思っています。
Atom Flight Manual自体はAsciiDocという形式で管理されており、これらの成果物はGitHubで公開されてはいますが日本の皆さんの便宜を図るためその土台である日本語文章翻訳に集中し、まずはMarkDownでフライトマニュアルを提供したいと思います。

この翻訳はきむりん(@kimrin)が暫定的にゲリラ的に訳した文章で、
将来より良い形でAtom Flight Manualに取り込まれることを望んでいます。

かなり意訳が入っていますが、どうぞよろしくお願い致します。

## Atomのインストール

`Atom`を使い始めるにあたって、`Atom`を自分のシステムにインストールする必要があります。このセクションでは`Atom`の`Mac`,`Windows`,`Linux`でのインストールを述べるとともに、
どのようにしてソースコードからビルドすればいいかの基礎についても触れます。

`Atom`のインストールは上記の三つのシステムではとても簡単です。
普通は単純に https://atom.io に行けばページのトップに図１にあるようにダウンロードボタンが出てきます。

![linux-downloads.png](https://qiita-image-store.s3.amazonaws.com/0/61379/19579fa0-4d10-ce40-9011-0f6a312a0625.png "図１：atom.ioのダウンロードボタン")
図１：atom.ioのダウンロードボタン

ボタンはプラットフォームに合わせられているはずで簡単にインストール可能なはずです。しかしながら、もう少し詳しくここでは見ていくことにしましょう。

### Mac版Atom

`Atom`はもともと`Mac`用にビルドされていました、そしてセットアップの過程はシンプルでした。`atom.io`サイトのダウンロードボタンを押下するかAtomリリースページ：

https://github.com/atom/atom/releases/latest

に行けば`atom-mac.zip`ファイルを明示的にダウンロードできます。

そのファイルを取得すればしめたもので、そのファイルをクリックすればバイナリを展開できます。そのあと`Atom`アプリケーションアイコンをあなたの`Applications`フォルダーにドラックしてください。

最初に`Atom`を開いたとき、`Atom`は端末上で使用される`atom`コマンドと`apm`コマンドのインストールを試みます。幾つかのケースにおいて管理者パスワードを必要とするためそれらのコマンドをインストールできないことがあります。`Atom`が`atom`コマンドをインストールできたかは、例えば端末ウィンドウを開いて`which atom`とタイプすればわかります。もし`atom`コマンドがインストールされていれば、こんなメッセージが出るでしょう。

```
$ which atom
/usr/local/bin/atom
$
```

もし`atom`コマンドがインストールされていなければ、`which`コマンドは何も返しません。

```
$ which atom
$
```

`atom`コマンドと`apm`コマンドをインストールするためには、"Window: Install Shell Commands" を`Command Palette`から実行します。その時管理者パスワードを聞いてくるでしょう。

### Windows版Atom

`Atom`の`Windows`インストーラーは https://atom.io か、
 [Atom Releases](https://github.com/atom/atom/releases/latest)の`AtomSetup.exe`という名前のファイルとしてダウンロードできます。

このインストーラーは`Atom`をインストールし、`atom`コマンドと`apm`コマンドを`PATH`環境変数に追加し、ショートカットをデスクトップとスタートメニューに追加し、"Open with Atom"コンテキストメニューをExplorerに追加し、そして"Open with..."メニューで`Atom`が候補として出てくるようにします。

![windows-compressor.gif](https://qiita-image-store.s3.amazonaws.com/0/61379/9374d6d6-2948-abce-0fd1-ef5ab2dee3ae.gif)
図２： Windows版Atom(atom.ioのはアニメーションする)

#### Windows用ポータブルモードAtom

`Atom`は`Windows`においてポータブルモードで起動できますが、これはセッティング、パッケージ、キャッシュなどと一緒に`Atom`をリムーバブルストレージに置くことで可能です。つまりインストールすることなしにマシンからマシンへと簡単に持ち運ぶことができます。

`Atom`のポータルモードをするにあたっては：

1. [Atom Releases](https://github.com/atom/atom/releases/latest)から`atom-windows.zip`を取得

2. `atom-windows.zip`をあなたのリムーバブルストレージデバイスに展開

3. 展開された`Atom`フォルダー内で`atom.exe`を起動

4. 一回`Atom`を起動すると `%USERPROFILE%` 内に`.atom`フォルダが生成されます

5. この`.atom`フォルダーをあなたのリムーバブルストレージデバイス内の`Atom`フォルダと同じ階層に移動します

これで`atom.exe`をあなたのリムーバブルストレージデバイスから起動すればいつでもポータブルモードで`Atom`が起動し、セッティングとパッケージをそのデバイス内の`.atom`フォルダに保存します。

ポータブルモードについては制限が幾つかあり：

* `Explorer`への統合とコマンドライン`PATH`へのセットアップがありません
* `.atom`フォルダーは`atom.exe`を含んでいるフォルダーと同じ階層になければなりません（`atom.exe`を含んでいるフォルダーの中ではなく）
* `.atom`フォルダーは書き込み可能でなければなりません
* `ATOM_HOME`環境変数がセットされていてはいけません（この変数はポータブルモードの振る舞いをオーバーライドするため）

### Linux版Atom

`Atom`を`Linux`にインストールするために、`atom.io`の[main Atom website](https://atom.io/download/deb)か、`Atom`のプロジェクトリリースページ https://github.com/atom/atom/releases

から、[Debian package](https://atom.io/download/deb)か[PRM package](https://atom.io/download/rpm)を取得できます。

Debianでは`dpkg -i`で`Debian package`をインストールできます。

```
$ sudo dpkg -i atom-amd64.deb
```
`RedHat`やその他の`PRM`ベースのシステムでは、`rpm -i`コマンドを使うといいでしょう。

```
$ rpm -i atom.x86_64.rpm
```

### ソースコードからAtomをビルド

もしこれらの選択肢があなたにそぐわなかったり、あなたがまさにソースコードから`Atom`をビルドしたいと思った時は、それも可能です。

`Mac`,`Windows`,`Linux`そして`FreeBSD`のための詳細で最新のビルド手順は下記にあります。

https://github.com/atom/atom/tree/master/docs/build-instructions

普通は`Git`,`C++`ツールチェーン,`Node`がインストールに必要です。具体的な手順についてはリポジトリのドキュメントをご覧ください。

### Proxy設定

もしproxyを使っているのなら、[apm](https://github.com/atom/apm) (Atom Package Manager)がproxyを使うよう、`~/.atom/.apmrc`ファイルの`https-proxy`に設定することができます。

```
https-proxy = https://9.0.2.1:0
```

もしファイヤウォールの内側にいて、パッケージのインストール時に`SSL`エラーが出る場合は、次の記述を`~/.atom/.apmrc`ファイルに加えて`strict SSL`を無効化することができます。

```
strict-ssl = false
```

`apm config get https-proxy`と打つことで正しくこの設定がされているかを検証することができますし、`apm config list`と打つと全てのカスタム設定セッティングのリストが表示されます。