Polish CONTRIBUTING (#727)
Co-authored-by: James Harris <wopian@wopian.me>
This commit is contained in:
		
							
								
								
									
										153
									
								
								CONTRIBUTING.pl.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										153
									
								
								CONTRIBUTING.pl.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,153 @@ | ||||
| # Contributing | ||||
|  | ||||
| 🎌 | ||||
| [Čeština][CZ], | ||||
| [Deutsch][DE], | ||||
| [English][EN], | ||||
| [Español][ES], | ||||
| [Français][FR], | ||||
| [Italiano][IT], | ||||
| [Kurdi][KU], | ||||
| [Lietuvių][LT], | ||||
| [Nederlands][NL], | ||||
| [Norsk][NO], | ||||
| **Polski**, | ||||
| [Português][PT_BR], | ||||
| [Türkçe][TR], | ||||
| [Ελληνικά][GR], | ||||
| [العربية][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 | ||||
| [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 | ||||
|  | ||||
| Kod źródłowy w tym repozytorium został zdigitalizowany ręcznie na podstawie wydruków papierowych, więc literówki i inne rozbieżności zostały wprowadzone przypadkowo. Kod należy zmodyfikować, aby był zgodny z zeskanowanymi wydrukami: | ||||
|  | ||||
| - [AGC printouts for Comanche][8] | ||||
| - [AGC printouts for Luminary][9] | ||||
|  | ||||
| ## Przydatne rozszerzenia | ||||
|  | ||||
| GitHub obsługuje składnię wbudowanego języka asemblera AGC. Niestety twój edytor kodu prawdopodobnie nie będzie go obsługiwał, jednak istnieją rozszerzenia języka AGC, które zapewniają obsługę składni tego języka dla następujących edytorów: | ||||
|  | ||||
| - [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] | ||||
|  | ||||
| † Wspiera automatyczne formatowanie | ||||
|  | ||||
| [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 | ||||
|  | ||||
| ## Formatowanie | ||||
|  | ||||
| **Uwaga:** GitHub wraz z powyższymi rozszerzeniami zapewniają automatyczne użycie prawidłowego formatowana | ||||
|  | ||||
| - Tabulacja | ||||
| - Szerokość tabulacji wynosząca 8 | ||||
| - Niepozostawianie spacji na końcu wierszy | ||||
|  | ||||
| ## Co mam sprawdzać? | ||||
|  | ||||
| Wszelkie rozbieżności między skanami a kodem źródłowym tego repozytorium. | ||||
|  | ||||
| ### Komentarze | ||||
|  | ||||
| Komentarze w transkrybowanym kodzie **MUSZĄ DOKŁADNIE** odpowiadać skanom. | ||||
|  | ||||
| Typowe problemy, na które należy zwrócić uwagę podczas sprawdzania, obejmują między innymi: | ||||
|  | ||||
| #### Literówki | ||||
|  | ||||
| W niektórych miejscach pierwotni programiści popełnili błędy typograficzne podczas pisania komentarzy. Niektóre z nich zostały błędnie poprawione podczas wstępnej digitalizacji, jednak digitalizacja wprowadziła również błędy typograficzne, których nie było w skanach. | ||||
|  | ||||
| Na przykład, jeśli zdigitalizowane komentarze zawierały słowo „SPACECRAFT”, ale na skanach odczytano „SPAECRAFT”, wówczas digitalizacja **MUSI** zostać poprawiona na „SPAECRAFT” (brakujące „C”). | ||||
|  | ||||
| Podobnie, jeśli słowo zawiera literówkę w digitalizacji, ale jest poprawnie napisane na skanach, wówczas literówka **MUSI** zostać poprawiona. | ||||
|  | ||||
| #### Spacje | ||||
|  | ||||
| Spacje pomiędzy dwoma znakami w danym ciągu powinny być zgodne z następującą konwencją (patrz na [#316][10]): | ||||
|  | ||||
| - Pojedyńcza spacja dla nowego słowa. | ||||
| - Podwójna spacja dla nowego zdania. | ||||
| - Potrójna spacja dla akapitu. | ||||
|  | ||||
| Nie wszystkie strony w skanach są zgodne z tym uogólnieniem, jeśli skany mają tylko jedną spację zamiast podwójnej, użyj jednej spacji. | ||||
|  | ||||
| ### Rozdzielanie wierszy | ||||
|  | ||||
| - Wiersz *rozpoczynający się od* `R0000` w kolumnie 1 powinien dokładnie pasować do skanów. | ||||
| - Wiersz *nierozpoczynający się od* `R0000` w kolumnie 1 powinien zawierać tylko 1 lub 2 puste wiersze z rzędu. | ||||
|   - Jeżeli są więcej niż 2 puste wiersze - usuń ich nadmiar. | ||||
|     - Wiersze rozpoczynające się od `R0000` w kolumnie 1 nie są zaliczane jako pusty wiersz. | ||||
|   - W obrazach źródłowych puste linie zostały utworzone przez niezadrukowaną cyfrę w kolumnie 8. 2 wymusiło podwójną spację (pojedyncza pusta linia), a 3 wymusiło potrójną spację (podwójna pusta linia). Wartości 4-8 zostały zdefiniowane, ale nigdy nie były używane. Więcej na ten temat w [#159][7] | ||||
|  | ||||
| Na przykład: | ||||
|  | ||||
| ```plain | ||||
| R0819   SUBROUTINE TO SKIP... | ||||
| R0820 | ||||
|  | ||||
|  | ||||
|  | ||||
|  0821   LAMPTEST  CS  IMODES33 | ||||
| ``` | ||||
|  | ||||
| Zostaje zmienione na: | ||||
|  | ||||
| ```plain | ||||
| R0819   SUBROUTINE TO SKIP... | ||||
| R0820 | ||||
|  | ||||
|  | ||||
|  0820   LAMPTEST  CS  IMODES33 | ||||
| ``` | ||||
|  | ||||
| ## Uwaga | ||||
|  | ||||
| Zanim utworzysz PR, upewnij się, że zmiany są zgodne ze skanami! | ||||
|  | ||||
| [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 | ||||
		Reference in New Issue
	
	Block a user