[訳注] この文章について
本文章は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を最初に起動した時、こんな画面が出てきます。
図1: Atomエディターのウェルカムスクリーン
専門用語の基礎
まずはじめに、このマニュアルで使用していくであろう幾つかの専門用語について説明します。
バッファ(Buffer)
バッファとは
Atomにおいてはファイルのテキスト記述内容のことです。それは基本的にはほとんどの
文章においてファイルと同義ですが、ここではAtomがメモリーに保持しているものを指します。
具体的に言えば、たとえバッファのテキストを編集しても、それをセーブしなければそれを保持するファイル
には書き出されないということです。
ペーン(Pane)
ペーンとは
Atomエディタのビジュアル的な一部分のことを言います。今起動したウェルカムスクリーンで言えば、
4つのペーンがあります-タブバー、グッター（gutter:行番号が入るところ）、一番下にステータスバー、そしてテキストエディターです。
コマンドパレット
ウェルカムスクリーンを開いているところで、私たちはAtomエディターにおいておそらく一番重要なコマンド「コマンドパレット」を紹介します。
cmd-shift-Pをエディターペーンにフォーカスが当たっている状態で押下すると、コマンドパレットがポップアップします。
| 注意書き | この本を通して私たちはcmd-Shift-Pのようなキーバインディングショートカットをどのようにしてコマンドを起動かを記述するために用います。 この記述はMac版Atomでのデフォルトのキーバインディングになります。それらはあなたのプラットフォームにより少し違うかもしれません。
もし何らかの理由によりキーバインディングが正しく動作しなかった場合は、コマンドパレットで正しいキーバインディングを探せます。 |
|---|
このサーチ形式のメニューはAtomにおいて実行可能なすべてのメジャーなタスクを実行することができます。アプリケーションのメニューをあれでもないこれでもないと突き回す代わりに、cmd-Shift-Pと打ってコマンドを探せばいいのです。
図2：コマンドパレット
数千に及ぶ実行可能なコマンドの中から素早く探し出せるだけでなく、もしそのコマンドに関連付けられたキーバインディングがある場合はそれも分かるようになっています。それがなぜ素晴らしいかというと、興味ある事柄のやり方を（コマンドパレットに）指示すれば一緒にショートカットキーの操作も学習できるからです。
この本では以降、コマンドパレットにおいてサーチするテキストを明文化するのと一緒にそれぞれ異なるコマンド群のキーバインディングについても明文化することにします。
設定とプリファレンス
Atomエディタは設定画面に変更可能な幾つかの設定とプリファレンスを表示します。
図3: Atomの設定画面
この画面にはカラースキームやテーマの変更、改行の扱いをどうするか、フォント設定、タブ長、スクロールスピードなどなどのたくさんの設定があります。後述するAtomパッケージでも触れるように設定画面では新しいパッケージやテーマをインストールすることもできます。
設定画面を開くには、メニューバーのAtom > Preferences を開きます。コマンドパレットでsettings-view:openを探すか、cmd-,キーバインディングでも開くことができます。
カラーテーマの変更
この設定ビューではAtomのカラーテーマを変更することもできます。Atomには次の4つの異なるUIカラーテーマ、AtomテーマとOneテーマの暗いバージョン(dark)と明るいバージョン(light)、そして8つの構文カラーテーマが付属してきます。設定ビューのサイドバーメニューThemesをクリックすることでアクティブなテーマを変更したり、新しいテーマをインストールすることができます。
図4: 設定からテーマを変更
UIテーマがタブ（訳注：ペーンのタブ）やツリービューなどのUIエレメントの色を変更するのに対し、構文テーマはあなたがエディター画面にロードしたテキストの構文ハイライトを変更します。テーマを変更するにはドロップメニューでテーマを選択するだけです。
もし何か違うテーマが欲しい時はAtom.ioに行けばたくさんのテーマがあります。テーマのカスタマイズはスタイル変更のところで触れますし、あなたのテーマを作るやり方はテーマを作るのところで触れます。
自動改行
空白の設定や改行のプレファレンスを設定ビューから変更することができます。
図5： タブと改行の設定変更（訳注：オリジナルがキャプションを使いまわしているのでここに図4と同じ文章が入っている）
"Soft Tabs"機能はタブキーを押下した時に実際のタブ文字を入力する代わりに幾つかの空白文字を入れます。そして"Tab Length"には"Soft Tabs"が有効になっているときはタブキー押下時にタブ文字の代わりに入れる空白文字の個数を、そして"Soft Tabs"が無効になっているときはタブ文字を何文字の空白記号で表示するかを指定します。
"Soft Wrap"はあなたのカレントウィンドウには収まらないようなとても長い行について自動改行します。自動改行が無効になっている場合、とても長い行は横にずっと続き、残りの内容を見るためにはスクロールしなければならないかもしれません。"Soft Wrap At Preferred Line Length"が有効になっている場合、スクリーンの右端ではなく80文字で改行します。80文字以外のデフォルトの改行までの行長もこの画面で変更できます。
カスタマイズの基礎では異なるタイプのファイルにおいて異なる改行のプリファレンスを指定する方法について触れています（例えばMarkdownでは改行してほしいがソースコードでは改行してほしくないなど）。
ベータ機能
Atomエディターは開発中であるため、たまにすべての人に解放される前にテストをしている新しい機能というものがあります。幾つかのケースにおいてはそれらの設定はデフォルトでは無効になっているもののそれらを試してみたい場合において設定ビューから有効化することが可能です。
図6: 設定ビュー内のベータ機能設定
この機能は広範囲に新しい機能がリリースされる前に開発者の開発しているパッケージがちゃんと動いているかどうかを確認することができるため主にパッケージ開発者にとっては便利な機能です。
しかしながら、間も無くどんな機能がリリースされるのかをあなたがチェックしたい時にも役立ちます。
ファイルを開く、変更する、セーブする
これであなたのエディターは望みの見た目と動作になったので、ファイルを開いて編集してみましょう。何せAtomはテキストエディターって言うくらいですしね、でしょう？（訳注：ここジョークなのだがうまい訳が見つからなかったw）
ファイルを開く
Atomでファイルを開くやり方は幾つかあります。メニューバーから "File" >> "Open"を選ぶか、cmd-Oを押下することで、システムダイアログからファイルを選択することができます。
図7: ダイアログからファイルを開く
この機能はファイルがあなたのいるプロジェクト内（次のところで触れる）にないときや新しいウィンドウから何かの理由で編集を始めるときに便利です。
もう一つのAtomでのファイルの開き方はatomコマンドを使ってコマンドラインから開くやり方です。もしMac版Atomなら、atomコマンドやapmコマンドを インストールできなかった場合 Atom >> "Install Shell Commands" でインストールできます。WindowsとLinuxではAtomエディターのインストール手順においてatomコマンドとapmコマンドは自動的にインストールされます。
atomコマンドを一つ以上のファイルパスと一緒に叩けばAtomエディターでそれらのファイルを開けます。
$ atom -h
Atom Editor v0.152.0
Usage: atom [options] [path ...]
One or more paths to files or folders may be specified. If there is an
existing Atom window that contains all of the given folders, the paths
will be opened in that window. Otherwise, they will be opened in a new
window.
...
このコマンドはあなたが端末を使っているときや端末からエディターを開きたい場合において素晴らしいツールとなるでしょう。atom [files]と打つだけであなたはファイル編集を開始できます。
ファイルの編集とセーブ
ファイルの編集は極めて直感的です。マウスでクリックしたりスクロールして、内容を変更するためにキーをタイプすればいいのです。特定のキーコマンドや特殊な編集モードなどはありません。
ファイルをセーブするには、メニューバーの"File" >> "Save"を選ぶか、cmd-S でセーブできます。もし"File" >> "Save As"を選ぶかcmd-shift-Sを押下すれば、違うファイル名のファイルに編集している内容をセーブできます。そして最後に、cmd-alt-SでAtomで開いているすべてのファイルをいっぺんに保存できます。
ディレクトリを開く
Atomは一つ一つのファイルだけを編集できるわけではありません。あなたは複数のファイルからなる複数のプロジェクトの中で作業をするでしょう。ディレクトリを開くには、OS Xではメニューバーで"File" >> "Open"を選択するか、他のプラットフォームでは"File" >> "Open Folder"を選択し、ダイアログからディレクトリを選択します。"File" >> "Add Project Folder..."メニューを選択するかcmd-shift-Oを押下することであなたの使っているAtomウィンドウに複数のディレクトリを追加することができます。
atomコマンドに複数のディレクトリのファイルパスを渡すことでも複数のディレクトリを開くことができます。例えばatom ./hopes ./dreamsとコマンドラインで打てばhopesディレクトリとdreamsディレクトリの両方を同時に開くことができます。
一つ以上のディレクトリを開いたときにウィンドウの左側にツリービューが出ます。
図8: 開いたプロジェクトとツリービュー
ツリービューであなたのプロジェクトに属するファイルやディレクトリ構造を辿ったり編集したりができます。このビューからファイルを開いたり名前を変更したり、削除したり、新しいファイルを作ったりできます。
ツリービューの表示・非表示はcmd-\かコマンドパレット内でtree-view:toggleでトグルでき、ctrl-0でフォーカスを当てることができます。ツリービューにフォーカスが当たっている状態でa,m,deleteを押下することでファイルやフォルダーを追加、移動、削除できます。あるいはシンプルにツリービュー内でファイルやフォルダーを右クリックすることでたくさんの様々なオプション、つまり今まで述べてきたものに加えネイティブのファイルシステムでファイルを表示したりシステムクリップボードにファイルパスをコピーしたりすることができます。
| 注意書き | Atomモジュール
Atomのたくさんの部分のように、ツリービューもまたエディターと一緒にビルドされているのではなく、単にデフォルトでAtomに付属しているスタンドアローンのパッケージなのです。 ツリービューのソースコードは次のURLから取得できます：https://github.com/atom/tree-view これは |
|---|
プロジェクト内のファイルを開く
一度プロジェクトをAtom内で開いてしまえば、あなたは簡単にそのプロジェクト内のあらゆるファイルを探したり開いたりすることができます。
cmd-Tかcmd-Pのいずれかを押下すれば、ファジーファインダーダイアログ（訳注：Fuzzy Finder dialog）がポップアップします。パスの一部分をタイプするだけでプロジェクト内のあらゆるディレクトリ内のあらゆるファイルを探し出すことができます。
図9: ファジーファインダー内でファイルを開く
cmd-Bでプロジェクトのすべてのファイルではなく今開いているファイルだけをサーチの対象にできます。この機能はバッファー群、つまり開かれているファイルだけをサーチします。cmd-shift-Bはこのファジーサーチをあなたの最新のGitコミットから変更された、あるいは新しく作られたファイルだけに制限して実行します。
ファジーファインダーはcore.ugnoredNamesとfuzzy-finder.ignoredNamesの両方の設定を使いファイルをフィルターして除外し、それらの除外したファイルを見えなくします。もし膨大な量のサーチしたくないファイルがある場合、あなたはファイルパスやパターンをそれらのいずれかの設定に加えることができます。詳しくは後述のグローバル環境設定で述べますが、あなたはコア設定下の設定ビューで簡単にそれらを設定できるでしょう。
それらの環境設定はminimatch Node.jlライブラリとして実装されたglobパターンとして解釈されます。（訳注：ここうまく訳せなかった）。
minimatchについて詳しくは https://github.com/isaacs/minimatch を参照してください。
このパッケージはcore.excludeVcsIgnoredPathが有効になっていればignoreされたGitファイルを対象から除外します。設定ビュー内で簡単にトグルでき、それはトップの（訳注：よく使う）オプションのうちの一つです。