git 付属ドキュメント翻訳


# 現状
- SYNOPSISで -- が化けてた(info)のを修正(2025/1/12)
- 旧翻訳版掲載(2.41.0.337.g830b4a04c4 
, 2.38.0.rc1.246.g29c12aa140.dirty, 2.33.0.799.gbe4c877520.dirty)(2024/12/31)
- po-mode用コマンド po-ediff-previous-msgid の開発は https://github.com/kuma35/elisp へ分離しました
- po4a.cfg 対応等のため翻訳開始にはもうしばらくかかります。旧バージョン(2.41の翻訳とか)の掲載も順次行っていきます(2024/12/12)
- git version 2.47.1.404.ge66fd72e97 翻訳開始(2024/12/10)
- git version 2.41.0.337.g830b4a04c4 翻訳終了(2024/05/13)

翻訳状況:
```
status by sentence: 25035+529f+291u
progress by sentence:25035/25855(96.83%)
progress by files: 303/386
2025年  6月 21日 土曜日 11:09:49 JST
```

# 成果物

https://kuma35.github.io/git-docs-ja/

## 翻訳した箇所

Document/ フォルダ内(RelNote/ 除く)を全訳済。未校正。

technical/ 内の文書は元々はASCIIDOCのみだったのも含めて全部html化してあります。

gitの最新版の翻訳反映はぼちぼちやっていきます。

# ハイライト
2.38.0.rc1.232.gf2a34720e0.dirty に対応 (2022.10)

全訳出。未校正(2022.9)

howto 文書 全てを訳出(未校正) (2022.7)

git command 全てを訳出(未校正) (2022.7)

technical フォルダ下のドキュメントへのリンクを追加(訳出分のみ)(2022.5)
(https://kuma35.github.io/git-docs-ja/index.html)

gitの概念に関するドキュメントを訳出(2022.4)

https://kuma35.github.io/git-docs-ja/htmldocs/git.html

の Guides のところ。

git-config訳出(2022.4)

# man page 対応
man page の生成に対応しました(2022.12.10) Document-ja/ の *.1 *.5 *.7 をそれぞれコピってください(ubuntuの場合は /usr/share/man/ja/ の 対応フォルダ)
※Document/ , Document-ja/ の Makefileからinstallすると /usr/share/man 直下にインストールされるので注意
 
# 何か?
Document/ フォルダの翻訳です。

# 使い方
https://kuma35.github.io/git-docs-ja/

html版とかINSTALLテキストとかinfoとかの翻訳(未翻訳含む)置いてあります。

2.38.0.rc1.232.gf2a34720e0.dirty を表示しています (docs-ja-2ブランチ)
2.33 版は github のリポジトリをcloneして docs-ja ブランチを選択してください


# リポジトリ

https://github.com/kuma35/git-docs-ja

の「docs-ja-2」ブランチから、Documentation の翻訳が Documentation-ja フォルダに入っています。未翻訳のはそのままです。

生成したinfoやhtmlはdocsフォルダに入っています。

- infoでチェックしながら作成しています。
- 手元のinfoではロングオプション `--` をダッシュ(長ダッシュ?)に変換してしまいますので、オプションのタイトルに関してはバッククォートで囲って変換しないようにしてあります。※Synopsisの中は長ダッシュになってしまっています。今の所解決できていません。
- htmlは一応生成していますが全然チェックしていません。

## ビルド
Documentation-poフォルダ内で compile.sh を実行します。
引数は MAKEILE で受け付けるものです。何もつけなくても info がデフォルトで指定してあります。 html を指定すると html も生成します。
html生成時は内容のチェック(diff)を行い、以前とタイムスタンプ以外同じhtmlであった場合は `git restore` しています。

infoと html 以外はチェックしてないのでコケるかもしれません。

デスクトップに notify を送っています。適宜各自の環境に合せて修正してください。

## その他スクリプト
./msgcount.sh は po ファイルの全体進捗を表示します。

./msgstat.sh は仕掛り中の po ファイルを表示します。

## フォルダ構成
Documentation/ 元々あるフォルダ ASCIIDOC のテキストが入っている。po4aのパース(parse)改善の為時々この原文を修正掛けてあるので注意。

Documentation-sedout/ 主にオプションの `--` がinfoで長ダッシュに変換されてしまうのを防ぐための変換結果が入る(compile.sh中で処理)。注意：poファイルから s コマンドでソースを表示した時に見えるのは Documentation/ ではなくて この Documentation-sedout/ なので注意。いくらそれを編集しても無効。手動で対応する Documentation/ のファイルを開いて編集する必要ある。

Documentation-po/ po4aにより生成されたpoファイルがココに入る。このpoファイル群をせっせと翻訳する翻訳する。各種自作スクリプトもココに入っている。

Documantatio-ja/ 翻訳後のファイルが入る。翻訳の必要が無いファイルも Documentation/ と同じ環境を造るために自動でコピーしてくる(compile.sh)

## docs/index.html
直接編集せずに、 Documentation-po/index.html.template を編集してください。これを docs/index.html へ転送しています。

# 元

https://github.com/git/git

# なぜ訳したか

## 当時、巷には機械翻訳っぽいのが多かった
プログラマとしては、読んでコマンドなり操作の意味が分からんのは困るので、時々当該コマンドを叩きながら意訳したり。

## 持続的開発目標
流行りの SDGs です 持続的翻訳です。 巷の翻訳は大変ありがたいのですが、それを更に(自分で)更新していく方法が分かりません。

あわよくばだれかが肩代わりしてくれると嬉しいななんて思います。

こちらさんを参考にさせてもらってます。

https://qiita.com/ayatakesi/items/a8a6a9bb2df6c4511185