2020-05-05 17:30:37 +00:00
# Contributing
2020-06-02 00:13:46 +00:00
🎌
2020-05-05 17:30:37 +00:00
**Deutsch**,
[English][EN],
[Español][ES],
[Français][FR],
2020-08-01 01:03:24 +00:00
[Kurdi][KU],
2020-05-05 17:30:37 +00:00
[Nederlands][NL],
[Português][PT_BR],
[Türkçe][TR],
[العربية][AR],
2020-08-17 18:19:05 +00:00
[日本語][JA],
2020-05-05 17:30:37 +00:00
[正體中文][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
2020-08-17 18:19:05 +00:00
[JA]:CONTRIBUTING.ja.md
2020-05-05 17:30:37 +00:00
[KO_KR]:CONTRIBUTING.ko_kr.md
2020-08-01 01:03:24 +00:00
[KU]:CONTRIBUTING.ku.md
2020-05-05 17:30:37 +00:00
[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
2020-09-16 15:09:28 +00:00
Der Quellcode in diesem Repository wurde manuell digitalisiert, also sind jegliche schriftlichen Fehler und Ungereimtheiten aus Versehen hinzugefügt worden. Der Code soll so modifiziert werden, dass er mit den Vorlagen übereinstimmt.
2020-05-05 17:30:37 +00:00
2020-06-01 23:29:19 +00:00
- [AGC printouts for Comanche][8]
- [AGC printouts for Luminary][9]
2020-05-05 17:30:37 +00:00
## Nützliche Erweiterungen
2020-09-16 15:09:28 +00:00
GitHub hat eine integrierte Unterstützung für AGC assembly. Das gilt leider nicht für deinen Editor. Für die folgenden Editoren gibt es aber AGC-Erweiterungen, die Syntaxhighlighting hinzufügen:
2020-06-01 23:29:19 +00:00
2020-05-05 17:30:37 +00:00
- [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]
2020-09-16 15:09:28 +00:00
† unterstützt auch automatisches Formatieren
2020-05-05 17:30:37 +00:00
[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
2020-06-01 23:29:19 +00:00
## Formatierung
2020-09-16 15:09:28 +00:00
**Anmerkung:** GitHub und die oben erwähnten Erweiterungen werden automatisch sicherstellen, dass du die korrekte Formatierung einhältst.
2020-05-05 17:30:37 +00:00
- benutze tab indentation
- benutze tab width von 8
2020-09-16 15:09:28 +00:00
- entferne Leerzeichen am Ende einer Zeile
2020-05-05 17:30:37 +00:00
2020-09-16 15:09:28 +00:00
## Was soll ich überprüfen?
2020-05-05 17:30:37 +00:00
2020-09-16 15:09:28 +00:00
Alle Ungereimtheiten zwischen den Scans und dem Code in diesem Repository, einschließlich:
2020-06-01 23:29:19 +00:00
### Kommentare
2020-09-16 15:09:28 +00:00
- Kommentare in dem abgeschriebenen Code müssen denen in den Scans gleichen
- Das kann bedeuten, dass man einen Rechtschreibfehler übernehmen oder einen ganzen Kommentar entfernen/hinzufügen muss
2020-06-01 23:29:19 +00:00
2020-05-05 17:30:37 +00:00
### Zeilenumbruch
2020-06-01 23:29:19 +00:00
2020-09-16 15:09:28 +00:00
- Zeilenumbrüche *mit* `R0000` in Spalte 1 sollte genau mit den Scans übereinstimmen
- Zeilenumbrüche *__ohne__* `R0000` in Spalte 1 sollten nur ein bis zwei Leerzeilen nacheinander haben
- Wenn es dort mehr als zwei Leerzeilen gibt, sollten die zusätzlichen Leerzeilen entfernt werden.
2020-06-01 23:29:19 +00:00
- Zeilen mit `R0000` in Spalte 1 zählen nicht dazu
2020-09-16 15:09:28 +00:00
- In den Originalbildern wurden die durch eine nicht gedruckte Ziffer in Spalte 8 verursacht. Eine 2 dort hat ein doppeltes Leerzeichen (einzelne Leerzeile) und eine 3 hat ein dreifaches Leerzeichen (doppelte Leerzeile). Die Werte 4-8 wurden definiert, aber nie benutzt. Mehr dazu hier: [#159][7]
2020-06-01 23:29:19 +00:00
2020-09-16 15:09:28 +00:00
Beispiel:
2020-06-01 23:29:19 +00:00
2020-05-05 17:30:37 +00:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
```
2020-06-01 23:29:19 +00:00
2020-09-16 15:09:28 +00:00
wird zu:
2020-06-01 23:29:19 +00:00
2020-05-05 17:30:37 +00:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
```
## Hinweis
2020-09-16 15:09:28 +00:00
Bevor du einen PR startest, überprüfe bitte, ob die Änderungen mit den Scans übereinstimmen!
2020-05-05 17:30:37 +00:00
[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/
2020-09-16 15:09:28 +00:00
[10]:https://github.com/chrislgarry/Apollo-11/pull/316#pullrequestreview-102892741
