Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

[インデックス 10443] ファイルの概要

このコミットは、Go言語の公式ドキュメントサイト golang.org 内の doc/docs.html ファイルに、Go言語のインタラクティブなチュートリアルである「A Tour of Go」の中国語翻訳版へのリンクを追加するものです。これにより、中国語話者のユーザーがGo言語の学習リソースにアクセスしやすくなります。

コミット

  • コミットハッシュ: 0bbbb44e997b3a61576ed8fc4b1c021134c27c4c
  • 作者: Andrew Gerrand adg@golang.org
  • コミット日時: 2011年11月18日 金曜日 15:22:48 +1100
  • コミットメッセージ: 
    doc: link to Chinese translation of A Tour of Go

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5415046

GitHub上でのコミットページへのリンク

https://github.com/golang/go/commit/0bbbb44e997b3a61576ed8fc4b1c021134c27c4c

元コミット内容

doc: link to Chinese translation of A Tour of Go

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5415046

変更の背景

この変更の背景には、Go言語の普及と国際化への取り組みがあります。Go言語は世界中で利用されており、特に中国語圏での開発者コミュニティの成長は顕著です。公式ドキュメントや学習リソースが英語のみである場合、非英語圏のユーザーにとっては学習の障壁となります。

「A Tour of Go」は、Go言語の基本的な概念と構文をインタラクティブに学べる非常に優れたリソースです。この重要な学習ツールが中国語に翻訳されたことで、より多くの中国語話者がGo言語に触れ、学習を開始できるようになります。このコミットは、その中国語翻訳版への公式リンクをGo言語のドキュメントページに追加することで、アクセシビリティを向上させ、Go言語コミュニティのグローバルな拡大を支援することを目的としています。

前提知識の解説

A Tour of Go

「A Tour of Go」は、Go言語の公式ウェブサイト golang.org で提供されている、Go言語の入門者向けのインタラクティブなチュートリアルです。ウェブブラウザ上でGoのコードを記述・実行しながら、Go言語の基本的な構文、データ型、制御構造、関数、メソッド、インターフェース、並行処理（goroutineとchannel）といった主要な概念を段階的に学ぶことができます。

特徴としては以下の点が挙げられます。

  • インタラクティブ性: 各セクションにはコードエディタが埋め込まれており、ユーザーはコードを直接編集し、その場で実行結果を確認できます。
  • 段階的な学習: Go言語の基礎から応用まで、体系的に構成されたレッスンを通じて学習を進めます。
  • ブラウザベース: 特別な開発環境のセットアップが不要で、インターネット接続があればどこからでも学習を開始できます。

この「Tour」は、Go言語を学び始める上で非常に効果的なツールとして広く認識されており、世界中の開発者に利用されています。

国際化とローカライゼーション

ソフトウェアやドキュメントの国際化（Internationalization, i18n）とは、異なる言語や地域に対応できるように設計するプロセスを指します。ローカライゼーション（Localization, l10n）は、特定の言語や地域の文化に合わせて製品やドキュメントを適応させるプロセスです。

このコミットは、Go言語の学習リソースを中国語にローカライズされたバージョンにリンクすることで、Go言語の国際化戦略の一環として位置づけられます。これにより、Go言語の採用と普及が非英語圏でも促進されることが期待されます。

技術的詳細

この変更は、HTMLドキュメント doc/docs.html の修正のみを含んでいます。具体的には、既存の中国語関連ドキュメントのリスト (<h3 id="docs_cn">Chinese &mdash; 中文</h3> の下にある <ul> リスト) に、新しい <li> 要素を追加しています。

追加されたHTML要素は以下の通りです。

<li><a href="http://go-tour-zh.appspot.com/">A Tour of Go</a></li>

これは、http://go-tour-zh.appspot.com/ というURLにリンクする「A Tour of Go」というテキストを持つハイパーリンクを作成します。このURLは、Go Tourの中国語翻訳版がホストされている場所を示しています。

appspot.com ドメインは、Google App Engineでホストされているアプリケーションによく使用されます。これは、Go Tourの中国語版がGoogle App Engine上で提供されていることを示唆しています。

この変更は、静的なHTMLファイルへの単純なリンク追加であり、Go言語のコードベースやビルドプロセス、ランタイム動作には影響を与えません。ウェブサイトのコンテンツを更新する標準的な手順です。

コアとなるコードの変更箇所

--- a/doc/docs.html
+++ b/doc/docs.html
@@ -130,6 +130,7 @@ Notable articles from the <a href="http://blog.golang.org/">Go Blog</a>.
 <h3 id="docs_cn">Chinese &mdash; 中文</h3>

 <ul>
+<li><a href="http://go-tour-zh.appspot.com/">A Tour of Go</a></li>
 <li><a href="http://code.google.com/p/golang-china/">golang-china</a> - a broad range of Go documentation.</li>
 <li><a href="http://code.google.com/p/ac-me/downloads/detail?name=fango.pdf">Effective Go and Tutorial</a></li>
 </ul>

コアとなるコードの解説

上記の差分は、doc/docs.html ファイルの変更を示しています。

  • --- a/doc/docs.html と +++ b/doc/docs.html は、それぞれ変更前のファイルと変更後のファイルを示します。
  • @@ -130,6 +130,7 @@ は、変更がファイルの130行目から始まり、変更前は6行、変更後は7行になることを示しています。
  • +<li><a href="http://go-tour-zh.appspot.com/">A Tour of Go</a></li> が追加された行です。

この変更は、HTMLのリスト要素 <ul> の中に新しいリストアイテム <li> を追加しています。このリストアイテムは、<a> タグ（アンカータグ）を含んでおり、これがハイパーリンクを生成します。

  • href="http://go-tour-zh.appspot.com/": リンクのターゲットURLを指定しています。このURLは「A Tour of Go」の中国語翻訳版のウェブサイトです。
  • A Tour of Go: ユーザーに表示されるリンクテキストです。

この修正により、Go言語の公式ドキュメントページ（特に中国語セクション）を閲覧するユーザーは、直接このリンクをクリックして中国語版の「A Tour of Go」にアクセスできるようになります。これは、ユーザーエクスペリエンスの向上と、Go言語の学習リソースへのアクセス性向上に直接貢献します。

関連リンク

参考にした情報源リンク