Merge pull request carpentries-i18n#1 from rikutakei/kozo2-patch-1

additional changes for PR

README.md

@@ -39,6 +39,75 @@ These need to be retained to merge the lessons with the main i18n repository and
 
 ## How does this work?
 
+### Using git
+
+This repository uses the tool `git` via the command line. On Linux and Mas OS, the `bash` terminal should come pre-installed. `git` may be installed but if not it can be installed as follows: 
+
+- Linux Ubuntu-based distros
+
+```
+sudo apt-get install git
+```
+
+- Linux Fedora
+
+```
+yum install git
+```
+
+or
+
+```
+sudo dnf install git-all
+```
+
+- Linux Install from Debian file
+
+Download the `.deb` file for your OS from here:
+
+https://pkgs.org/download/git
+
+```
+dpkg -i git_2.11.0-3+deb9u4_amd64.deb
+```
+
+- Linux Build from source
+
+Download the latest version of git:
+
+https://github.com/git/git/releases
+
+or
+
+https://mirrors.edge.kernel.org/pub/software/scm/git/
+
+```
+tar -zxf git-2.0.0.tar.gz
+cd git-2.0.0
+make configure
+./configure --prefix=/usr
+make all doc info
+sudo make install install-doc install-html install-info
+```
+
+- Windows
+
+Download Git for Windows (Git-Bash) by following the instructions here:
+
+https://gitforwindows.org/
+
+or
+
+https://git-scm.com/
+
+- Mac OS
+
+Install usiing homebrew (requires Xcode): https://docs.brew.sh/Installation
+
+```
+brew install git
+```
+
 ### Importing a lesson for the first time
 
 If you wish to start a translation of a lesson that has not been translated in your language before,

TranslatorGuidelines.md

