Skip to content

Commit 4f41190

Browse files
kuma35kuma35
committed
translation updated. for github pages.
1 parent 4ca80be commit 4f41190

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+1353
-1549
lines changed

‎Documentation-ja/technical/commit-graph.html‎

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Git Commit-Graph Design Notes</h1>
738-
<span id="revdate">2024-12-15</span>
738+
<span id="revdate">2025-09-21</span>
739739
</div>
740740
<div id="content">
741741
<div id="preamble">
@@ -854,7 +854,7 @@ <h1>Git Commit-Graph Design Notes</h1>
854854
</p>
855855
</li>
856856
</ul></div>
857-
<div class="paragraph"><p>修正コミット日付がない場合(Git の古いバージョンや世代混合のグラフチェーンなど)、現在、このヒューリスティックは、計算がクロックスキューのためにトポロジー関係に違反することが許可されている場合に常に使用されます (デフォルトの順序での「git log」など)。ただし、トポロジーの順序が必要な場合は使用されません (マージベース計算、「git log --graph」など)。</p></div>
857+
<div class="paragraph"><p>修正コミット日付がない場合(Git の古いバージョンや混合生成グラフチェーン(mixed generation graph chains)など)、 このヒューリスティックは、 計算がクロック・スキューのためにトポロジー関係に違反することが許可されている場合に現在使用されていますが(デフォルトの順序での「git log」など)、 トポロジカルな順序が必要な場合は使用されません (マージベース計算、 <code>git</code> <code>log</code> <code>--graph</code> など)。</p></div>
858858
<div class="paragraph"><p>実際には、いくつかのコミットが最近作成され、コミットグラフに保存されていないことが予想されます。 これらのコミットを「無限」(infinite)の世代番号を持つものとして扱い、既知の世代番号を持つコミットに到達するまでウォークします。</p></div>
859859
<div class="paragraph"><p>コミットグラフファイルにないコミットをマークするには、マクロ GENERATION_NUMBER_INFINITY を使用します。 世代番号を計算しないバージョンの Git によってコミットグラフファイルが書き込まれた場合、それらのコミットには、マクロ GENERATION_NUMBER_ZERO = 0 で表される世代番号が含まれます。</p></div>
860860
<div class="paragraph"><p>コミットグラフファイルは到達可能な状態で閉じられているため、すべてのコミットで以下のより弱い条件を保証できます:</p></div>
@@ -890,7 +890,7 @@ <h2 id="_design_details">Design Details</h2>
890890
</li>
891891
<li>
892892
<p>
893-
Commit grafts and replace objects can change the shape of the commit history. The latter can also be enabled/disabled on the fly using <code>--no-replace-objects</code>. This leads to difficulty storing both possible interpretations of a commit id, especially when computing generation numbers. The commit-graph will not be read or written when replace-objects or grafts are present.
893+
コミット グラフト(grafts;接ぎ木)と置換オブジェクト(replace objects)は、コミット履歴の形状を変更することができます。 置換オブジェクトは、 <code>--no-replace-objects</code> を使用してリアルタイム(on the fly)で 有効/無効 にすることもできます。 これにより、特に世代番号を計算するときに、コミット ID の可能な両方の解釈を保存することが難しくなります。 コミットグラフは、置換オブジェクト(replace-objects)またはグラフト(grafts;接ぎ木)が存在する場合、読み書きされません。
894894
</p>
895895
</li>
896896
<li>
@@ -909,8 +909,12 @@ <h2 id="_commit_graphs_chains">Commit Graphs Chains</h2>
909909
<h3 id="_file_layout">File Layout</h3>
910910
<div class="paragraph"><p>コミットグラフチェーンは複数のファイルを使用し、固定の命名規則を使用してこれらのファイルを整理します。 各コミットグラフファイルには、 <code>$OBJDIR/info/commit-graphs/graph-</code>{hash}.graph という名前があります。ここで、{hash} は、そのファイルのフッターに格納されている16進数値のハッシュです(これは、そのハッシュの前のファイルの内容のハッシュです)。 コミットグラフファイルのチェーンの場合、<code>$OBJDIR/info/commit-graphs/commit-graph-chain</code> にあるプレーンテキスト ファイルには、ファイルのハッシュが「最低」(lowest)から「最高」(highest)の順に含まれています。</p></div>
911911
<div class="paragraph"><p>例えば、 <code>commit-graph-chain</code> ファイルが以下の行達を含んでいるのならば</p></div>
912-
<div class="paragraph"><p>```
913-
```</p></div>
912+
<div class="listingblock">
913+
<div class="content">
914+
<pre><code>{hash0}
915+
{hash1}
916+
{hash2}</code></pre>
917+
</div></div>
914918
<div class="paragraph"><p>コミットグラフ チェイン は以下の図のようになります:</p></div>
915919
<div class="listingblock">
916920
<div class="content">
@@ -934,8 +938,7 @@ <h3 id="_file_layout">File Layout</h3>
934938
| |
935939
+-----------------------+</code></pre>
936940
</div></div>
937-
<div class="paragraph"><p>Let X0 be the number of commits in <code>graph-</code>{hash0}.graph, X1 be the number of commits in <code>graph-</code>{hash1}.graph, and X2 be the number of commits in <code>graph-</code>{hash2}.graph. If a commit appears in position i in <code>graph-</code>{hash2}.graph, then we interpret this as being the commit in position (X0 + X1 + i), and that will be used as its "graph position". The commits in <code>graph-</code>{hash2}.graph use these positions to refer to their parents, which may be in <code>graph-</code>{hash1}.graph or <code>graph-</code>{hash0}.graph. We can navigate to an arbitrary commit in position j by checking its containment in the intervals [0, X0), [X0, X0 + X1), [X0 + X1, X0 + X1<br />
938-
X2).</p></div>
941+
<div class="paragraph"><p>X0 を <code>graph-</code>{hash0}.graph のコミット数、 X1 を <code>graph-</code>{hash1}.graph のコミット数、 X2 を <code>graph-</code>{hash2}.graph のコミット数とします。 あるコミットが <code>graph-</code>{hash2}.graph の i 番目の位置にある場合、私達はこれをコミット位置 (X0 + X1 + i) であると解釈し、それを「グラフの位置」(graph position)として使用します。 <code>graph-</code>{hash2}.graph のコミットは、これらの位置を使用して、 <code>graph-</code>{hash1}.graph または <code>graph-</code>{hash0}.graph にある親を参照します。 半開間隔 [<code>0,</code> <code>X0</code>)<code>,</code> [<code>X0,</code> <code>X0</code> <code>+</code> <code>X1</code>)<code>,</code> [<code>X0</code> <code>+</code> <code>X1,</code> <code>X0</code> <code>+</code> <code>X1</code> <code>+</code> <code>X2</code>) の区間に含まれることを確認することにより、位置 j の任意のコミットに移動できます(訳注: 半開区間 [<code>a,</code> <code>b</code>) は <code>a</code> ≦ <code>x</code> &lt; <code>b</code> を表す)。</p></div>
939942
<div class="paragraph"><p>各コミットグラフファイル(ベースの <code>graph-</code>{hash0}.graph を除く)には、下位層のすべてのファイルのハッシュを指定するデータが含まれています。 上記の例では、<code>graph-</code>{hash1}.graph には {hash0} が含まれ、 <code>graph-</code>{hash2}.graph には {hash0} と {hash1} が含まれます。</p></div>
940943
</div>
941944
<div class="sect2">
@@ -971,8 +974,11 @@ <h3 id="_merging_commit_graph_files">Merging commit-graph files</h3>
971974
+-----------------------+</code></pre>
972975
</div></div>
973976
<div class="paragraph"><p>この処理中に、書き込みコミットが結合、ソートされ、内容が一時ファイルに書き込まれますが、すべて <code>commit-graph-chain.lock</code> ロックファイルが保持されます。 ファイルがフラッシュされると、計算された {hash3} に従って名前を <code>graph-</code>{hash3} に変更します。 最後に、新しいチェーンデータを <code>commit-graph-chain.lock</code> に書き込みます:</p></div>
974-
<div class="paragraph"><p>```
975-
```</p></div>
977+
<div class="listingblock">
978+
<div class="content">
979+
<pre><code>{hash3}
980+
{hash0}</code></pre>
981+
</div></div>
976982
<div class="paragraph"><p>そして、ロックファイルをクローズします。</p></div>
977983
</div>
978984
<div class="sect2">
@@ -1094,7 +1100,7 @@ <h2 id="_related_links">Related Links</h2>
10941100
<div id="footer">
10951101
<div id="footer-text">
10961102
Last updated
1097-
2024-12-15 12:50:11 JST
1103+
2025-09-21 21:26:05 JST
10981104
</div>
10991105
</div>
11001106
</body>

