From cb0da994bb68343c0795d94118dc2a3a324dbd1f Mon Sep 17 00:00:00 2001 From: Dex Date: Sun, 4 Oct 2020 17:40:39 +0200 Subject: [PATCH] Create Czech README and CONTRIBUTING (#702) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add czech translation for CONTRIBUTIONS.md * Add czech translation for README.md * Fix mistake in README.cz.md * Fix markdown errors in CONTRIBUTING.cz.md * Proof Luminary099/R31.agc * Revert accidental proof in wrong branch * Revert accidental proof in wrong branch Co-authored-by: Matěj Havránek --- CONTRIBUTING.cz.md | 145 +++++++++++++++++++++++++++++++++++++++++++++ README.cz.md | 118 ++++++++++++++++++++++++++++++++++++ 2 files changed, 263 insertions(+) create mode 100644 CONTRIBUTING.cz.md create mode 100644 README.cz.md diff --git a/CONTRIBUTING.cz.md b/CONTRIBUTING.cz.md new file mode 100644 index 0000000..bd7fa96 --- /dev/null +++ b/CONTRIBUTING.cz.md @@ -0,0 +1,145 @@ +# Contributing + +🎌 +**Čeština** +[Deutsch][DE], +[English][EN], +[Español][ES], +[Français][FR], +[Kurdi][KU], +[Nederlands][NL], +[Português][PT_BR], +[Türkçe][TR], +[العربية][AR], +[日本語][JA], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[CZ]:CONTRIBUTING.cz.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 + +Zdrojové kódy v tomto repozitáři byly manuálně digitalizovány z papírových zdrojových materiálů, mohou se v nich tedy vyskytovat chyby a překlepy. Kód by měl být modifikován tak, aby byl konzistentní se zdrojovým skenem: + +- [AGC printouts for Comanche][8] +- [AGC printouts for Luminary][9] + +## Užitečná rozšíření + +GitHub podporuje syntaxi AGC assembly jazyka. Váš editor pravděpodobně podporu mít nebude, proto zde poskytujeme seznam rozšíření na zvýraznění syntaxe jazyka AGC pro následující editory: + +- [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] + +† Podporuje automatické formátování + +[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 + +## Formátování + +**Poznámka:** GitHub a výše uvedená rozšíření zajistí automatické použití správného formátování. + +- Odsazení s použitím tabů +- Šířka tabu je 8 +- Nezanechávat bílé znaky (whitespace) na konci řádků + +## Co mám kontrolovat? + +Jakékoliv rozdíly mezi skeny a zdrojovým kódem v tomto repozitáři, včetně: + +### Komentářů + +- Komentáře v přepsaném kódu by měly přesně odpovídat skenům + - Toto může zahrnovat doslovné kopírování překlepů či přidávání/odebírání celých komentářů + +### Zalomení řádků + +- Zalomení řádků *obsahujících* `R0000` ve sloupci 1 by měly přesně odpovídat skenům. +- Zalomení řádků *__bez__* `R0000` ve sloupci 1 by měly obsahovat jen 1 až 2 prázdné řádky v řadě + - Pokud obsahují více než dva prázdné řádky, přebytečné odstraňte. + - Řádky obsahující `R0000` v prvním sloupci se do tohoto nepočítají. + - Vznikly díky nevytištěnému číslu ve sloupci 8 zdrojových dokumentů. Číslo 2 způsobilo vypsání dvojité mezery (jeden prázdný řádek) a číslo 3 trojité mezery (dva prázdné řádky). Hodnoty 4-8 byly definovány, ale nebyly použity. Více v [#159][7] + +Napříkald následující kód: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` + +By měl být změněn na: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +### Mezery + +- Mezery mezi dvěma znaky v řetězci by měly respektovat tyto konvence (viz diskuze v [#316][10]): + - Jedna mezera pro nová slova. + - Dvě mezery pro nové věty. + - Tři mezery pro odsazení. + +Napříkald následující kód: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +By měl být změněn na: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +## Poznámka + +Než otevřete PR, ujistěte se že vaše změny jsou konzistentní se skeny! + +[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/README.cz.md b/README.cz.md new file mode 100644 index 0000000..3d5ffd1 --- /dev/null +++ b/README.cz.md @@ -0,0 +1,118 @@ +# Apollo-11 + +[![NASA][1]][2] +[![SWH]][SWH_URL] +[![Comanche]][ComancheMilestone] +[![Luminary]][LuminaryMilestone] + +🎌 +[Bahasa Indonesia][ID], +[Català][CA], +**Čeština**, +[Deutsch][DE], +[English][EN] +[Español][ES], +[Français][FR], +[Italiano][IT], +[Kurdi][KU], +[Nederlands][NL], +[Polski][PL], +[Português][PT_BR], +[Română][RO], +[Tiếng Việt][VI], +[Türkçe][TR], +[Русский][RU], +[العربية][AR], +[فارسی][FA], +[हिंदी][HI_IN], +[বাংলা][BD_BN], +[မြန်မာ][MM], +[日本語][JA], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:README.ar.md +[BD_BN]:README.bd_bn.md +[CA]:README.ca.md +[CZ]:README.cz.md +[DE]:README.de.md +[EN]:README.md +[ES]:README.es.md +[FA]:README.fa.md +[FR]:README.fr.md +[HI_IN]:README.hi_in.md +[ID]:README.id.md +[IT]:README.it.md +[JA]:README.ja.md +[KO_KR]:README.ko_kr.md +[KU]:README.ku.md +[MM]:README.mm.md +[PL]:README.pl.md +[PT_BR]:README.pt_br.md +[RO]:README.ro.md +[RU]:README.ru.md +[TR]:README.tr.md +[VI]:README.vi.md +[ZH_CN]:README.zh_cn.md +[ZH_TW]:README.zh_tw.md +[NL]:README.nl.md + +Originální zdrojové kódy navigačního počítače (AGC) Apolla 11 pro Velitelský Modul (Comanche055) a Lunární Modul (Luminary099). Digitalizováno s pomocí [Virtual AGC][3] a [MIT Museum][4]. Cílem repozitáře je udržovat původní zdrojové kódy Apolla 11. Vítáme všechny PR s úpravami problémů identifikovaných mezi přepisy v tomto repozitáři a originálními skeny pro [Luminary 099][5] a [Comanche 055][6], stejně jako soubory které mohly být přehlédnuty. + +## Přispívání + +Před otevřením pull requestu si prosím přečtěte [CONTRIBUTING.cz.md][7] + +## Compiling + +Zajímá-li vás kompilace původního zdrojového kódu, navštivte [Virtual AGC][8]. + +## Attribution + +  |   +:------------- | :----- +Copyright | Veřejná doména +Comanche055 | Součást zdrojového kódu pro Colossus 2A, Navigační Počítač (AGC) Velitelského Modulu (CM) pro Apollo 11
`Assemble revision 055 of AGC program Comanche by NASA`
`2021113-051. 10:28 APR. 1, 1969` +Luminary099 | Součást zdrojového kódu pro Luminary 1A, Navigační Počítač (AGC) Lunárního Modulu (LM) pro Apollo 11
`Assemble revision 001 of AGC program LMY99 by NASA`
`2021112-061. 16:27 JUL. 14, 1969` +Assembler | yaYUL +Contact | Ron Burkey +Website | www.ibiblio.org/apollo +Digitalisation | Tento zdrojový kód byl přepsán či jinak adaptován z digitalizované verze papírových materiálů z MIT Muzea. Digitalizaci provedl Paul Fjeld a zajistila Deborah Douglas z MIT Muzea. Oběma děkujeme. + +### Smlouva a schválení + +*Výňatek z [CONTRACT_AND_APPROVALS.agc]* + +Tento AGC program bude nazýván také Colossus 2A. + +Tento program je určen k použití v CM podle specifikací ve zprávě `R-577`. Tento program byl připraven v rámci DSR projektu `55-23870`, sponzorovaného Centrem kosmických lodí s posádkou Národního úřadu pro letectví a vesmír skrze smlouvu `NAS 9-4065` s Laboratoří instrumentace, Massachusetts Institute of Technology, Cambridge, Mass. + +Podal | Role | Datum +:------------------- | :--- | :--- +Margaret H. Hamilton | Vedoucí programátor projektu Colossus
Navádění a navigace Apollo | 28 Března 69 + +Schválil | Role | Datum +:---------------- | :--- | :--- +Daniel J. Lickly | Ředitel, Vývoj programů misí
Program navádění a navigace Apollo | 28. Března 1969 +Fred H. Martin | Manažer projektu Colossus
Program navádění a navigace Apollo | 28. Března 1969 +Norman E. Sears | Ředitel, Vývoj misí
Program navádění a navigace Apollo | 28. Března 1969 +Richard H. Battin | Ředitel, Vývoj misí
Program navádění a navigace Apollo | 28. Března 1969 +David G. Hoag | Ředitel
Program navádění a navigace Apollo | 28. Března 1969 +Ralph R. Ragan | Zástupce ředitele
Laboratoř instrumentace | 28. Března 1969 + +[CONTRACT_AND_APPROVALS.agc]:https://github.com/chrislgarry/Apollo-11/blob/master/Comanche055/CONTRACT_AND_APPROVALS.agc +[1]:https://flat.badgen.net/badge/NASA/Mission%20Overview/0B3D91 +[2]:https://www.nasa.gov/mission_pages/apollo/missions/apollo11.html +[3]:http://www.ibiblio.org/apollo/ +[4]:http://web.mit.edu/museum/ +[5]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/ +[6]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/ +[7]:https://github.com/chrislgarry/Apollo-11/blob/master/CONTRIBUTING.cz.md +[8]:https://github.com/rburkey2005/virtualagc +[SWH]:https://flat.badgen.net/badge/Software%20Heritage/Archive/0B3D91 +[SWH_URL]:https://archive.softwareheritage.org/browse/origin/https://github.com/chrislgarry/Apollo-11/ +[Comanche]:https://flat.badgen.net/github/milestones/chrislgarry/Apollo-11/1 +[ComancheMilestone]:https://github.com/chrislgarry/Apollo-11/milestone/1 +[Luminary]:https://flat.badgen.net/github/milestones/chrislgarry/Apollo-11/2 +[LuminaryMilestone]:https://github.com/chrislgarry/Apollo-11/milestone/2