Merge pull request astaxie#453 from ernix/ja

Translate delta commits into Japanese

Author: astaxie

ja/01.1.md

@@ -3,8 +3,8 @@
 ## 3つのインストール方法
 Goにはいくつものインストール方法があります。どれでも好きなのを選んでかまいません。ここでは3つのよくあるインストール方法をご紹介します：
 
-- ソースコードのインストール：標準的なインストール方法です。Unix系システムをよく使うユーザ、特に開発者にとってはお馴染みの方法です。
-- 標準パッケージのインストール：Goは便利なインストールパッケージを用意しています。Windows, Linux, Macなどのシステムをサポートしています。初心者にはうってつけでしょう。システムのbit数に対応したインストールパッケージをダウンロードして、"Next"をたどるだけでインストールできます。
+- ソースコードのインストール：標準的なインストール方法です。Unix系システムをよく使うユーザ、特に開発者であれば、設定を好みに合わせて変更できます。
+- 標準パッケージのインストール：Goは便利なインストールパッケージを用意しています。Windows, Linux, Macなどのシステムをサポートしています。とりあえずさっとインストールするにはうってつけでしょう。システムのbit数に対応したインストールパッケージをダウンロードして、"Next"をたどるだけでインストールできます。 **おすすめ**
 - サードパーティツールによるインストール：現在便利なサードパーティパッケージも多くあります。たとえばUbuntuのapt-get、Macのhomebrewなどです。これらのシステムに慣れたユーザにはぴったりのインストール方法です。
 
 最後に同じシステムの中で異なるバージョンのGoをインストールする場合は、[GVM](https://github.com/moovweb/gvm)が参考になります。どうすればよいか分からない場合一番うまくやれます。
@@ -18,39 +18,43 @@ Unixでは、gccなどのツールをインストールする必要がありま
 
 Windowsでは、MinGWをインストールする必要があります。その後MinGWでgccをインストールして、適切な環境変数を設定します。
 
-Goは[Mercurial][hg]を使ってバージョン管理を行っています、まずMercurialをインストールし、その後でダウンロードできます。もしMercurialがインストールされているのであれば、以下のコードを実行します：
+直接オフィシャルサイトから[ソースコードをダウンロード](http://golang.org/dl/)できます。対応する`goVERSION.src.tar.gz`のファイルをダウンロードし、`$HOME`ディレクトリに解凍してから以下のコマンドを実行します。
 
-もしGoのインストールディレクトリが`$GO_INSTALL_DIR`だった場合
-
-	hg clone -u release https://code.google.com/p/go
 	cd go/src
 	./all.bash
 
 all.bashを実行後"ALL TESTS PASSED"が表示されると、インストール成功です。
 
-上記はUnixスタイルのコマンドです、Windowsもインストール方法は似ており、all.batを実行するだけです。コンパイラはMinGWのgccを使います。
+上記はUnixスタイルのコマンドです、Windowsもインストール方法は似ており、`all.bat`を実行するだけです。コンパイラはMinGWのgccを使います。
+
+もしMacまたはUnixユーザであればいくつかの環境変数を設定する必要があります。再起動しても有効にしたい場合は以下のコマンドを`.bashrc`や`.zsh`に書いておきます。
 
-その後環境変数をいくつか設定します、
+	export GOPATH=$HOME/gopath
+	export PATH=$PATH:$HOME/go/bin:$GOPATH/bin
 
-	export GOROOT=$HOME/go
-	export GOBIN=$GOROOT/bin
-	export PATH=$PATH:$GOBIN
+ファイルに書き込んだ場合は、`bash .bashrc`や`bash .zshrc`を実行してすぐに設定を有効にします。
 
-下のような画像が現れると、インストール成功です。
+Windowsシステムの場合は、環境変数を設定する必要があります。pathにgoが存在するディレクトリを追加し、gopath変数を設定します。
+
+設定が終わり、コマンドプロンプトで`go`を入力すると、下図のような画面が表示されるはずです。
 
 ![](images/1.1.mac.png?raw=true)
 
 図1.1 ソースコードインストール後Goコマンドを実行
 
 GoのUsage情報が表示されれば、Goのインストールは成功です：もしこのコマンドが存在しない場合は、PATH環境変数のなかにGoのインストールディレクトリが含まれているか確認してください。
 
+> GOPATHについては以降の章で詳しくご説明します
 
 ## Go標準パッケージのインストール
 
 Goはさまざまなプラットホームでインストールパッケージを提供しています、これらのパッケージはデフォルトで以下のディレクトリにインストールします：/usr/local/go（Windows：c:\Go）。当然これらのインストール場所を変更することもできます、ただし変更後はあなたの環境変数を以下のように設定する必要があります：
 
 	export GOROOT=$HOME/go  
-	export PATH=$PATH:$GOROOT/bin
+	export GOPATH=$HOME/gopath
+	export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
+
+これらのコマンドはMacやUnixユーザであれば`.bashrc`や`.zshrc`ファイルに入れておくべきでしょう。Windowsユーザであれば当然環境変数に入れておきます。
 
 ### 自分の操作しているシステムが32bitか64bitか判断する方法
 
@@ -72,19 +76,19 @@ LinuxユーザはTerminalで`arch`(すなわち、`uname -a`)を実行するこ
 
 ### Mac インストール
 
-[ダウンロードURL][downlink]にアクセスし、32bitシステムはgo1.0.3.darwin-386.pkgをダウンロードします。64bitシステムであればgo1.0.3.darwin-amd64.pkgをダウンロードします。ファイルをダブルクリックし、すべてデフォルトで「次へ」ボタンをクリックします。これでgoはあなたのシステムにインストールされました。デフォルトでPATHの中に適切な`~/go/bin`が追加されています。端末を開いて`go`と入力します。
+[ダウンロードURL][downlink]にアクセスし、32bitシステムはgo1.4.2.darwin-386-osx10.8.pkgをダウンロードします。64bitシステムであればgo1.4.2.darwin-amd64-osx10.8.pkgをダウンロードします。ファイルをダブルクリックし、すべてデフォルトで「次へ」ボタンをクリックします。これでgoはあなたのシステムにインストールされました。デフォルトでPATHの中に適切な`~/go/bin`が追加されています。端末を開いて`go`と入力します。
 
 インストール成功の画像が表示されればインストール成功です。
 
 もしgoのUsage情報が表示した場合は、goはすでにインストールされています。もしこのコマンドが存在しないと表示した場合は、自分のPATH環境変数の中にgoのインストールディレクトリが含まれているか確認してください。
 
 ### Linux インストール
 
-[ダウンロードURL][downlink]にアクセスし、32bitシステムであればgo1.0.3.linux-386.tar.gzを、64bitシステムであればgo1.0.3.linux-amd64.tar.gzをダウンロードします。
+[ダウンロードURL][downlink]にアクセスし、32bitシステムであればgo1.4.2.linux-386.tar.gzを、64bitシステムであればgo1.2.2.linux-amd64.tar.gzをダウンロードします。
 
 以下ではGoがインストールされたディレクトリを`$GO_INSTALL_DIR`と仮定します。
 
-`tar.gz`をインストールディレクトリに解凍します：`tar zxvf go1.0.3.linux-amd64.tar.gz -C $GO_INSTALL_DIR`
+`tar.gz`をインストールディレクトリに解凍します：`tar zxvf go1.4.2.linux-amd64.tar.gz -C $GO_INSTALL_DIR`
 
 PATHを設定します。`export PATH=$PATH:$GO_INSTALL_DIR/go/bin`
 
@@ -115,11 +119,11 @@ gvmはサードパーティが開発したGoのバージョン管理ツールで
 
 インストールが完了したあと、goをインストールすることができます：
 
-	gvm install go1.1
-	gvm use go1.1
+	gvm install go1.4.2
+	gvm use go1.4.2
 
 下のコマンドで、毎回gvm useをコールする手間を省くことができます：
-        gvm use go1.1 --default
+        gvm use go1.4.2 --default
 
 上のコマンドを実行したあと、GOPATH、GOROOTなどの環境変数が自動的に設定されます。これで、直接利用することができます。
 
@@ -145,5 +149,4 @@ homebrewはMacで現在最も使用されているソフトウェア管理ツー
    * 前へ: [Goの環境設定](<01.0.md>)
    * 次へ: [GOPATHとワーキングディレクトリ](<01.2.md>)
 
-[downlink]: http://code.google.com/p/go/downloads/list "Goインストールパッケージダウンロード"
-[hg]: http://mercurial.selenic.com/downloads/ "Mercurialダウンロード"
+[downlink]:http://golang.org/dl/ "Goインストールパッケージダウンロード"

ja/01.2.md

@@ -1,13 +1,17 @@
 # 1.2 GOPATHとワーキングディレクトリ
 
+さきほどGoをインストールする際はGOPATH変数を設定する必要があるとご説明しました。Goはバージョン1.1から必ずこの変数を設定するようになっており、Goのインストールディレクトリと同じにはできません。このディレクトリは、GoのソースコードやGoの実行可能ファイル、並びにコンパイル済みのパッケージファイルを保存する為に使用します。そのためこのディレクトリには３つのサブディレクトリが存在します：src、bin、pkgです。
+
 ## GOPATH設定
-  go コマンドには重要な環境変数があります：$GOPATH<sup>1</sup>
+  go コマンドは、ある重要な環境変数に依存しています：$GOPATH<sup>1</sup>
+
+  Windowsシステムにおいて環境変数の形式は`%GOPATH%`です。この本の中では主にUnix形式を使用します。Windowsユーザは適時置き換えてください。
 
-  *（注：これはGoのインストールディレクトリではありません。以下では筆者のワーキングディレクトリで説明します。ご自身のマシン上のワーキングディレクトリに置き換えてください。）*
+  *（注：これはGoのインストールディレクトリではありません。以下では筆者のワーキングディレクトリで説明します。もし異なるディレクトリを使用する場合はGOPATHをあなたのワーキングディレクトリに置き換えてください。）*
 
   Unix に似た環境であれば大体以下のような設定になります：
 ```sh
-	export GOPATH=/home/apple/mygo
+export GOPATH=/home/apple/mygo
 ```
   上のディレクトリを新たに作成し、上の一行を`.bashrc`または`.zshrc`もしくは自分の`sh`の設定ファイルに加えます。
 
@@ -26,28 +30,29 @@ GOPATHは複数のディレクトリを許容します。複数のディレク
 
 以降私はすべての例でmygoを私のgopathディレクトリとします。
 
-## アプリケーションディレクトリ構成
-パッケージとディレクトリの作成：$GOPATH/src/mymath/sqrt.go（パッケージ名："mymath"）
+## ソースコードディレクトリ構成
+GOPATH内のsrcディレクトリはこれから開発するプログラムにとってメインとなるディレクトリです。全てのソースコードはこのディレクトリに置くことになります。一般的な方法では一つのプロジェクトが一つのディレクトリが割り当てられます、例えば：$GOPATH/src/mymath はmymathというアプリケーションパッケージか実行アプリケーションになります。これはpackageがmainかそうでないかによって決定します。mainであれば実行可能アプリケーションで、そうでなければアプリケーションパッケージになります。これに関してはpackageを後ほどご紹介する予定です。
 
-以後私が新規に作成するアプリケーションまたはコードパッケージはsrcディレクトリに新規ディレクトリを作成します。ディレクトリ名はほぼコードパッケージの名前です。当然ネストしたディレクトリもありえます、例えば、srcの下にディレクトリ $GOPATH/src/github.com/astaxie/beedbというようなディレクトリを作成すると、このパッケージのパスは"github.com/astaxie/beedb"になります。パッケージ名は最後のディレクトリであるbeedbです。
 
-以下のコードを実行します。
+新しくアプリケーションやソースパッケージを作成するときは、srcディレクトリの中にディレクトリを作るところから始めます。ディレクトリ名は一般的にソースパッケージ名になります。もちろんネストしたディレクトリも可能です。例えばsrcの中に$GOPATH/src/github.com/astaxie/beedbというディレクトリを作ったとすると、このパッケージパスは"github.com/astaxie/beedb"になり、パッケージ名は最後のディレクトリであるbeedbになります。
+
+以下ではmymathを例にどのようにアプリケーションパッケージをコーディングするかご説明します。以下のコードを実行します。
 ```sh
-	cd $GOPATH/src
-	mkdir mymath
+cd $GOPATH/src
+mkdir mymath
 ```
 sqrt.goというファイルを作成し、内容を以下のようにします。
 ```go
-	// $GOPATH/src/mymath/sqrt.goコードは以下の通り：
-	package mymath
-
-	func Sqrt(x float64) float64 {
-		z := 0.0
-		for i := 0; i < 1000; i++ {
-			z -= (z*z - x) / (2 * x)
-		}
-		return z
+// $GOPATH/src/mymath/sqrt.goコードは以下の通り：
+package mymath
+
+func Sqrt(x float64) float64 {
+	z := 0.0
+	for i := 0; i < 1000; i++ {
+		z -= (z*z - x) / (2 * x)
 	}
+	return z
+}
 ```
 このように私のアプリケーションパッケージディレクトリとコードが作成されました。注意：一般的にpackageの名前とディレクトリ名は一致させるべきです。
 
@@ -60,49 +65,58 @@ sqrt.goというファイルを作成し、内容を以下のようにします
 
 インストールが終われば、以下のディレクトリに入り
 ```sh
-	cd $GOPATH/pkg/${GOOS}_${GOARCH}
-	//以下のファイルが現れるはずです。
-	mymath.a
+cd $GOPATH/pkg/${GOOS}_${GOARCH}
+//以下のファイルが現れるはずです。
+mymath.a
 ```
 この.aファイルはアプリケーションパッケージです。ならば我々はどのように実行できるでしょうか？
 
-次にアプリケーション・プログラムを作成して実行します。
+次にアプリケーション・プログラムを作成してこのアプリケーションパッケージをコールします。
 
 アプリケーションパッケージmathappを作ります。
 ```sh
-	cd $GOPATH/src
-	mkdir mathapp
-	cd mathapp
-	vim main.go
+cd $GOPATH/src
+mkdir mathapp
+cd mathapp
+vim main.go
 ```
-// `$GOPATH/src/mathapp/main.go`コード：
+
+`$GOPATH/src/mathapp/main.go`コード：
 ```go
-	package main
+package main
 
-	import (
-		  "mymath"
-		  "fmt"
-	)
+import (
+	  "mymath"
+	  "fmt"
+)
 
-	func main() {
-		  fmt.Printf("Hello, world.  Sqrt(2) = %v\n", mymath.Sqrt(2))
-	}
+func main() {
+	  fmt.Printf("Hello, world.  Sqrt(2) = %v\n", mymath.Sqrt(2))
+}
 ```
-どのようにプログラムをコンパイルするのでしょうか？このアプリケーションディレクトリに入り、`go build`を実行すれば、このディレクトリの下にmathappの実行可能ファイルが生成されます。
+このパッケージは`main`であることが分かると思います。importにおいてコールするパッケージは`mymath`であり、これが`$GOPATH/src`のパスに対応します。もしネストしたディレクトリであれば、importの中でネストしたディレクトリをインポートします。例えばいくつものGOPATHがあった場合も同じで、Goは自動的に複数の`$GOPATH/src`の中から探し出します。
+
+さて、どのようにプログラムをコンパイルするのでしょうか？このアプリケーションディレクトリに入り、`go build`を実行すれば、このディレクトリの下にmathappの実行可能ファイルが生成されます。
 ```sh
-	./mathapp
+./mathapp
 ```
+
 以下のように出力されます。
 ```sh
-	Hello, world.  Sqrt(2) = 1.414213562373095
+Hello, world.  Sqrt(2) = 1.414213562373095
 ```
-どのようにアプリケーションをインストールするのでしょうか。このディレクトリに入り、`go install`を実行します。すると、$GOPATH/bin/の下に実行可能ファイルmathappが作成されますので、コマンドラインから以下のように入力することで実行することができます。
 
-	mathapp
+どのようにアプリケーションをインストールするのでしょうか。このディレクトリに入り、`go install`を実行すると、$GOPATH/bin/の下に実行可能ファイルmathappが作成されます。`$GOPATH/bin`が我々のPATHに追加されていることを思い出して下さい、コマンドラインから以下のように入力することで実行することができます。
+
+```sh
+mathapp
+```
 
 この場合も以下のように出力されます。
 
 	Hello, world.  Sqrt(2) = 1.414213562373095
+	
+ここではどのように実行可能アプリケーションをコンパイル/インストールし、ディレクトリ構造を設計するかについてご紹介しました。
 
 ## リモートパッケージの取得
    go言語はリモートパッケージを取得するツール`go get`を持っています。現在go getは多数のオープンソースリポジトリをサポートしています（github、googlecode、bitbucket、Launchpad）
@@ -156,8 +170,6 @@ go getは以下のような手順を踏みます。まずはじめにソース
 
 上述の構成から明確に判断できるのは、binディレクトリの下にコンパイル後の実行可能ファイルが保存され、pkgの下に関数パッケージが保存され、srcの下にアプリケーションのソースコードが保存されているということです。
 
- - - -
-[1] Windowsシステムの環境変数の形式は`%GOPATH%`です。本書では主にUnix形式を使いますので、Windowsユーザは適時自分の環境に置き換えてください。
 ## links
   * [目次](<preface.md>)
   * 前へ: [GOのインストール](<01.1.md>)