‎Documentation-ja/technical/commit-graph.txt‎

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ Git は、以下のような多くの理由でコミットグラフをたどり
5757

5858
* A と B がそれぞれコミット時間 X と Y でコミットされており、X < Y の場合、A は「おそらく」 B に到達できません。
5959

60-
修正コミット日付がない場合(Git の古いバージョンや世代混合のグラフチェーンなど)、現在、このヒューリスティックは、計算がクロックスキューのためにトポロジー関係に違反することが許可されている場合に常に使用されます (デフォルトの順序での「git log」など)。ただし、トポロジーの順序が必要な場合は使用されません (マージベース計算、「git log --graph」など)。
60+
修正コミット日付がない場合(Git の古いバージョンや混合生成グラフチェーン(mixed generation graph chains)など)、 このヒューリスティックは、 計算がクロック・スキューのためにトポロジー関係に違反することが許可されている場合に現在使用されていますが(デフォルトの順序での「git log」など)、 トポロジカルな順序が必要な場合は使用されません (マージベース計算、 `git log --graph` など)。
6161

6262
実際には、いくつかのコミットが最近作成され、コミットグラフに保存されていないことが予想されます。 これらのコミットを「無限」(infinite)の世代番号を持つものとして扱い、既知の世代番号を持つコミットに到達するまでウォークします。
6363

