diff --git a/CONTRIBUTING.ar.md b/CONTRIBUTING.ar.md index 878d4cb..2ec7b93 100644 --- a/CONTRIBUTING.ar.md +++ b/CONTRIBUTING.ar.md @@ -12,6 +12,7 @@ [Português][PT_BR]، [Türkçe][TR]، **العربية**، +[日本語][JA], [正體中文][ZH_TW]، [简体中文][ZH_CN]، [한국어][KO_KR] @@ -21,6 +22,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.de.md b/CONTRIBUTING.de.md index 7aa9005..be3d45f 100644 --- a/CONTRIBUTING.de.md +++ b/CONTRIBUTING.de.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md index da2854f..31f8886 100644 --- a/CONTRIBUTING.es.md +++ b/CONTRIBUTING.es.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.fr.md b/CONTRIBUTING.fr.md index 9762fff..04004c7 100644 --- a/CONTRIBUTING.fr.md +++ b/CONTRIBUTING.fr.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.ja.md b/CONTRIBUTING.ja.md new file mode 100644 index 0000000..b289c1c --- /dev/null +++ b/CONTRIBUTING.ja.md @@ -0,0 +1,143 @@ +# コントリビュート + +🎌 +[Deutsch][DE], +[English][EN], +[Español][ES], +[Français][FR], +[Kurdi][KU], +[Nederlands][NL], +[Português][PT_BR], +[Türkçe][TR], +[العربية][AR], +**日本語**, +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[DE]:CONTRIBUTING.de.md +[EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md +[KO_KR]:CONTRIBUTING.ko_kr.md +[KU]:CONTRIBUTING.ku.md +[NL]:CONTRIBUTING.nl.md +[PT_BR]:CONTRIBUTING.pt_br.md +[TR]:CONTRIBUTING.tr.md +[ZH_CN]:CONTRIBUTING.zh_cn.md +[ZH_TW]:CONTRIBUTING.zh_tw.md + +このリポジトリのソースコードは紙の印刷物から手動でデジタル化された為、いくつかのタイプミスやその他の不一致が誤って導入されています。スキャンしたプリントアウトと一致する様にコードを変更する必要があります: + +- [AGC printouts for Comanche][8] +- [AGC printouts for Luminary][9] + +## 便利な拡張機能 + +GitHubには、組み込みのAGCアセンブリ言語の構文サポートがあります。残念ながらコードエディターにはありませんが、次のエディターにシンタックスハイライトをサポートするAGC言語拡張機能があります: + +- [Atom][Atom]† +- [CodeBlocks][CodeBlocks] +- [Eclipse][Eclipse] +- [Kate][Kate] +- [ProgrammersNotepad][ProgrammersNotepad] +- [Sublime Text 3][Sublime Text]† +- [TextPad][TextPad] +- [Vim][Vim] +- [Visual Studio Code][VisualStudioCode]† +- [jEdit][jEdit] + +† オートフォーマットをサポート + +[Atom]:https://github.com/Alhadis/language-agc +[CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks +[Eclipse]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Eclipse +[Kate]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Kate +[ProgrammersNotepad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/ProgrammersNotepad +[Sublime Text]:https://github.com/jimlawton/AGC-Assembly +[TextPad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/TextPad +[Vim]:https://github.com/wsdjeg/vim-assembly +[VisualStudioCode]:https://github.com/wopian/agc-assembly +[jEdit]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/jEdit + +## フォーマット + +**注意:** GitHubと上記の拡張機能により、正しいフォーマットが自動的に使用されます。 + +- タブでインデントする +- タブ幅は8を使用する +- 末尾の空白を削除する + +## 確認方法は? + +スキャンとこのリポジトリ内のソースコードとの間の不一致: + +### コメント + +- 文字起こしされたコードのコメントはスキャンと正確に一致する必要があります + - これには意図的なタイプミス、またはコメント全体の削除/追加が含まれる場合があります。 + +### 改行 + +- 列1の `R0000` での改行は、スキャンと正確に一致する必要があります。 +- 列1の `R0000` で *ない* 改行は、1行または2行の空白行のみを含める必要があります。 + - 空白の改行が2つ以上ある場合は、余分な改行を削除します。 + - 列1に `R0000` が含まれる行は、これにカウントされません。 + - ソース画像では、これらは列8の印刷されていない数字によって作成されました。2はダブルスペース(単一の空白行)を強制し、3はトリプルスペース(二重の空白行)を強制しました。値4-8は定義されていますが使用されていません。詳しくは[#159][7]をご覧ください。 + +例えば、次の通りです: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` + +これになるはずです: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +### スペース + +- 文字列間内の2つの文字間のスペースは、次の規則に従う必要があります([#316][10]のディスカッションを参照): + - 新しい単語の為の単一のスペース。 + - 新しい文章の為の2個のスペース。 + - インデントの為の3個のスペース。 + +例えば、次の通りです: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +これになるはずです: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +## 注意 + +PRを作成する前に、変更がスキャンと一致していることを確認して下さい! + +[0]:https://github.com/chrislgarry/Apollo-11/pull/new/master +[1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ +[2]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ +[6]:https://github.com/wopian/agc-assembly#user-settings +[7]:https://github.com/chrislgarry/Apollo-11/issues/159 +[8]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ +[9]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ +[10]:https://github.com/chrislgarry/Apollo-11/pull/316#pullrequestreview-102892741 diff --git a/CONTRIBUTING.ko_kr.md b/CONTRIBUTING.ko_kr.md index 599c54d..b95d62f 100644 --- a/CONTRIBUTING.ko_kr.md +++ b/CONTRIBUTING.ko_kr.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], **한국어** @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.ku.md b/CONTRIBUTING.ku.md index bcff6e2..9e7b35f 100644 --- a/CONTRIBUTING.ku.md +++ b/CONTRIBUTING.ku.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index b84aad1..a47a673 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.nl.md b/CONTRIBUTING.nl.md index 880f5c6..142368f 100644 --- a/CONTRIBUTING.nl.md +++ b/CONTRIBUTING.nl.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [PT_BR]:CONTRIBUTING.pt_br.md diff --git a/CONTRIBUTING.pt_br.md b/CONTRIBUTING.pt_br.md index 53bdcb3..5029de5 100644 --- a/CONTRIBUTING.pt_br.md +++ b/CONTRIBUTING.pt_br.md @@ -10,6 +10,7 @@ **Português**, [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.tr.md b/CONTRIBUTING.tr.md index 73f7cbb..66169c2 100644 --- a/CONTRIBUTING.tr.md +++ b/CONTRIBUTING.tr.md @@ -10,6 +10,7 @@ [Português][PT_BR], **Türkçe**, [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.zh_cn.md b/CONTRIBUTING.zh_cn.md index 1fb88fb..e32341f 100644 --- a/CONTRIBUTING.zh_cn.md +++ b/CONTRIBUTING.zh_cn.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], [正體中文][ZH_TW], **简体中文**, [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md diff --git a/CONTRIBUTING.zh_tw.md b/CONTRIBUTING.zh_tw.md index c5858bc..986866c 100644 --- a/CONTRIBUTING.zh_tw.md +++ b/CONTRIBUTING.zh_tw.md @@ -10,6 +10,7 @@ [Português][PT_BR], [Türkçe][TR], [العربية][AR], +[日本語][JA], **正體中文**, [简体中文][ZH_CN], [한국어][KO_KR] @@ -19,6 +20,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md [FR]:CONTRIBUTING.fr.md +[JA]:CONTRIBUTING.ja.md [KO_KR]:CONTRIBUTING.ko_kr.md [KU]:CONTRIBUTING.ku.md [NL]:CONTRIBUTING.nl.md