diff --git a/CONTRIBUTING.az.md b/CONTRIBUTING.az.md new file mode 100644 index 0000000..f3ffd57 --- /dev/null +++ b/CONTRIBUTING.az.md @@ -0,0 +1,157 @@ +# Töhfə + +🎌 +[Azerbaijan][AZ], +[Čeština][CZ], +[Deutsch][DE], +[English][EN], +[Español][ES], +[Français][FR], +[Italiano][IT], +[Kurdi][KU], +[Lietuvių][LT], +[Nederlands][NL], +[Norsk][NO], +[Polski][PL], +[Português][PT_BR], +**Türkçe**, +[Ελληνικά][GR], +[العربية][AR], +[日本語][JA], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[AZ]:CONTRIBUTING.az.md +[CZ]:CONTRIBUTING.cz.md +[DE]:CONTRIBUTING.de.md +[EN]:CONTRIBUTING.md +[ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md +[GR]:CONTRIBUTING.gr.md +[IT]:CONTRIBUTING.it.md +[JA]:CONTRIBUTING.ja.md +[KO_KR]:CONTRIBUTING.ko_kr.md +[KU]:CONTRIBUTING.ku.md +[LT]:CONTRIBUTING.lt.md +[NL]:CONTRIBUTING.nl.md +[NO]:CONTRIBUTING.no.md +[PL]:CONTRIBUTING.pl.md +[PT_BR]:CONTRIBUTING.pt_br.md +[TR]:CONTRIBUTING.tr.md +[ZH_CN]:CONTRIBUTING.zh_cn.md +[ZH_TW]:CONTRIBUTING.zh_tw.md + +Bu repodakı mənbə kodu kağız çıxışlarından əl ilə rəqəmsallaşdırılıb. Belə ki, yanlışlıqla hərf səhvləri və digər uyğunsuzluqlar edilib. Kod aşağıdakı skan edilmiş çıxışa uyğun olmaq üçün redaktə edilməlidir: + +- [AGC printouts for Comanche][8] +- [AGC printouts for Luminary][9] + +## Faydalı Pluginlər + +GitHub, AGC assembly dili için sentaks desteği sağlıyor ama sizin kodu düzenlemek için kullandığınız editör sağlamayacaktır. Aşağıdaki editörler AGC dili sentaks vurgulaması için eklentiler sunmaktadır: + +GitHub, AGC assembly dilinin sintaksını dəstəkləyir amma sizin kodu redaktə etmək üçün istifadə edəcəyiniz IDE dəstəkləməyəcək. Aşağıdakı IDE-lər AGC dili üçün sintaks dəstəyi təqdim etməkdədir. + +- [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] + +† Avtomatik formatlaşdırmanı dəstəkləyirlər + +[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 + +## Formatlaşdırma + +**Not:** GitHub və yuxarıdakı 3 plagin avtomatik olaraq düzgün formatlaşdırmadan istifadə etməyə imkan verəcək. + +- Girintiləməni TAB ilə buraxın. +- 8 TAB genişliyi istifadə edin. +- Davamındakı boşluqları silin. + +## Nəyi kontrol edim? + +Skan edilmiş çıxışlar və bu repodakı mənbə kodu arasında hər hansı uyğunsuzluq. + +### Şərhlər + +Uyğunlaşdırılmış koddakı şərh sətirləri çıxışlarla **dəqiq** **uyğunlaşmalıdır**. + +Düzəltmək üçün axtarmaq lazım olan bəzi əsas problemlər bunlardır: + +#### Yazım Xətaları + +Bəzi yerlərdə orijinal tərtibatçılar şərhləri yazarkən hərf səhvlərinə yol verdiblər. Bunlardan bəziləri rəqəmsallaşdırma prosesinin əvvəlində səhvən düzəldildi, lakin rəqəmsallaşdırma prosesi skan edilmiş çıxışda olmayan yeni yazı xətaları da yol açdı. + +Məsələn, rəqəmsal şərhlərdə `SPACECRAFT` sözü varsa, lakin skan edilmiş çaplarda `SPAECRAFT` oxunursa, rəqəmsal şərh `SPAECRAFT` olaraq **düzəldilməlidir** (`C` yoxdur). + +Eyni şəkildə, rəqəmsal şərhlərdə yazı xətası varsa, lakin skan edilmiş çaplar düzgün yazılıbsa, yazı xətası **düzəldilməlidir**. + +### Boşluqlar + +Şərhlər arasındakı iki simvol arasındakı boşluqlar skan edilmiş çıxışa **uyğun** olmalıdır. Əksər hallarda ([#316][10]-da müzakirəyə baxın) boşluqlar aşağıdakılardır: + +- Yeni sözlər arasında tək boşluq. +- Yeni cümlələr arasında iki boşluq. +- Yeni girintilər üçün üç boşluq. + +Skan edilmiş çaplardakı bütün səhifələr bu ümumiləşdirmələrə uyğun gəlmir. Çıxışda iki boşluq əvəzinə boşluq varsa, bir boşluqdan istifadə edin. + +### Sətir sonları + +- İlk sütunu "R0000" *ilə* bitən sətir sonları çıxışa tam uyğun gəlməlidir. +- Birinci sütunda `R0000` *__olmadan__* ilə bitən sətir sonunda yalnız 1 və ya 2 boş sətir olmalıdır. + - Əgər 2-dən çox sətir sonu varsa artıq olanları silin. + - Birinci sütunu `R0000` *ilə* bitən sətirlər bu qanun daxilində deyillər. + - Mənbə şəkillərində onlar 8-ci sətirdə basdırılmamış rəqəmlə yaradılmışdır. 2 iki boşluğu (bir boş sətir), 3 isə üç boşluğu (iki boş sətir) təmsil edir. 4 və 8 müəyyən edilmişdir, lakin heç vaxt istifadə edilməmişdir. Bu barədə daha çox oxumaq üçün: [#159][7] + +Məsələn bu: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` + +Buna çevrilməlidir: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +## Not + +PR-dən əvvəl, zəhmət olmasa, dəyişikliklərinizin nəticələrə uyğun olduğundan əmin olun! + +[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.az.md b/README.az.md new file mode 100644 index 0000000..77d5a3e --- /dev/null +++ b/README.az.md @@ -0,0 +1,127 @@ +# Apollo-11 + +[![NASA][1]][2] +[![SWH]][SWH_URL] +[![Comanche]][ComancheMilestone] +[![Luminary]][LuminaryMilestone] + +🎌 +[Azerbaijan][AZ], +[Bahasa Indonesia][ID], +[Català][CA], +[Čeština][CZ], +[Deutsch][DE], +[English][EN], +[Español][ES], +[Français][FR], +[Italiano][IT], +[Kurdi][KU], +[Nederlands][NL], +[Norsk][NO], +[Polski][PL], +[Português][PT_BR], +[Română][RO], +[Tiếng Việt][VI], +**Türkçe**, +[Ελληνικά][GR], +[Русский][RU], +[العربية][AR], +[فارسی][FA], +[हिंदी][HI_IN], +[অসমীয়া][AS_IN], +[বাংলা][BD_BN], +[မြန်မာ][MM], +[日本語][JA], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:README.ar.md +[AS_IN]:README.as_in.md +[AZ]:README.az.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 +[GR]:README.gr.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 +[LT]:README.lt.md +[MM]:README.mm.md +[NL]:README.nl.md +[NO]:README.no.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 + +Original Apollo 11 Yönləndirmə Kompüterinin (AGC) Komanda Modulu (Comanche055) və Ay modulu (Luminary099) üçün mənbə kodu. [Virtual AGC][3] və [MIT Museum][4] əməkdaşları tərəfindən rəqəmsallaşdırılıb. Məqsəd, original Apollo 11 mənbə kodunu ehtiva edən bir repo yaratmaqdır. Buna görə də, bu repodakı transkriptlər ilə original [Luminary 099][5] və [Comanche 055][6] mənbə skanları arasında aşkarlanan xətalarla və ya mənim gözdən qaçırdığım bir fayl ilə əlaqəli pull request-ləri önəmsəyirik. + +## Töhfə + +Zəhmət olmasa pull request etmədən öncə [CONTRIBUTING.az.md][7] faylını oxuyun. + +## Kompilyasiya + +Əgər original mənbə kodunu kompilyasiya etmək istəyirsinizsə, [Virtual AGC][8] proyektinə baxa bilərsiniz. + +## Atributlar + +  |   +:-------------- | :----- +Lisenziya | İctimai mülkiyyət - ABŞ hökumətinin işi +Comanche055 | Apollo Yönləndirmə Kompüteri (AGC) Komanda Modulu (CM) olan Colossus 2A-nın mənbə kodunun bir hissəsi.
`AGC proqramı Comanche-in NASA tərəfindən yaradılan 055 sayılı birləşdirmə təftişi`
`2021113-051. 10:28 APR. 1, 1969` +Luminary099 | Apollo Yönləndirmə Kompüteri (AGC) Ay Modulu (LM) olan Luminary 1A-in mənbə kodunun bir parçası.
`AGC Proqramı LMY99-un NASA tərəfindən yaradılan 001 sayılı birləşdirmə təftişi`
`2021112-061. 16:27 İYUL. 14, 1969` +Kompilyator | yaYUL +Əlaqə | Ron Burkey +Sayt | www.ibiblio.org/apollo +Rəqəmsallaşdırma | Bu mənbə kodu MIT muzeyindəki kağız nüsxələrin fotoşəkillərindən uyğunlaşdırılmış və ya köçürülmüşdür. Rəqəmsallaşdırma Muzeyin əməkdaşı Deborah Duqlas tərəfindən təşkil edilib, Paul Fjeld tərəfindən həyata keçirilmişdir. Hər ikisinə də təşəkkür edirəm. + +### Əlaqə və Təsdiqlər + +*[CONTRACT_AND_APPROVALS.agc]-dan alınmışdır.* + +Bu AGC proqramı Colossus 2A kimi də tanınır. + +`R-577` hesabatında qeyd edildiyi kimi, bu proqram CM üçün istifadə məqsədli nəzərdə tutulub. Bu proqram DSR `55-23870` layihəsi, Milli Aeronavtika və Kosmos Administrasiyasının Kosmik Gəmilər Mərkəzinin sponsorluğu ilə, Cambridge Mass Massachusetts Texnologiya İnstitutunun Alətlər Laboratoriyası ilə `NAS 9-4065` müqaviləsi əsasında hazırlanmışdır. + +Göndərən | Vəzifəsi | Tarix +:------------------- | :------ | :---- +Margaret H. Hamilton | Colossus Proqramlama Lideri
Apollo Yönləndirmə və Naviqasiya | 28 Mart 1969 + +Təsdiqləyən | Vəzifəsi | Tarix +:---------------- | :------ | :---- +Daniel J. Lickly | Direktor, Tapşırıq Proqramı İnkişafı
Apollo Yönləndirmə və Naviqasiya proqramı | 28 Mart 1969 +Fred H. Martin | Colossus Layihə rəhbəri
Apollo Yönləndirmə və Naviqasiya Proqramı | 28 Mart 1969 +Norman E. Sears | Direktor, Tapşırıq İnkişafı
Apollo Yönləndirmə və Naviqasiya Proqramı | 28 Mart 1969 +Richard H. Battin | Direktor, Tapşırıq İnkişafı
Apollo Yönləndirmə və Naviqasiya Proqramı | 28 Mart 1969 +David G. Hoag | Direktor
Apollo Yönləndirmə və Naviqasiya Proqramı | 28 Mart 1969 +Ralph R. Ragan | Direktor köməkçisi
Alətlər Laboratoriyası | 28 Mart 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.tr.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