Update metadata to match lessons

.gitignore

@@ -0,0 +1 @@
+locale/

.gitmodules

@@ -4,3 +4,21 @@
 [submodule "shell-novice"]
 	path = shell-novice
 	url = https://github.com/swcarpentry-i18n/shell-novice.git
+[submodule "r-novice-inflammation"]
+	path = r-novice-inflammation
+	url = https://github.com/swcarpentry/r-novice-inflammation.git
+[submodule "r-novice-gapminder"]
+	path = r-novice-gapminder
+	url = https://github.com/swcarpentry/r-novice-gapminder.git
+[submodule "python-novice-gapminder"]
+	path = python-novice-gapminder
+	url = https://github.com/swcarpentry/python-novice-gapminder.git
+[submodule "python-novice-inflammation"]
+	path = python-novice-inflammation
+	url = https://github.com/swcarpentry/python-novice-inflammation.git
+[submodule "sql-novice-survey"]
+	path = sql-novice-survey
+	url = https://github.com/swcarpentry/sql-novice-survey.git
+[submodule "po4gitbook"]
+	path = po4gitbook
+	url = https://github.com/swcarpentry-i18n/po4gitbook.git

ChangeLog.md

@@ -0,0 +1,22 @@
+## git-novice
+
+- Demonstration of git-novice lesson initialised
+    - assets for Japanese developed
+    - some example translations have been done
+
+- Demonstration of Japanese lesson
+    - these show that the system is compatible with CJK fonts
+    - all translations so far will need to be double-checked
+    - extra care will be needed for the `lang.md` assets since
+      these will be used across different lessons
+
+### to do
+
+- check example translations
+
+- import translation files for other lessons
+
+- decide who will be working on each lesson (or subsection)
+
+- discuss peer-review or culture changes on GitHub
+    - non-literal translation are ok (for example characters Japanese people may not know)

CultureNotes.md

@@ -0,0 +1,18 @@
+# Culture Notes for Japanese lessons
+
+- non-literal translation are ok (for example characters Japanese people may not know)
+
+- please document them here to ensure that we are consistent throughout lessons
+
+- if you have a suggestion please discuss it as an issue on GitHub 
+
+- Give Gregorian calendar dates in the order year, month, day, and following typical
+  Japanese usage, use ``yyyy.mm.dd`` over the ISO standard using ``yyyy-mm-dd``.
+
+- Avoid dates using the Japanese era name (年号, nengou), e.g. 2018 is "Heisei 30".
+
+## git-novice
+
+- the characters "Wolfman" and "Dracula" may not be well-known in Japan
+    - the characters ドラえもん(Doraemon) and のび太(Nobita) will be used instead
+    - these are widely known and in tone with the fun nature of the English characters

README.md

@@ -1,19 +1,111 @@
 # Internationalisation of carpentry lessons
 
