Merge pull request astaxie#374 from ernix/ja

Translate delta commits into Japanese

Author: astaxie

ja/README.md

@@ -1,4 +1,12 @@
 # "Go Web プログラミング"
+この本には現在いくつかのバージョンがあります:
+
+[中国語で読み始める](<https://github.com/astaxie/build-web-application-with-golang/blob/master/ebook/preface.md>)
+
+[日本語で読み始める](<https://github.com/astaxie/build-web-application-with-golang/blob/master/ja/ebook/preface.md>)
+
+[English Version](<https://github.com/astaxie/build-web-application-with-golang/blob/master/en/eBook/preface.md>)
+
 現在この本はすでに出版されています。もし悪くない内容だと思ったら以下より購入することができます。ご協力に感謝いたします：
 
 - [chinapub](http://product.china-pub.com/3767290)
@@ -11,16 +19,17 @@
 # カンパでサポートする
 もし"Go Webプログラミング"を気に入っていただけたのなら、寄付を通じて作者にこの本の続きを更新させるか、もっと面白くてためになるオープンソースアプリケーションの開発をご検討下さい：例えばこの本にパッチをあてたり、もっと面白い章を追加したり、もっともっと凄い内容の次回作を出してみたり、beegoを改修してくれたり、です。
 
-寄付はこちら： [https://me.alipay.com/astaxie](https://me.alipay.com/astaxie)
+支付宝扫描捐款: ![](ebook/images/alipay.png)
 
+English Donate:[donate](http://beego.me/donate)
 
 ## 連絡方法
 ぜひQQ群にどうぞ：259316004 《Go Web编程》专用交流群
 
-掲示板：[http://bbs.mygolang.com](http://bbs.mygolang.com)
+掲示板：[http://bbs.go-china.org/](http://bbs.go-china.org/)
 
 ## 謝辞
-まずGolang-ChinaのQQ群102319854に感謝を申し上げます。彼らはみんな非常に熱心で、特に数名の方には本当に感謝しています。
+まずGolang-ChinaのQQ群102319854(すでに満員です)に感謝を申し上げます。2群(384414723)を追加してください。彼らはみんな非常に熱心で、特に数名の方には本当に感謝しています。
 
  - [四月份平民](https://plus.google.com/110445767383269817959) (コードレビュー)
  - [Hong Ruiqi](https://github.com/hongruiqi) (コードレビュー)

ja/ebook/01.1.md

@@ -96,13 +96,16 @@ PATHを設定します。`export PATH=$PATH:$GO_INSTALL_DIR/go/bin`
 
 もしgoのUsage情報が現れた場合は、goはすでにインストールされています。もしこのコマンドが存在しないと出てきた場合は、自分のPATH環境変数の中にgoのインストールディレクトリが含まれているか確認してください。
 
-### Windows インストール
+### Windows インストール ###
 
-[ダウンロードURL][downlink]に接続し、32bitシステムはgo1.0.3.windows-386.msiをダウンロードします。64bitシステムであればgo1.0.3.windows-amd64.msiをダウンロードします。ファイルをダブルクリックして、デフォルトのまま「次へ」をクリックします。この時goはすでにあなたのシステムにインストールされています。デフォルトでインストール後の環境変数には`c:/go/bin`が追加されています。cmdを開いて、`go`と入力します。
+[Google Code ダウンロードページ][downlink]に接続し、32bit の場合は名前に windows-386 を含む msi パッケージをダウンロードします。64bit であれば名前に windows-amd64 を含むものをダウンロードします。ダウンロード後実行しますが、デフォルトのインストールフォルダである C:\Go\を変更してはいけません。他の場所にインストールしてしまうと、あなたが書いた Go コードが実行できなくなってしまうかもしれません。インストールが終わるとデフォルトで環境変数 Path に Go のインストールフォルダの下にある bin フォルダ `C:\Go\bin\` が追加され、Go のインストールフォルダである `C:\Go\` の値が環境変数 GOROOT に追加されます。
 
-macインストール成功の画像で、インストールが成功します。
+** インストールが成功しているか確認する **
+
+「ファイル名を指定して実行」に `cmd` を入力することでコマンドラインツールを開きます。プロンプトで`go`と入力することで Usage 情報が確認できるか確かめることができます。`cd %GOROOT%` を入力すると、Go のインストールフォルダに入れるか確認できます。どちらも成功していれば、インストールに成功しています。
+
+インストールに成功していなければ、環境変数 Path と GOROOT の値を確認してください。もし存在しなければアンインストールの上再インストールし、存在していればコンピュータを再起動し、上の手順を再度お試しください。
 
-もしGoのUsage情報が現れたら、Goはすでにインストールされています。もしこのコマンドが存在しないと出た場合は自分のPATH環境変数にGoのインストールディレクトリが含まれるか確認してください。
 
 ## サードパーティツールのインストール
 ### GVM

ja/ebook/01.3.md

@@ -33,7 +33,7 @@
 	array_windows.go
 	array_freebsd.go
 
-  `go build`の際、システム名の末尾のファイルから選択的にコンパイルすることができます（linux、darwin、windows、freebsd）
+  `go build`の際、システム名の末尾のファイルから選択的にコンパイルすることができます（Linux、Darwin、Windows、Freebsd）
 
 ## go clean
 

ja/ebook/01.4.md

@@ -166,7 +166,7 @@
 			"env": { "GOPATH": "$HOME/golang:$GS_GOPATH" }
 		}
 
-  `$GS_GOPATH` は gosublime の仮想的な環境変数です。自動的に`.go`ファイルが存在する `~/go/src` を探し出すことで、 `~/go/` をプロジェクトのパスと推測し、自動的に `GOPATH` を適用します。
+  `$GS_GOPATH` は gosublime の仮想的な環境変数です。自動的に`.go`ファイルが存在する `~/go/src` を探し出すことで、 `~/go/` をプロジェクトのパスと推測し、自動的に `GOPATH` を適用します。（注意：このような方法ではsublimeにおいてオリジナルのGOPATHを上書きしてしまいます。もしこの設定でエラーが発生した場合は、GOPATHに関連した問題が発生していることになります）
 
   もうひとつは、sublime プロジェクトの保存です。 project_name.sublime-project を修正して項目を追加します
 
@@ -226,7 +226,7 @@ Vimはviから発展したテキストエディタです。コード補完、コ
 
  5. おめでとうございます。インストール完了です。あなたは今から`:e main.go`でGoで開発する面白さを体験することができます。
 
-より多くのVIM 設定は、[リンク](http://monnand.me/p/vim-golang-environment/zhCN/)をご参照ください。
+より多くのVIMの設定は、[リンク](http://monnand.me/p/vim-golang-environment/zhCN/)をご参照ください。
 
 ## Emacs
 Emacsは伝説の神器です。彼女はエディタであるだけでなく、統合環境でもあります。または開発環境の集大成と呼んでもよいかもしれません。これらの機能はユーザの身を万能のオペレーティングシステムに置きます。

ja/ebook/02.2.md

@@ -103,7 +103,7 @@ Goではbool値の型は`bool`です。値は`true`もしくは`false`です。
 
 >注意しなければならないのは、これらの型の変数間は相互に代入または操作を行うことができないということです。コンパイル時にコンパイラはエラーを発生させます。
 >
->下のコードはエラーが発生します。
+>下のコードはエラーが発生します。：invalid operation: a + b (mismatched types int8 and int32)
 >
 >>	var a int8
 
@@ -135,7 +135,7 @@ Goではbool値の型は`bool`です。値は`true`もしくは`false`です。
 		frenchHello = "Bonjour"  // 通常の代入
 	}
 
-Goの文字列は変更することができません。例えば下のコードはコンパイル時にエラーが発生します。
+Goの文字列は変更することができません。例えば下のコードはコンパイル時にエラーが発生します。：cannot assign to s[0]
 
 	var s string = "hello"
 	s[0] = 'c'
@@ -168,7 +168,10 @@ Goでは`+`演算子を使って文字列を連結することができます：
 	m := `hello
 		world`
 
-`` ` `` で括られた文字列はRaw文字列です。すなわち、文字列はコード内の形式がそのままプリント時の形式になります。文字列の変更はありません。改行はそのまま出力されます。
+`` ` `` で括られた文字列はRaw文字列です。すなわち、文字列はコード内の形式がそのままプリント時の形式になります。文字列の変更はありません。改行はそのまま出力されます。例えばこの例では以下のように出力されます：
+
+    hello
+		world
 
 ### エラー型
 Goにはビルトインの`error`型があります。専らエラー情報の処理に使用されます。Goの`package`の中にはエラー処理を行う`errors`というパッケージがあります。
@@ -383,7 +386,7 @@ sliceには便利な操作があります
 下のコードをご覧ください。`map`の読み込みと代入は`slice`と似ています。`key`を通して操作します。ただ、`slice`の`index`は`int`型のみになります。`map`には多くの型があります。`int`でもかまいませんし、`string`や`==`と`!=`演算子が定義されている全ての型でもかまいません。
 
         // keyを文字列で宣言します。値はintとなるディクショナリです。この方法は使用される前にmakeで初期化される必要があります。
-	var numbers map[string] int
+	var numbers map[string]int
 	// もうひとつのmapの宣言方法
 	numbers := make(map[string]int)
 	numbers["one"] = 1  //代入
@@ -407,7 +410,7 @@ mapを使う段階で注意しなければならないことがいくつかあ
 `delete`で`map`の要素を削除します：
 
 	// ディクショナリを初期化します。
-	rating := map[string]float32 {"C":5, "Go":4.5, "Python":4.5, "C++":2 }
+	rating := map[string]float32{"C":5, "Go":4.5, "Python":4.5, "C++":2 }
         // mapは２つの戻り値があります。２つ目の戻り値では、もしkeyが存在しなければ、okはfalseに、存在すればokはtrueになります。
 	csharpRating, ok := rating["C#"]
 	if ok {

ja/ebook/02.3.md

@@ -1,7 +1,7 @@
 # 2.3 フローと関数
 この節ではGoの中のフロー制御と関数操作についてご紹介します。
 ## フロー制御
-フロー制御はプログラム言語の中の最も偉大な発明です。なぜならこれがあるだけで、あなたはとても簡単なフローの記述でとても複雑なロジックを表現できるからです。フロー制御は３つの部分から成ります：条件判断、ループ制御及び無条件ジャンプです。
+フロー制御はプログラム言語の中の最も偉大な発明です。なぜならこれがあるだけで、あなたはとても簡単なフローの記述でとても複雑なロジックを表現できるからです。Goではフロー制御は３つの部分から成ります：条件判断、ループ制御及び無条件ジャンプです。
 ### if
 `if`はあらゆるプログラミング言語の中で最もよく見かけるものかもしれません。この文法は大雑把に言えば：もし条件を満足しなければ何々を行い、そうでなければまたもう一つ別のことをやるということです。
 
@@ -468,7 +468,7 @@ Goのコードを書いている時は、importコマンドによってパッケ
 
 	fmt.Println("hello world")
 
-上のfmtはGo言語の標準ライブラリです。実はgorootの下にこのモジュールが加えられています。当然Goのインポートは以下のような２つの方法で自分の書いたモジュールを追加することができます：
+上のfmtはGo言語の標準ライブラリです。実は`GOROOT`環境変数で指定されたディレクトリの下にこのモジュールが加えられています。当然Goのインポートは以下のような２つの方法で自分の書いたモジュールを追加することができます：
 
 1. 相対パス
 

ja/ebook/02.5.md

@@ -156,7 +156,7 @@ methodはstructの上でしか使用されないのでしょうか？当然違
 		b.color = c
 	}
 
-	func (bl BoxList) BiggestsColor() Color {
+	func (bl BoxList) BiggestColor() Color {
 		v := 0.00
 		k := Color(WHITE)
 		for _, b := range bl {
@@ -192,13 +192,13 @@ methodはstructの上でしか使用されないのでしょうか？当然違
 		fmt.Printf("We have %d boxes in our set\n", len(boxes))
 		fmt.Println("The volume of the first one is", boxes[0].Volume(), "cm³")
 		fmt.Println("The color of the last one is",boxes[len(boxes)-1].color.String())
-		fmt.Println("The biggest one is", boxes.BiggestsColor().String())
+		fmt.Println("The biggest one is", boxes.BiggestColor().String())
 
 		fmt.Println("Let's paint them all black")
 		boxes.PaintItBlack()
 		fmt.Println("The color of the second one is", boxes[1].color.String())
 
-		fmt.Println("Obviously, now, the biggest one is", boxes.BiggestsColor().String())
+		fmt.Println("Obviously, now, the biggest one is", boxes.BiggestColor().String())
 	}
 
 上のコードはconstでいくつかの定数を定義しています。その後カスタム定義型を定義しています。
@@ -209,9 +209,9 @@ methodはstructの上でしか使用されないのでしょうか？当然違
 
 次に上のカスタム定義型をレシーバとしてmethodを定義します。
 
-- Volume()はレシーバをBoxとして定義します。Boxの堆積を返します。
+- Volume()はレシーバをBoxとして定義します。Boxの体積を返します。
 - SetColor(c Color)はBoxの色をcに変更します。
-- BiggestsColor()はBoxListに定義されており、listの中の体積が最大の色を返します。
+- BiggestColor()はBoxListに定義されており、listの中の体積が最大の色を返します。
 - PaintItBlack()はBoxListのすべてのBoxの色を全部黒に変更します。
 - String()はColorに定義されており、Colorの具体的な色を返します（文字列形式）
 

ja/ebook/02.6.md

@@ -142,7 +142,7 @@ mは３つの型を持つことのできるオブジェクトなので、Men型
 		mike := Student{Human{"Mike", 25, "222-222-XXX"}, "MIT", 0.00}
 		paul := Student{Human{"Paul", 26, "111-222-XXX"}, "Harvard", 100}
 		sam := Employee{Human{"Sam", 36, "444-222-XXX"}, "Golang Inc.", 1000}
-		Tom := Employee{Human{"Sam", 36, "444-222-XXX"}, "Things Ltd.", 5000}
+		Tom := Employee{Human{"Tom", 37, "222-444-XXX"}, "Things Ltd.", 5000}
 
 		//Men型の変数iを定義します。
 		var i Men
@@ -354,7 +354,7 @@ sort.Interfaceは実は組み込みフィールドです。sort.Interfaceのす
 	}
 
 ### リフレクション
-Goはリフレクションを実装しています。いわゆるリフレクションとは動的な実行時の状態です。私達が一般的に使用しているパッケージはreflectパッケージです。どのようにreflectパッケージを使うかはオフィシャルのドキュメントに詳細な原理が説明されています。[laws of reflection](http://golang.org/doc/articles/laws_of_reflection.html)
+Goはリフレクションを実装しています。リフレクションはプログラムの実行時の状態を検査することができます。私達が一般的に使用しているパッケージはreflectパッケージです。どのようにreflectパッケージを使うかはオフィシャルのドキュメントに詳細な原理が説明されています。[laws of reflection](http://golang.org/doc/articles/laws_of_reflection.html)
 
 reflectを使うには３つのステップに分けられます。下で簡単にご説明します：リフレクションは型の値（これらの値はすべて空のインターフェースを実装しています。）。まずこれをreflectオブジェクトに変換する必要があります（reflect.Typeまたはreflect.Valueです。異なる状況によって異なる関数をコールします。）この２つを取得する方法は：
 

ja/ebook/02.7.md

@@ -31,16 +31,16 @@ goroutineはGoのruntime管理を利用したスレッドコントローラで
 		say("hello") //現在のGoroutines実行
 	}
 
-	出力：
-	hello
-	world
-	hello
-	world
-	hello
-	world
-	hello
-	world
-	hello
+	// 上のプログラムを実行すると以下のように出力されます：
+	// hello
+	// world
+	// hello
+	// world
+	// hello
+	// world
+	// hello
+	// world
+	// hello
 
 goキーワードで非常に簡単にマルチスレッドプログラミングを実現することがお分かりいただけるかと思います。
 上の複数のgoroutineは同じプロセスで実行されています。メモリのデータを共有しますが、デザイン上共有を利用して通信を行ったりせず、通信によって共有を行うようにしましょう。
@@ -137,7 +137,7 @@ channelは`<-`演算子を使ってデータを送ったり受けたりします
 		}
 	}
 
-`for i := range c`でこのchannelがクローズを明示されるまで連続してchannelの中のデータを読み込むことができます。上のコードでchannelのクローズが明示されているのが確認できるかと思います。生産者はキーワード`close`関数によってchannelを閉じます。channelを閉じた後はいかなるデータも送信することはできません。消費側は`v, ok := <-ch`という式でchannelがすでに閉じられているかテストすることができます。もしokにfalseが返ってきたら、channelはすでにどのようなデータも無く、閉じられているということになります。
+`for i := range c`でこのchannelがクローズを明示されるまで連続してchannelの中のデータを読み込むことができます。上のコードでchannelのクローズが明示されているのが確認できるかと思います。生産者は`close`ビルトイン関数によってchannelを閉じます。channelを閉じた後はいかなるデータも送信することはできません。消費側は`v, ok := <-ch`という式でchannelがすでに閉じられているかテストすることができます。もしokにfalseが返ってきたら、channelはすでにどのようなデータも無く、閉じられているということになります。
 
 >生産者の方でchannelが閉じられる事に注意してください。消費側ではありません。これは容易にpanicを引き起こします。