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

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

このコミットは、Go言語の公式ドキュメントサイトに「A Tour of Go」の日本語版へのリンクを追加するものです。これにより、日本のGo言語学習者がよりアクセスしやすくなります。

コミット

commit 8a7b2b2f7060427890143fb7263d231acf689bb3
Author: Andrew Gerrand <adg@golang.org>
Date:   Fri Oct 28 10:55:58 2011 +0900

    doc: A Tour of Go in Japanese
    
    R=golang-dev, dsymonds
    CC=golang-dev
    https://golang.org/cl/5318058
---
 doc/docs.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/docs.html b/doc/docs.html
index 45a8a05e1a..43c2034ff6 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -157,6 +157,7 @@ Notable articles from the <a href="http://blog.golang.org/">Go Blog</a>.
 
 <h3 id="docs_jp">Japanese &mdash; 日本語</h3>
 <ul>
+<li><a href="http://go-tour-jp.appspot.com/">A Tour of Go</a></li>
 <li><a href="http://golang.jp/">golang.jp</a> - Go documentation and news.</li>
 </ul>

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

https://github.com/golang/go/commit/8a7b2b2f7060427890143fb7263d231acf689bb3

元コミット内容

このコミットは、Go言語の公式ドキュメントに「A Tour of Go」の日本語版へのリンクを追加するものです。具体的には、doc/docs.htmlファイルに1行の変更が加えられ、日本語ドキュメントセクションに新しいリンクが挿入されています。

変更の背景

「A Tour of Go」は、Go言語の公式なインタラクティブな入門チュートリアルであり、Go言語の主要な機能についてスライドと演習を通じて学ぶことができます。Go言語の普及と学習を促進するためには、英語以外の言語でのリソース提供が不可欠です。

このコミットが行われた2011年当時、Go言語はまだ比較的新しい言語であり、世界中の開発者コミュニティでその採用を促進することが重要でした。特に、日本のような非英語圏の国々では、母国語で学習できるリソースの存在が学習障壁を大きく下げることになります。

この変更は、Go言語の公式ドキュメントサイトから直接日本語版の「A Tour of Go」にアクセスできるようにすることで、日本のGo開発者コミュニティの成長を支援し、Go言語のグローバルな普及を加速させることを目的としています。

前提知識の解説

A Tour of Go

「A Tour of Go」は、Go言語の公式なインタラクティブなチュートリアルです。Go言語の基本的な構文、データ型、制御フロー、関数、メソッド、インターフェース、並行処理（goroutineとchannel）といった主要な概念を、短いスライドとブラウザ上で直接実行できるコード例を通じて学ぶことができます。

このツアーは、Go言語の学習者が実際にコードを書きながら理解を深められるように設計されており、Go言語の学習パスにおいて非常に重要な位置を占めています。オンライン版はhttps://tour.golang.orgで提供されており、ローカル環境にインストールしてオフラインで利用することも可能です。

golang.jp

golang.jpは、日本のGo言語コミュニティに関連する情報やドキュメントを提供するウェブサイトです。このコミットが行われた時点では、Go言語に関する日本語の情報源として重要な役割を担っていました。公式ドキュメントサイトからgolang.jpへのリンクが既に存在していたことから、Goチームが日本のコミュニティ活動を認識し、支援していたことが伺えます。

技術的詳細

このコミットの技術的な変更は非常にシンプルですが、Go言語の公式ドキュメントの構造と、新しいリソースをどのように統合するかという点を示しています。

Go言語の公式ドキュメントは、ウェブサイトの静的なHTMLファイルとして提供されています。doc/docs.htmlファイルは、Go言語に関する様々なドキュメントやリソースへのリンクをまとめたインデックスページのような役割を果たしています。

このコミットでは、doc/docs.html内の<h3 id="docs_jp">Japanese — 日本語</h3>という見出しの下にある<ul>（順不同リスト）要素に、新しい<li>（リストアイテム）が追加されています。このリストアイテムには、日本語版「A Tour of Go」へのハイパーリンクが含まれています。

具体的には、以下のHTMLコードが追加されました。

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

ここで注目すべきは、リンク先のURLがhttp://go-tour-jp.appspot.com/となっている点です。appspot.comはGoogle App Engineでホストされているアプリケーションのドメインであり、当時の日本語版「A Tour of Go」がGoogle App Engine上で提供されていたことを示唆しています。これは、Go言語がGoogleによって開発された背景と、Googleのインフラストラクチャが活用されていたことを反映しています。

この変更により、Go言語の公式ドキュメントを閲覧している日本のユーザーは、直接このページから日本語版のインタラクティブなチュートリアルにアクセスできるようになり、学習体験が向上します。

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

diff --git a/doc/docs.html b/doc/docs.html
index 45a8a05e1a..43c2034ff6 100644
--- a/doc/docs.html
+++ b/doc/docs.html
@@ -157,6 +157,7 @@ Notable articles from the <a href="http://blog.golang.org/">Go Blog</a>.
 
 <h3 id="docs_jp">Japanese &mdash; 日本語</h3>
 <ul>
+<li><a href="http://go-tour-jp.appspot.com/">A Tour of Go</a></li>
 <li><a href="http://golang.jp/">golang.jp</a> - Go documentation and news.</li>
 </ul>

コアとなるコードの解説

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

  • --- a/doc/docs.htmlと+++ b/doc/docs.htmlは、それぞれ変更前のファイルと変更後のファイルを示します。
  • @@ -157,6 +157,7 @@は、変更がファイルの157行目から始まり、変更前は6行、変更後は7行に影響することを示しています。
  • 変更内容は、既存の日本語ドキュメントセクション（<h3 id="docs_jp">Japanese — 日本語</h3>とそれに続く<ul>リスト）の中に、新しいリストアイテムが追加されたことです。
  • 具体的には、<li><a href="http://go-tour-jp.appspot.com/">A Tour of Go</a></li>という行が挿入されています。これは、A Tour of Goというテキストが表示され、クリックするとhttp://go-tour-jp.appspot.com/へ遷移するハイパーリンクを作成します。
  • この変更により、Go言語の公式ドキュメントの日本語セクションに、日本語版「A Tour of Go」への直接リンクが追加され、ユーザーが容易にアクセスできるようになりました。

関連リンク

参考にした情報源リンク