-## How does this work?
-
-1. Add a submodule for the lessons that you want to translate
-1. Run `po4gitbook/update.sh` - That creates/updates the `po` directory with the `.pot` files to use in translations.
-1. Create a `po` file and start translating!
- - copy `<file>.pot` to `<file>.<lang>.po`. e.g.,
- ```bash
- cd po
- cp shell-novice.pot shell-novice.es.po
- ```
- - Edit the file with your favourite po editor ([PoEdit](http://www.poedit.net),
- [GTranslator](https://wiki.gnome.org/Apps/Gtranslator), [Lokalize](https://userbase.kde.org/Lokalize), ...)
-   Note:
-    - "`Language`" field is needed to add to the header (at least with gtranslator), the rest is put by the tool.
-    - "`Language-Team:`" needs the first letter in upper case (e.g., `Es`)
- - Create `po/LINGUAS`
- - run `po4gitbook/compile.sh` - This creates a `locale/<lang>/<lesson>` tree directory
+Please take a look at the [quickstart guide](quickstart.md) if you wish to make small contribution(s).
+
+Before translating any material, please make sure you comply with the [Guidelines for Translators](TranslatorGuidelines.md) and read the [Rules of Conduct](rules.md).
+
+We encourage translators to [join our slack channel](https://r-wakalang.herokuapp.com/), #swcarpentry in the Tokyo.R workspace. This is a great place to ask any questions you may have about the workflow.
+
+## Purpose
+
+The repository is intended to host the files and tools need to facilitate translations of the [Software Carpentry](https://software-carpentry.org/) lessons
+from English into other languages (currently we are working on Japanese). This repository is intended to merge with the Multi-lingual versions of the lessons
+in English and Spanish. We plan for these to be compatible to be hosted along with other languages on the main
+Software Carpentry website and to maintain updated copies of the Japanese lessons with new releases of the
+English lessons.
+
+We are translating (and keeping up-to-date) the Software Carpentry lessons, not revising original lesson material.
+If you notice an issue with the lesson materials themselves, please send an issue for pull request to the English lesson materials.
+
+## About git
+
+This assumes that you are familiar with using Git and GitHub.
+
+If you need help installing git, please see the [guide on installing git](git.md).
+
+## About PO files
+
+We use [PO files](https://www.gnu.org/software/gettext/manual/html_node/PO-Files.html) for translation, rather than translating the text of each lesson directly. A PO file is a plain text file consisting of multiple entries, where each entry contains a short portion of the original text and its translation. There is one PO file for each original lesson. For example, the [Software Carpentry 'git novice' lesson](https://github.com/swcarpentry/git-novice), which consists of multiple markdown documents, has a single PO file called `git-novice.ja.po` for translating into Japanese.
+
+This way, we can keep track of the original text and know exactly what needs to be changed when the original lessons are updated, instead of manually tracking changes.
+
+There are a number of free PO editors: [PoEdit](http://www.poedit.net),
+[GTranslator](https://wiki.gnome.org/Apps/Gtranslator), [Lokalize](https://userbase.kde.org/Lokalize), to name a few. We recommend using one of these to edit the PO files.
+
+## Importing a lesson for the first time
+
+Lessons are imported as submodules. This only needs to happen once per lesson, so most translators will not need to do this. If you want to import a new lesson, please see the [guide on importing](importing.md).
+
+## Contributing to a translation of an existing lesson
+
+**This is the task that we need the most help with from translators!**
+
+This assumes that the lesson has already been added to the `swcarpentry-ja/i18n` as a submodule as described in the [guide on importing](importing.md), and you would like to contribute translations for that lesson.
+
+1. Create a "Fork" for this repository on your personal GitHub account. (Click "Fork" in the top right
+  corner of the `https://github.com/swcarpentry-ja/i18n` webpage)
+
+2. Clone this repository from your personal account (e.g., GitHubUser). This is your local copy to manage your version of
+ the translation files.
+
+```
+cd directory
+git clone [email protected]:GitHubUser/i18n.git
+cd i18n
+```
+
+3. Populate submodules.
+
+```
+git submodule init
+git submodule update
+```
+
+This repository should already contain a translation file for the lesson that you wish to contribute to in the `po` directory `<lesson-name>.<lang>.po` such as `git-novice.ja.po`
+
+```bash
+cd po
+ls git-novice.ja.po
+```
+
+4. Edit the PO files. [As per the guidelines](rules.md), please commit your changes frequently and submit a pull request when you are satisfied with your work.
+
+5. Your PR will be reviewed for accuracy. You may need to make edits so it can pass review. When doing so, always be sure to pull changes from the organisation repository first:
+
+```
+git checkout ja
+git remote add swc-ja [email protected]:swcarpentry-ja/i18n.git
+git pull swc-ja ja
+```
+
+Repeat steps 4 and 5 until the PR passes review.
+
+A few notes:
+
+Editing the PO file will not generate the translated website. That is left to the maintainers, as described in the [guide for maintainers and administrators](admin.md).
+
+If you want to see a translated MD file after editing the PO file, run `bash po4gitbook/compile.sh`. This generates a translated version of the lesson with your changes, which you can find at `locale/<lang>/<lesson>`, e.g., `locale/ja/git-novice`.
+
+## Contributing to translation of an updated lesson with a new release of the main English lessons
+
+If there is an existing (complete) translation of the lesson but
+  there has a new release of the main English lessons, the updated version
+  of the English lessons needs to be merged with the current translated one.
+
+Please see the [guide on updating lessons](updating.md).
+
+## Resources for translations
+
+Please follow [guidelines for translators](TranslatorGuidelines.md) when editing the lessons.
+
+There is a [list of technical terms](https://github.com/swcarpentry-ja/i18n/wiki/Glossary-for-technical-terms) to refer to for ensuring that terms are consistently used between lessons. Please update and refer to this as needed.
+
+Please see the [culture notes](CultureNotes.md) for a standardized treatment of concepts that don't translate literally into Japanese to ensure consistency.
+
+We have a [change log](ChangeLog.md) to track progress and goals.
+
+## Guide for maintainers and administrators
+
+Please see the [guide for maintainers and administrators](admin.md)
+
+Thank you for all your help. Even seemingly minor contributions will be appreciated!

TranslatorGuidelines.md

@@ -0,0 +1,133 @@
+# 翻訳ガイドライン
+
+## レッスンのタイトル
+
+最初に翻訳を始めた人が決めます。
+そのあとは統一しましょう。
+
+## 本文
+
+「です・ます調」を基本とします。
+
+直訳よりも、分かりやすいかつ自然な日本語を優先します。
+したがって、言葉を逐一訳す必要もなく、文章のフレーズの順番を守る必要もありません。
+
+`.po`ファイルを編集している時に、`\n`で改行しているように見えますが、これは本当の改行ではありあません（`.md`ファイルと同じく、一行開けることによって改行が入る）。
+なので、`\n`は無視して下さい（英語と日本語で`\n`の数・場所を合わせる必要はありません）。
+翻訳をする際、`\n`を入れると書きやすく・見やすくなるのであれば、入れても構いません。
+
+### 専門用語
+
+DC/SWCのレッスンは専門用語がかなり多く、複数のレッスンで同じ専門用語が使われていることがあります。
+統一するために[単語リスト](https://github.com/swcarpentry-ja/i18n/wiki/Glossary-for-technical-terms)を必ず使ってください。
+
+頭字語の場合は、そのまま使ってもいいですが、最初に出る時に言葉の意味を一つ一つ説明をするようにしましょう（[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_日本語字幕の表記ガイドライン

Translators.md

@@ -0,0 +1,65 @@
+Team lead (co-ordinator)
+
+* [Tom Kelly][kelly_tom]: Postdoctoral Researcher (RIKEN IMS, Yokohama, Japan)
+    * GitHub [@TomKellyGenetics](https://github.com/TomKellyGenetics)
+    * Twitter [@tomkXY](https://twitter.com/tomkxy)
+
+Members
+
+* [Riku Takei][takei_riku]: Assistant Research Fellow (University of Otago, Dunedin, New Zealand)
+  * Lesson organiser and moderator (Git)
+  * GitHub: [@rikutakei](https://github.com/rikutakei)
+  * Twitter: [@rikutakei](http://twitter.com/rikutakei)
+
+* [Joel Nitta][nitta_joel]: Postdoctoral Researcher (Smithsonian National Museum of Natural History, Washington DC, USA)
+  * Reveiwer and technical support
+  * GitHub: [@joelnitta](https://github.com/joelnitta)
+  * Twitter: [@joel_nitta](http://twitter.com/joel_nitta)  
+  * [Homepage](https://joelnitta.com)  
+
+* [Maki Arakaki][arakaki_maki] (Tokyo, Japan)
+  * Lesson organiser and moderator (R gapminder)
+  * GitHub: [@rkkmk](https://github.com/rkkmk)
+
+* [Daichi Saito][saito_daichi] (Tokyo, Japan)
+  * Lesson contributor (R gapminder)
+  * GitHub: [@DaichiSaitoAF](https://github.com/DaichiSaitoAF)
+  * Twitter: [@daichibaa](http://github.com/daichibaa)
+
+* [Atsushi Yamamoto][yamamoto_atsushi] (Okayama, Japan)
+  * Lesson contributor (R gapminder)
+  * GitHub: [@atusy](https://github.com/atusy)
+  * Twitter: [@Atsushi776](http://github.com/Atsushi776)
+
+* [Kyoko Matsumura][matsumura_kyoko] (Tokyo, Japan)
+  * Lesson organiser and moderator (Shell)
+  * GitHub: [@kyyonko](https://github.com/kyyonko)
+  * Twitter: [@kyyonko](http://twitter.com/kyyonko)
+
+* [Kozo Nishida][nishida_kozo]: Technical Scientist (RIKEN BDR, Osaka, Japan) 
+  * Lesson organiser and moderator (Python)
+  * GitHub: [@kozo2](https://github.com/kozo2)
+  * Twitter: [@kozo2](http://twitter.com/kozo2)
+
+* [Manabu Ishii][ishii_manabu]: Technical Scientist (RIKEN BDR, Wako, Japan)
+  * Translation contributor and reviewer
+  * GitHub: [@manabuishii](https://github.com/manabuishii)
+  * Twitter: [@manabuishiirb](http://twitter.com/manabuishiirb)
+
+* [Satoshi Yokota][yokota_sotashi]: Postdoctoral Scholar (Stanford University, School of Medicine, California, USA)
+  * Translation contributor and reviewer
+  * GitHub: [@megane0-0](https://github.com/megane0-0)
+  * Twitter: [@megane0-0](http://twitter.com/megane0-0)
+
+* [Koki Mimura][mimura_koki]: Postdoctoral Researcher (Tokyo University of Agriculture and Technology, Tokyo, Japan)
+  * Advisor on organising events
+  * GitHub: [@kilometer0101](https://github.com/kilometer0101)
+  * Twitter: [@kilometer00](http://twitter.com/kilometer00)
+
+Please include your GitHub account and any other detail that you wish to be public.
+
+* [GivenName FamilyName][family_given]: Job title (Affiliation, location)
+  * Role
+  * GitHub: [@GitHubUser](https://github.com/GitHubUser)
+  * Twitter: [@handle](http://twitter.com/handle)
+