diff --git a/CONTRIBUTING.ar.md b/CONTRIBUTING.ar.md index 00d940c..8503af6 100644 --- a/CONTRIBUTING.ar.md +++ b/CONTRIBUTING.ar.md @@ -3,6 +3,7 @@ # المساهمة 🎌 +[Català][CA]، [Čeština][CZ]، [Dansk][DA]، [Deutsch][DE]، @@ -28,6 +29,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.ca.md b/CONTRIBUTING.ca.md new file mode 100644 index 0000000..5d6af8f --- /dev/null +++ b/CONTRIBUTING.ca.md @@ -0,0 +1,158 @@ +# Contributing + +🎌 +**Català**, +[Čeština][CZ], +[Deutsch][DE], +[English][EN], +[Español][ES], +[Français][FR], +[Italiano][IT], +[Kurdi][KU], +[Lietuvių][LT], +[Nederlands][NL], +[Norsk][NO], +[Português][PT_BR], +[Türkçe][TR], +[Ελληνικά][GR], +[العربية][AR], +[日本語][JA], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.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 +[PT_BR]:CONTRIBUTING.pt_br.md +[TR]:CONTRIBUTING.tr.md +[ZH_CN]:CONTRIBUTING.zh_cn.md +[ZH_TW]:CONTRIBUTING.zh_tw.md + +El codi font en aquest repositori es va digitalitzar manualment a partir d'impressions en paper, d'aquesta manera els errors tipogràfics i altres discrepàncies s'han introduït accidentalment. El codi es modificarà perquè sigui coherent amb les impressions escanejades: + +- [AGC impressions per a Comanche][8] +- [AGC impressions per a Luminary][9] + +## Extensions Útils + +GitHub té suport de sintaxi pel llenguatge assemblador AGC incorporat. Malauradament, el seu editor de codi no ho farà, no obstant això, hi ha extensions de llenguatge AGC que proporcionen ressaltat de sintaxi pels següents editors: + +- [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] + +† Admet formateig automàtic + +[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 + +## Formateig + +**Nota:** GitHub i les extensions marcades anteriorment asseguren que s'està utilitzant el format correcte automàticament. + +- Utilitzar la tabulació per la indentació +- Utilitza una tabulació de 8 +- Retalla espais en blanc al final + +## ¿Que verifico? + +Qualsevol discrepància entre els escanejos i el codi font d'aquest repositori, incloent-hi: + +### Comentaris + +Els comentaris en el codi transcrit **han de coincidir exactament** amb els escanejos + +Això podria implicar crear un error tipogràfic deliberat o eliminat/ agregar un comentari complet. + +Els problemes més habituals que heu de tindre en compte durant la prova inclouen, entre d'altres: + +### Salts de línia + +- Salt de línia *with* `R0000` en la columna 1 ha de coincidir exactament amb els escanejos. +- Salt de línia *with**__out__* `R0000` en la columna 1 hauria de contenir sols 1 o 2 línies en blanc en una fila. + - Si hi ha més de 2 salts de línia en blanc, elimina els salts de línia addicionals. + - Línies amb `R0000` en la columna 1 no conten per això. + - En les imatges d'origen, aquestes van ser creades per un dígit sense imprimir en la columna 8. A 2 va forçar un doble espai (línia amb blanc simple) i un 3 va forçar un espai triple (línia en blanc doble). Els valors 4-8 es van diferenciar però mai es van utilitzar. Llegeix més sobre això a [#159][7] + +Per exemple el següent: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` + +S'ha de convertir en: + +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +### Espais + +- Els espais entre dos caràcters en la cadena han de respectar la següent convenció (observa la discussió a [#316][10]): + - Espai únic per noves paraules. + - Doble espai per noves oracions. + - Triple espai per esquerdes. + +Per exemple el següent: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +S'ha de convertir en: + +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +## Nota + +Abans de fer una RP, ¡assegurat que els seus canvis siguin consistents amb els escenaris! + +[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.cz.md b/CONTRIBUTING.cz.md index 855f9d4..7dc8a6b 100644 --- a/CONTRIBUTING.cz.md +++ b/CONTRIBUTING.cz.md @@ -1,6 +1,7 @@ # Contributing 🎌 +[Català][CA]، **Čeština**, [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.de.md b/CONTRIBUTING.de.md index a81be55..b40df54 100644 --- a/CONTRIBUTING.de.md +++ b/CONTRIBUTING.de.md @@ -1,6 +1,7 @@ # Contributing 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], **Deutsch**, @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md index c754b2f..344d51b 100644 --- a/CONTRIBUTING.es.md +++ b/CONTRIBUTING.es.md @@ -1,6 +1,7 @@ # Contributing 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.fr.md b/CONTRIBUTING.fr.md index 4e33405..b62d6e8 100644 --- a/CONTRIBUTING.fr.md +++ b/CONTRIBUTING.fr.md @@ -1,6 +1,7 @@ # Contribuer 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.gr.md b/CONTRIBUTING.gr.md index 3dac2fc..08d05d9 100644 --- a/CONTRIBUTING.gr.md +++ b/CONTRIBUTING.gr.md @@ -1,6 +1,7 @@ # Συνεισφορά 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.it.md b/CONTRIBUTING.it.md index 4f2157f..aaa4541 100644 --- a/CONTRIBUTING.it.md +++ b/CONTRIBUTING.it.md @@ -1,6 +1,7 @@ # Contribuire 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.ja.md b/CONTRIBUTING.ja.md index 3dc2aa9..0324a31 100644 --- a/CONTRIBUTING.ja.md +++ b/CONTRIBUTING.ja.md @@ -1,6 +1,7 @@ # コントリビュート 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.ko_kr.md b/CONTRIBUTING.ko_kr.md index 9da74f2..3764c8b 100644 --- a/CONTRIBUTING.ko_kr.md +++ b/CONTRIBUTING.ko_kr.md @@ -1,6 +1,7 @@ # 기여하기 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ **한국어** [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.ku.md b/CONTRIBUTING.ku.md index c659f1a..fa5bdab 100644 --- a/CONTRIBUTING.ku.md +++ b/CONTRIBUTING.ku.md @@ -1,6 +1,7 @@ # Beşdarbûn 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.lt.md b/CONTRIBUTING.lt.md index d13b22a..07581ed 100644 --- a/CONTRIBUTING.lt.md +++ b/CONTRIBUTING.lt.md @@ -1,6 +1,7 @@ # Prisidėjimas 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 388b06e..4a76f4e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,7 @@ # Contributing 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.nl.md b/CONTRIBUTING.nl.md index 7a7803f..87d88e5 100644 --- a/CONTRIBUTING.nl.md +++ b/CONTRIBUTING.nl.md @@ -1,6 +1,7 @@ # Bijdragen 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.no.md b/CONTRIBUTING.no.md index 5f40e47..bcdb7dc 100644 --- a/CONTRIBUTING.no.md +++ b/CONTRIBUTING.no.md @@ -1,6 +1,7 @@ # Bidra 🎌 +[Català][CA]، [Čeština][CZ], [Deutsch][DE], [English][EN], @@ -25,6 +26,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DE]:CONTRIBUTING.de.md [EN]:CONTRIBUTING.md diff --git a/CONTRIBUTING.pt_br.md b/CONTRIBUTING.pt_br.md index 1f890a5..1fd4bce 100644 --- a/CONTRIBUTING.pt_br.md +++ b/CONTRIBUTING.pt_br.md @@ -1,6 +1,7 @@ # Contribuindo 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.tr.md b/CONTRIBUTING.tr.md index 189265d..891eb70 100644 --- a/CONTRIBUTING.tr.md +++ b/CONTRIBUTING.tr.md @@ -1,6 +1,7 @@ # Katkıda Bulunma 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.zh_cn.md b/CONTRIBUTING.zh_cn.md index abb94b6..0f683c5 100644 --- a/CONTRIBUTING.zh_cn.md +++ b/CONTRIBUTING.zh_cn.md @@ -1,6 +1,7 @@ # 贡献 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md diff --git a/CONTRIBUTING.zh_tw.md b/CONTRIBUTING.zh_tw.md index 810e7f0..9520787 100644 --- a/CONTRIBUTING.zh_tw.md +++ b/CONTRIBUTING.zh_tw.md @@ -1,6 +1,7 @@ # 貢獻 🎌 +[Català][CA]، [Čeština][CZ], [Dansk][DA], [Deutsch][DE], @@ -26,6 +27,7 @@ [한국어][KO_KR] [AR]:CONTRIBUTING.ar.md +[CA]:CONTRIBUTING.ca.md [CZ]:CONTRIBUTING.cz.md [DA]:CONTRIBUTING.da.md [DE]:CONTRIBUTING.de.md