@@ -80,7 +80,7 @@ Git は、以下のような多くの理由でコミットグラフをたどり
8080

8181
- ファイル形式には、オブジェクトIDハッシュ関数のパラメーターが含まれているため、今後ハッシュアルゴリズムを変更しても、形式を変更する必要はありません。
8282

83-
- Commit grafts and replace objects can change the shape of the commit history. The latter can also be enabled/disabled on the fly using `--no-replace-objects`. This leads to difficulty storing both possible interpretations of a commit id, especially when computing generation numbers. The commit-graph will not be read or written when replace-objects or grafts are present.
83+
- コミット グラフト(grafts;接ぎ木)と置換オブジェクト(replace objects)は、コミット履歴の形状を変更することができます。 置換オブジェクトは、 `--no-replace-objects` を使用してリアルタイム(on the fly)で 有効/無効 にすることもできます。 これにより、特に世代番号を計算するときに、コミット ID の可能な両方の解釈を保存することが難しくなります。 コミットグラフは、置換オブジェクト(replace-objects)またはグラフト(grafts;接ぎ木)が存在する場合、読み書きされません。
8484

8585
- 浅いクローン(shallow clones)は、親を削除することでコミットのグラフト(grafts;接ぎ木)を作成します。 これにより、コミットグラフは、これらのコミットの世代番号が 1 であると考えるようになります。これらのコミットが浅くされていない場合(unshallow)、それらの世代番号は無効になります。 浅いクローンはコミット履歴を非常に小さなコミットのセットに制限することを目的としているため、コミットグラフ機能はこれらのクローンにはあまり役に立ちません。 浅いコミットが存在する場合、コミットグラフは読み書きされません。
8686

@@ -95,11 +95,11 @@ Git は、以下のような多くの理由でコミットグラフをたどり
9595

9696
例えば、 `commit-graph-chain` ファイルが以下の行達を含んでいるのならば
9797

98-
```
99-
{hash0}
100-
{hash1}
101-
{hash2}
102-
```
98+
----
99+
{hash0}
100+
{hash1}
101+
{hash2}
102+
----
103103

104104
コミットグラフ チェイン は以下の図のようになります:
105105

