translate write-documentation.markdown into Japanese

utenmiki · brixen · commit a544d21dfd86 · 2013-09-13T18:38:33.000-07:00
diff --git a/doc/ja/how-to/write-documentation.markdown b/doc/ja/how-to/write-documentation.markdown
@@ -8,25 +8,20 @@ next_url: how-to/translate-documentation
 translated: true
 ---
 
-Rubiniusのドキュメントは、Webサイトやブログに統合されています。これは、使用して
-Jekyllは単に他のコンポーネントと同様に。
+Rubiniusのドキュメントは、Webサイトとブログで構成されています。他の部分と同じくJekyllを使用しています。
 
-開始するには、`kramdown`は、インストール`jekyll`宝石を持っていることを確認します。
+始めに、`kramdown`と`jekyll`がインストールされていることを確かめてください。
 
     rbx gem install jekyll kramdown
 
-ドキュメントのソースは、`web/doc`のディレクトリの下にあります。があります。
-各言語のサブディレクトリは、ドキュメントがされていると
-（例：`en`は、`ja`を、など）が翻訳されています。
+ドキュメントは、`web/doc`のディレクトリにあります。
+各言語のサブディレクトリには、翻訳されたドキュメントががあります。（例えば、`en`、`es`など）
 
-目次は、例えば各翻訳（のためにそこにいる
-`/web/doc/ja/index.markdown`に）。ドキュメントの残りの部分は、構成されています
-YAMLはドキュメントがどのように指定する属性を持つ単一のファイル
-接続されています。基本的には、マニュアルのように表示することができます二重にリンクされている
-を指して、各ドキュメントとドキュメントのリストを前と次の
-ドキュメント。内容文書の表は、完全な構造を示しています。
+翻訳毎に目次があります。（例えば、`/web/doc/ja/index.markdown`）。
+ドキュメントののこちの部分は、どのように他のドキュメントとリンクが張ってあるかというYAMLの属性から成る単一のファイルです。
+基本的に、ドキュメントは前後のドキュメントにリンクが張ってある双方向リストとみなせます。
 
-YAMLは次のようなドキュメントを見ての属性：
+ドキュメントのYAMLの属性は下記の通りです。
 
     ---
     layout: doc_en
@@ -37,41 +32,45 @@ YAMLは次のようなドキュメントを見ての属性：
     next_url: how-to/translate-documentation
     ---
 
-_layout_の書式設定時に使用するジキルのレイアウトを指定する
-ドキュメント。 _layout_は`doc_LANGする必要があります、_LANG_は、ISO- 639- 2です
-言語のコード。
+_layout_は、どのレイアウトをjekyllが使用するか指定します。
+_layout_の_LANG_は、ISO-639-2の`doc_LANGにしなければいけません。
 
-_title_の上部に表示されている文書のタイトルを指定します。
-ページを表示します。
+_title_は、ページの上部に表示されるドキュメントのタイトルを指定します。
 
-_previous_と_previous\_url_属性は、タイトルとリンクを与える
-以前のドキュメント。同様に、_next_と_next\_url_属性を与える
-タイトルと、次のドキュメントのリンクをクリックします。これらは、閲覧を強化するために使用されている
-ドキュメントや作業量を再注文部品の必要な制限
-マニュアルを参照してください
+_previous_と_previous\_url_属性で、前のドキュメントのタイトルとリンクを指定します。
+同様に、_next_と_next\_url_属性で、後のドキュメントのタイトルとリンクを指定します。
 
+これらはドキュメントの閲覧を便利にする、再度ドキュメントを書くときに必要な作業量を削減するためです。
 
-### 編集既存のドキュメントを
+RubiniusのリポジトリにJekyllで生成したドキュメントとファイルがコミットされます。リポジトリをクローンしたら、Rubiniusをインストールする前かRubiniusのビルドに問題があるとき
+`rake docs`でドキュメントを閲覧することができます。
 
-ドキュメントの最初のアウトラインが作成されています。たくさんいる
-単に必要なトピックでは、それらのために書かれたドキュメントを持っている。
+### 既存ドキュメントの編集
 
-既存のトピックのドキュメントを追加する、または既存のドキュメントを修正する
-`web/doc/LANG`は下のトピックのファイルを開いて、追加または改善
-マニュアルを参照してください
+ドキュメントの最初のアウトラインが作成されています。
+ドキュメントを書く必要がある話題がたくさんあります。
 
+既に存在している話題にドキュメントを追加するかドキュメントを修正する場合:
 
-### 新しいドキュメントを追加する
+1. `web/doc/LANG`の下のファイルを開く。
+1. ドキュメントの追加または改善を行う。
+1. 作業中のドキュメントのアップデートを見る。
+  `web/`ディレクトリで`rbx -S jekyll serve --watch`を実行する。
+1. ドキュメントの追加または編集が終了したら、ソースコードの変更をコミットする。
+1. `web/`ディレクトリで`rbx -S jekyll build`を実行し、`web/_site`の全てのファイルを強制的にアップデートする。
+1. 生成したファイルをコミットする。変更が少ない場合、ドキュメントのソースコードと生成したファイルをコミットしてください。
+   変更が多い場合、レビューでの変更が単純になるように生成したファイルを個別にコミットしてください。
 
-既存のトピックでは、存在するのドキュメントを追加するには：
+### 新しいドキュメントの追加
 
-1. Create a new file with the .markdown extension under `web/doc/LANG`.
-1. Set up the attributes to link the new file into the existing files. This
-   will require editing the _previous_ and _next_ attributes of the existing
-   files to insert the new file, as well as adding an entry to
-   `index.markdown`.
-1. To view your updates while you are working on them, run
-   `rbx -S jekyll serve --watch`
-1. Edit the new file using Markdown syntax.
-1. In the `web/` directory, run `rbx -S jekyll build`.
-1. Commit all the changes in the `web/` directory.
+存在してない話題をのドキュメントを追加する場合：
+
+1. `web/doc/LANG`に.markdown拡張子のファイルを作成する。
+1. 既に存在してるファイルから新しいファイルにリンクを張るために属性を記述する。
+`index.markdown`と既に存在しているファイルの_previous_ と _next_ attributesに新しいファイルへのリンクを記述することが必要です。
+1. 作業中にアップデートしたドキュメントを見るには、`rbx -S jekyll serve --watch`を実行します。
+1. マークダウン記法で新しいファイルを編集します。
+1. ドキュメントの追加または編集が終わったら、変更をコミットしてください。
+1. `rbx -S jekyll build` in the `web/` を実行し、`web/_site`で生成されているファイルを強制的にアップデートしてください。
+1. 生成したファイルをコミットする。変更が少ない場合、ドキュメントのソースコードと生成したファイルをコミットしてください。
+   変更が多い場合、レビューでの変更が単純になるように生成したファイルを個別にコミットしてください。
