diff --git a/CONTRIBUTING.ar.md b/CONTRIBUTING.ar.md index a6b813d..5370298 100644 --- a/CONTRIBUTING.ar.md +++ b/CONTRIBUTING.ar.md @@ -5,6 +5,7 @@ :crossed_flags: [English][EN]، [Español][ES]، +[Francais][FR]، [Nederlands][NL]، [Português][PT_BR]، [Türkçe][TR]، @@ -16,6 +17,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.es.md b/CONTRIBUTING.es.md index 1698c1c..5fdf85d 100644 --- a/CONTRIBUTING.es.md +++ b/CONTRIBUTING.es.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], **Español**, +[Francais][FR], [Português][PT_BR], [Türkçe][TR], [العربية][AR], @@ -12,6 +13,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.fr.md b/CONTRIBUTING.fr.md new file mode 100644 index 0000000..b4cc313 --- /dev/null +++ b/CONTRIBUTING.fr.md @@ -0,0 +1,121 @@ +# Contribuer + +:crossed_flags: +[English][EN], +**Francais**, +[Português][PT_BR], +[Türkçe][TR], +[العربية][AR], +[正體中文][ZH_TW], +[简体中文][ZH_CN], +[한국어][KO_KR] + +[AR]:CONTRIBUTING.ar.md +[EN]:CONTRIBUTING.md +[FR]:CONTRIBUTING.fr.md +[KO_KR]:CONTRIBUTIN.ko_kr.md +[PT_BR]:CONTRIBUTING.pt_br.md +[TR]:CONTRIBUTING.tr.md +[ZH_CN]:CONTRIBUTING.zh_cn.md +[ZH_TW]:CONTRIBUTING.zh_tw.md + +Le code source de ce dépôt a été numérisé manuellement à partir d’imprimés papier, de sorte que les fautes de frappe et autres anomalies ont été introduites accidentellement. Le code doit être modifié pour être cohérent avec les impressions numérisées: + +* [Impressions AGC pour Comanche][8] +* [Impressions AGC pour Luminary][9] + +## Extensions utiles + +Github prend en charge nativement la syntaxe pour le langage assembleur AGC. Malheureusement, votre éditeur de texte ne l’aura pas. Mais il y a des extensions pour le langage AGC pour les éditeurs suivants: +- [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] + +† Prend en charge le formatage automatique + +[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 + +## Mise en page +**Note:** GitHub et les extensions marquées ci-dessus vous assureront d'utiliser automatiquement le bon formatage. + +- Indenter avec tabulation +- Les tabulations ont une taille de 8 +- Pas d'espace à la fin des ligne + +## Comment vérifier ? +Tout écart entre les scans et le code source dans ce référentiel, y compris : + +### Commentaires +- Les commentaires dans le code transcrit doivent correspondre exactement aux scans + - Cela peut impliquer de créer délibérément une erreur de frappe ou de supprimer/ajouter un commentaire entier. + +### Sauts de ligne +- Les lignes *avec* `R0000` dans la colonne 1 doivent correspondre exactement aux scans. +- Les sauts de ligne *sans* `R0000` dans la colonne 1 ne doivent contenir que 1 ou 2 lignes vides d'affilée. + - Si il y a plus de 2 lignes vides, supprimer les sauts de ligne supplémentaires. + - Ne pas prendre en compte les lignes avecc `R0000` dans la cononne 1. + - Dans les images sources, il y a digits non imprimés dans la colonne 8. Un 2 force un double espace (une seul ligne vide) et un 3 force une triple espace (double ligne vide). Les valeurs 4-8 ont été définies mais n’ont jamais été utilisées. Pour en savoir plus [#159][7] + +Par exemple, ce qui suit: +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + + 0821 LAMPTEST CS IMODES33 +``` +Doit devenir: +```plain +R0819 SUBROUTINE TO SKIP... +R0820 + + + 0820 LAMPTEST CS IMODES33 +``` + +### Espaces +- Les espaces entre deux caractères doivent respecter la convention suivante (voir la discussion [#316][10]): + - Un seul espace pour un nouveau mot. + - Deux espaces pour une nouvelle phrase. + - Trois espaces pour l'indentations. + +Par exemple, ce qui suit: +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` +Doit devenir: +```plain + 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT, + GARPLY, WALDO. +``` + +## Note + +Avant de faire une PR, assurez-vous que vos modifications sont cohérentes avec les scans! + +[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 822899e..a23c9db 100644 --- a/CONTRIBUTING.ko_kr.md +++ b/CONTRIBUTING.ko_kr.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], [Español][ES], +[Francais][FR], [Nederlands][NL], [Português][PT_BR], [Türkçe][TR], @@ -14,6 +15,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 72a5ad2..10c385b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,6 +2,7 @@ :crossed_flags: **English**, +[Francais][FR], [Nederlands][NL], [Português][PT_BR], [Türkçe][TR], @@ -12,6 +13,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.nl.md b/CONTRIBUTING.nl.md index 5781afe..07bcb34 100644 --- a/CONTRIBUTING.nl.md +++ b/CONTRIBUTING.nl.md @@ -2,6 +2,7 @@ :crossed_flags: [English][EN], +[Francais][FR], **Nederlands**, [Português][PT_BR], [Türkçe][TR], @@ -12,6 +13,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.pt_br.md b/CONTRIBUTING.pt_br.md index 72b811e..39ae653 100644 --- a/CONTRIBUTING.pt_br.md +++ b/CONTRIBUTING.pt_br.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], [Español][ES], +[Francais][FR], [Nederlands][NL], **Português**, [Türkçe][TR], @@ -14,6 +15,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.tr.md b/CONTRIBUTING.tr.md index a698e56..ed014d4 100644 --- a/CONTRIBUTING.tr.md +++ b/CONTRIBUTING.tr.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], [Español][ES], +[Francais][FR], [Nederlands][NL], [Português][PT_BR], **Türkçe**, @@ -13,6 +14,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [AR]:CONTRIBUTING.ar.md [KO_KR]:CONTRIBUTING.ko_kr.md [TR]:CONTRIBUTING.tr.md diff --git a/CONTRIBUTING.zh_cn.md b/CONTRIBUTING.zh_cn.md index a2fc391..d0f16bc 100644 --- a/CONTRIBUTING.zh_cn.md +++ b/CONTRIBUTING.zh_cn.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], [Español][ES], +[Francais][FR], [Nederlands][NL], [العربية][AR], [한국어][KO_KR], @@ -10,6 +11,7 @@ [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [AR]:CONTRIBUTING.ar.md [KO_KR]:CONTRIBUTING.ko_kr.md [ZH_CN]:CONTRIBUTING.zh_cn.md diff --git a/CONTRIBUTING.zh_tw.md b/CONTRIBUTING.zh_tw.md index b95cf00..b05b574 100644 --- a/CONTRIBUTING.zh_tw.md +++ b/CONTRIBUTING.zh_tw.md @@ -3,6 +3,7 @@ :crossed_flags: [English][EN], [Español][ES], +[Francais][FR], [Nederlands][NL], [Português][PT_BR], [Türkçe][TR], @@ -13,6 +14,7 @@ [AR]:CONTRIBUTING.ar.md [EN]:CONTRIBUTING.md [ES]:CONTRIBUTING.es.md +[FR]:CONTRIBUTING.fr.md [KO_KR]:CONTRIBUTING.ko_kr.md [PT_BR]:CONTRIBUTING.pt_br.md [TR]:CONTRIBUTING.tr.md