@@ -125,8 +125,8 @@ Git は、以下のような多くの理由でコミットグラフをたどり
125125
+-----------------------+
126126
----
127127

128-
Let X0 be the number of commits in `graph-{hash0}.graph`, X1 be the number of commits in `graph-{hash1}.graph`, and X2 be the number of commits in `graph-{hash2}.graph`. If a commit appears in position i in `graph-{hash2}.graph`, then we interpret this as being the commit in position (X0 + X1 + i), and that will be used as its "graph position". The commits in `graph-{hash2}.graph` use these positions to refer to their parents, which may be in `graph-{hash1}.graph` or `graph-{hash0}.graph`. We can navigate to an arbitrary commit in position j by checking its containment in the intervals [0, X0), [X0, X0 + X1), [X0 + X1, X0 + X1 +
129-
X2).
128+
X0 を `graph-{hash0}.graph` のコミット数、 X1 を `graph-{hash1}.graph` のコミット数、 X2 を `graph-{hash2}.graph` のコミット数とします。 あるコミットが `graph-{hash2}.graph` の i 番目の位置にある場合、私達はこれをコミット位置 (X0 + X1 + i) であると解釈し、それを「グラフの位置」(graph position)として使用します。 `graph-{hash2}.graph` のコミットは、これらの位置を使用して、 `graph-{hash1}.graph` または `graph-{hash0}.graph` にある親を参照します。 半開間隔 `[0, X0), [X0, X0 + X1), [X0 + X1, X0 + X1 + X2)` の区間に含まれることを確認することにより、位置 j の任意のコミットに移動できます(訳注: 半開区間 `[a, b)` は `a ≦ x < b` を表す)。
129+
130130

131131
各コミットグラフファイル(ベースの `graph-{hash0}.graph` を除く)には、下位層のすべてのファイルのハッシュを指定するデータが含まれています。 上記の例では、`graph-{hash1}.graph` には `{hash0}` が含まれ、 `graph-{hash2}.graph` には `{hash0}` と `{hash1}` が含まれます。
132132

@@ -166,10 +166,10 @@ X2).
166166

167167
この処理中に、書き込みコミットが結合、ソートされ、内容が一時ファイルに書き込まれますが、すべて `commit-graph-chain.lock` ロックファイルが保持されます。 ファイルがフラッシュされると、計算された `{hash3}` に従って名前を `graph-{hash3}` に変更します。 最後に、新しいチェーンデータを `commit-graph-chain.lock` に書き込みます:
168168

169-
```
170-
{hash3}
171-
{hash0}
172-
```
169+
----
170+
{hash3}
171+
{hash0}
172+
----
173173

174174
そして、ロックファイルをクローズします。
175175