@@ -0,0 +1,121 @@
+# 翻訳ガイドライン
+
+## レッスンのタイトル
+
+最初に翻訳を始めた人が決めればいいです。そのあとは統一しましょう。
+
+## 本文
+
+「です・ます調」を基本とします。
+
+直訳よりも、分かりやすいかつ自然な日本語を優先します。したがって、言葉を逐一訳す必要もなく、文章のフレーズの順番を守る必要もありません。
+
+`.po`ファイルをエディットしている時に、`\n`で改行しているように見えますが、これは本当の改行ではありあません（`.md`ファイルと同じく、一行開けることによって改行が入る）。なので、`\n`は無視して良いです（英語と日本語で`\n`の数・場所を合わせる必要はありません）。翻訳を書く際、`\n`を入れると書きやすく・見やすくなるのであれば、入れてもいいです。
+
+### 専門用語
+
+DC/SWCのレッスンは専門用語がかなり多く、複数のレッスンで同じ専門用語が使われていることがあります。統一するために単語リストを必ず使ってください。
+
+頭字語の場合は、そのまま使ってもいいですが、最初に出る時に言葉の意味を一つ一つ説明をするようにしましょう（[issue 21](https://github.com/swcarpentry-ja/i18n/issues/21)を参照）。
+
+例：コマンドラインインターフェースの核は、REPL (read-evaluate-print-loop)と呼ばれています。  
+これは、シェルにコマンドを入力し、Enter(または Return)キーを押した時に起こる動作:
+
+1.  コマンドを読み込む (read)
+2.  コマンドを実行する (または "評価する" - evaluate)
+3.  結果を出力する (print)
+4. この流れを繰り返す(loop)
+
+### 句読点
+
+「、。」を使うようにしましょう（，．ではなく）。
+
+### 数字
+
+- １桁なら全角
+
+- ２桁以上半角
+
+- 混ざっていたら通常半角
+
+- １万 が 10,000 より短くて読みやすい
+
+- 12,500 が 1万2千5百 より短くて読みやすい
+
+- 日付は半角 （8月12日 とする。８月12日 とはしない）。西暦を使うように。
+
+### 漢数字と算用数字
+
+一般的な表記法に従う（慣用的な語，数量的な意味の薄い語は漢数字 例：一人前、一種独特）
+
+### 単位
+
+- メートル法に変換
+
+- ドル以外の場合は必要に応じて日本円に換算する。（）に入れても良い
+
+- 大雑把な数字は大雑把な数字として訳して、数字の精度について誤った印象を与えないようにします。
+
+### 引用符
+
+「」 or ダブルクォートを使い、引用全体を一組の引用符で括ります。
+
+（注） ダブルクォートは、" " ではなく “ ” を使う。左側には左引用符、右側には右引用符を使います。
+
+### 外来語
+
+カタカナ語で表記が統一されていない場合は最も標準的なものを使うようにしてください。特に国語辞典に載っているような語については国語辞典の表記に従ってください。
+
+このような場合に参照する国語辞典としては広辞苑が定番ですが、あいにく広辞苑はネットで無料で使えるようになっていません。ネットで引けるものとしては三省堂の大辞林  [http://www.excite.co.jp/dictionary/japanese/](http://www.excite.co.jp/dictionary/japanese/)  や小学館の大辞泉  [http://dictionary.goo.ne.jp/jn/](http://dictionary.goo.ne.jp/jn/)  があります。
+
+国語辞典に載っていない語について最も標準的な表記を調べるには、googleで検索したときのヒット件数が参考になります。
+
+### 題名
+
+本、雑誌、記事、映画、番組、コンピューターゲームは『』でくくる。
+
+オフィシャルな訳がない作品のタイトルは訳しません。文字数が許せば『英語（日本語訳）』とするのが親切かもしれません。
+
+例：『 Visual Explanations （説明図の技法）』← 未訳の本です。説明図の技法というのは、内容を伝えるために仮に訳したタイトルです。
+
+### 固有名詞
+
+組織名称などの処理の工夫として定訳がない組織名は「英語（日本語訳）」とか、長いものなら「略語（日本語訳）」。以下のようなことを考えて、組織名称ごとに判断します。
+
+組織名、固有名詞などは、英字を維持した方が、検索しさらに勉強したい人の便宜にかなうかもしれません。（カタカナ表記してしまうと、検索してもこのレッスンだけがヒットする状況が生まれることがある。）
+
+組織名が、日本の視聴者にとって意味ある情報かを考えましょう。
+
+例えば、略称の読みが、別の単語と同じ音になっている、韻を踏んでいるなど、学生にとって意味がある場合はカッコ書きで音訳を添えるのは親切かもしれません。
+
+メロドラマのタイトルだったら、「オール・マイ・チルドレン」などと音訳するのも、雰囲気を伝える一つの手です。
+
+『戻ってきた帽子をかぶったネコ（The Cat in the Hat Comes Back）』と両方書いてあると、両方検索した段階で、実は日本語訳がないことがわかる。一読したときには、物語のタイトルとわかる。
+
+### 地名
+
+地図などで普通に使われるカタカナ表記にしましょう。
+
+### 解説・訂正
+
+日本語の文字とのバランスを考え、全角のかな文字を囲むときには、全角の（）がおすすめです。半角英数文字を囲むときには、半角の()を使ってください。　　　　　　　　　　　　　　　　　　
+
+訳者の解説は（）
+
+強調する語彙や区切り
+
+- 引用符で括ります。
+
+- 例: よく脂ののった部分はトロと呼ばれます⇒よく脂ののった部分は「トロ」と呼ばれます
+
+### 行末のダッシュ （ダッシュのうまい使い方）
+
+言い換えや挿入句であることを明示するときに使うと読みやすくなります。
+
+絶対に必要な時のみ使用し、使いすぎないようにしましょう。
+
+日本語の文字とのバランスで、全角のダッシュ「―」がおすすめです。
+
+- - - -
+
+Adapted from https://translations.ted.com/TED_日本語字幕の表記ガイドライン

po/git-novice.ja.po

@@ -17267,7 +17267,7 @@ msgstr ""
 # unordered list
 #: git-novice/index.md:18
 msgid "*   Nothing that is committed to version control is ever lost, unless"
-msgstr "*   バージョン管理にコミットされているものは失われることはありません, "
+msgstr "*   本当に消そうとしない限り、バージョン管理にコミットされているものは"
 
 #: git-novice/index.md:19
 msgid ""
@@ -17276,22 +17276,23 @@ msgid ""
 "    exactly who wrote what on a particular day, or what version of a\n"
 "    program was used to generate a particular set of results."
 msgstr ""
-"    本当に、本当にこき使いでもしない限り。古いバージョンのファイルはすべて保存されているので、\n"
-"    特定の日に誰が何を書き込んだのか、特定の結果セットを生成するためにどのバージョンのプログラムを使用したのかを\n"
-"    正確に確認するために状態を復元することは常に可能です。"
+"    失われることはありません。古いバージョンのファイルは\n"
+"    すべて保存されているため、特定の日に誰が何を書き込んだのか、\n"
+"    特定の結果を生成するためにどのバージョンのプログラムが使用されたのかなど、\n"
+"    正確に確認することが可能です。"
 
 # unordered list
 #: git-novice/index.md:24
 msgid "*   As we have this record of who made what changes when, we know who to ask"
-msgstr "*   誰が何をいつ変更したのかというこの記録を持っているので、"
+msgstr "*   誰が何をいつ変更したのかという記録があるため、後に問題が"
 
 #: git-novice/index.md:25
 msgid ""
 "    if we have questions later on, and, if needed, revert to a previous\n"
 "    version, much like the \"undo\" feature in an editor."
 msgstr ""
-"    後に問いが生じた場合に尋ねるべき人がわかり、\n"
-"    必要に応じてエディタの \"元に戻す\"機能と同じように、以前のバージョンに戻します。"
+"    生じた場合、連絡するべき人が分かる上に必要に応じて\n"
+"    \"元に戻す\"機能のように、以前のバージョンに戻すことができます。"
 
 # unordered list
 #: git-novice/index.md:28
@@ -17305,7 +17306,7 @@ msgid ""
 "    person's work and another's."
 msgstr ""
 "    間違って誰かの変更を見落としたり上書きしたりする可能性があります。\n"
-"    バージョン管理システムは、ある人の仕事と別の人の仕事との間に不一致がある場合、\n"
+"    バージョン管理システムは、二つの変更点の間に不一致がある場合、\n"
 "    自動的にユーザーに知らせてくれます。"
 
 #: git-novice/index.md:33
@@ -17316,10 +17317,11 @@ msgid ""
 "ever need to come back to the project later on (e.g., a year later,\n"
 "when memory has faded)."
 msgstr ""
-"チームのみがバージョン管理の恩恵を受けるわけではありません: 孤独な\n"
-"研究者は莫大な利益を得ることができます。何が、いつ、何故変わったのかを記録しておくことは、\n"
-"後でプロジェクトに復帰する必要が出た場合（例えば、1年後、記憶が衰えた場合など）、\n"
-"すべての研究者にとって非常に有益です。"
+"バージョン管理を使うことによって得をするのはチームだけではありません: 個人で作業をしている\n"
+"研究者にもメリットがあります。何が、いつ、何故変わったのかを\n"
+"記録しておくことは、後で昔のプロジェクトを見返すことになった場合などに\n"
+"（例えば、1年後、プロジェクトの詳細を忘れてしまった時などに）、\n"
+"非常に便利です。"
 
 # blockquote, which can be cascaded
 #: git-novice/index.md:47