‎Documentation-ja/technical/hash-function-transition.html‎

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -735,7 +735,7 @@
735735
<body class="article">
736736
<div id="header">
737737
<h1>Git hash function transition</h1>
738-
<span id="revdate">2024-12-15</span>
738+
<span id="revdate">2025-09-21</span>
739739
</div>
740740
<div id="content">
741741
<div class="sect1">
@@ -751,12 +751,12 @@ <h2 id="_background">Background</h2>
751751
<div class="ulist"><ul>
752752
<li>
753753
<p>
754-
整合性チェックが簡単です。 たとえば、破損したコンテンツのハッシュはその名前と一致しないため、ビット反転(bit flips)は簡単に検出されます。
754+
整合性チェックが簡単です。 たとえば、 破損したコンテンツのハッシュを計算すると、 そのコンテンツの名前としてのハッシュ値と一致しないため、 ビット反転(bit flips)は簡単に検出できます。
755755
</p>
756756
</li>
757757
<li>
758758
<p>
759-
オブジェクトのルックアップは高速です。
759+
オブジェクトの検索(lookup)が高速です。
760760
</p>
761761
</li>
762762
</ul></div>
@@ -927,7 +927,7 @@ <h2 id="_detailed_design">Detailed Design</h2>
927927
<div class="sectionbody">
928928
<div class="sect2">
929929
<h3 id="_repository_format_extension">Repository format extension</h3>
930-
<div class="paragraph"><p>A SHA-256 repository uses repository format version <code>1</code> (see <a href="../gitrepository-layout.html">gitrepository-layout(5)</a>) with <code>extensions.objectFormat</code> and <code>extensions.compatObjectFormat</code> (see <a href="../git-config.html">git-config(1)</a>) set to:</p></div>
930+
<div class="paragraph"><p>SHA-256 リポジトリーは、 リポジトリー・フォーマット・バージョン <code>1</code> を使用します(<a href="../gitrepository-layout.html">gitrepository-layout(5)</a> 参照)。 <code>extensions.objectFormat</code> および <code>extensions.compatObjectFormat</code> (<a href="../git-config.html">git-config(1)</a> 参照)は以下のとおり設定されます:</p></div>
931931
<div class="literalblock">
932932
<div class="content">
933933
<pre><code>[core]
@@ -936,7 +936,7 @@ <h3 id="_repository_format_extension">Repository format extension</h3>
936936
objectFormat = sha256
937937
compatObjectFormat = sha1</code></pre>
938938
</div></div>
939-
<div class="paragraph"><p>core.repositoryFormatVersion=1` の設定と <code>extensions.</code>* の設定の組み合わせにより、<code>v0.99.9l</code> より後のバージョンの Git は SHA-256 リポジトリで操作しようとせずに死んでしまい、代わりにエラーメッセージを出すようになります。</p></div>
939+
<div class="paragraph"><p><code>core.repositoryFormatVersion=1</code> の設定と <code>extensions.</code>* の設定の組み合わせにより、<code>v0.99.9l</code> より後のバージョンの Git は SHA-256 リポジトリで操作しようとせずに死んでしまい、代わりにエラーメッセージを出すようになります。</p></div>
940940
<div class="literalblock">
941941
<div class="content">
942942
<pre><code># Between v0.99.9l and v2.7.0
@@ -953,8 +953,8 @@ <h3 id="_repository_format_extension">Repository format extension</h3>
953953
<div class="sect2">
954954
<h3 id="_object_names">Object names</h3>
955955
<div class="paragraph"><p>オブジェクトは、40 桁の 16 進数の SHA-1 名または 64 桁の 16 進数の SHA-256 名、およびそれらから派生した名前で名前を付けることができます (gitrevisions(7) 参照)。</p></div>
956-
<div class="paragraph"><p>オブジェクトの SHA-1 名は、そのタイプ、長さ、ヌルバイト、およびオブジェクトの SHA-1 コンテンツを連結した the SHA-1 です。 これは、Git でオブジェクトに名前を付けるために使用される従来の &lt;sha1&gt; です。</p></div>
957-
<div class="paragraph"><p>オブジェクトの SHA-256 名は、そのタイプ、長さ、ヌルバイト、およびオブジェクトの SHA-256 コンテンツを連結した the SHA-256 です。</p></div>
956+
<div class="paragraph"><p>オブジェクトの SHA-1 名は、そのタイプ、長さ、ヌルバイト、およびオブジェクトの SHA-1 コンテンツを連結したものの SHA-1 です。 これは、Git でオブジェクトに名前を付けるために使用される従来の &lt;sha1&gt; です。</p></div>
957+
<div class="paragraph"><p>オブジェクトの SHA-256 名は、そのタイプ、長さ、ヌルバイト、およびオブジェクトの SHA-256 コンテンツを連結したものの SHA-256 です。</p></div>
958958
</div>
959959
<div class="sect2">
960960
<h3 id="_object_format">Object format</h3>
@@ -1521,6 +1521,7 @@ <h2 id="_transition_plan">Transition plan</h2>
15211521
</li>
15221522
<li>
15231523
<p>
1524+
<code>^</code>{sha1} と <code>^</code>{sha256} リビジョン表記
15241525
</p>
15251526
</li>
15261527
<li>
@@ -1739,7 +1740,7 @@ <h3 id="_references">References</h3>
17391740
<div id="footer">
17401741
<div id="footer-text">
17411742
Last updated
1742-
2024-12-15 12:50:11 JST
1743+
2025-10-08 00:16:43 JST
17431744
</div>
17441745
</div>
17451746
</body>

0 commit comments

Comments
 (0)