Apollo-11/CONTRIBUTING.lt.md

5.4 KiB

Prisidėti

🎌 Čeština, Deutsch, English, Español, Français, Italiano, Kurdi, Lietuvių, Nederlands, Norsk, Polski, Português, Türkçe, Ελληνικά, العربية, 日本語, 正體中文, 简体中文, 한국어

Šios saugyklos kodas buvo skaitmenizuotas iš popierinių spausdinių, todėl galima tikėtis klaidų ir kiti neatitikimų. Kodas turi būti pakeistas taip, kad labiau atitiktų šiuos skenuotus spausdinius:

Naudingi plėtiniai

GitHub turi integruotą AGC assemblerio kalbos sintakės palaikymą. Dėja, jūsų kodo redaktorius nepalaikys, tačiau yra AGC kalbos plėtinių, kurie suteikia sintakės paryškinimą šiems redaktoriams:

† Palaiko automatinį formatavimą

Formatavimas

Pastaba: GitHub ir plėtiniai nurodyti viršuje, užtikrins, kad jūs naudojate teisingą formatavimą.

  • Naudokite skirtuko įtrauką
  • Naudokite skirtuko plotį 8
  • Ištrinkite galinius tarpus

Ką man reikia patikrinti?

Betkokius neatitikimus tarp skenuočių ir šaltinio kodo šioje saugykloje.

Komentarai

  • Komentarai perrašytame kode turi tiksliai atitikti skenuočių komentarus.

Dažnai pasikartojančios problemos, į kurias turėtumėte atkreipti dėmesį, taip pat neapsiribojant jomis:

Tipografinės klaidos

Kai kuriose vietose, originalūs kūrėjai paliko tipografinių klaidų rašant komentarus. Kai kurie iš jų buvo klaidingai ištaisyti per pradinį skaitmenizavimą, vis dėlto skaitmenizavimas taip pat tai pat pridėjo tipografinių klaidų, kurių nebuvo skenuotėse.

Pavyzdžiui, jeigu skaitmenizuotas komentaras turėjo žodį SPACECRAFT, bet SPAECRAFT buvo išspausdintas skenuotėse, tai ši skaitmenizacija turi būti pataisyta į SPAECRAFT (be C).

Taip pat, jeigu žodis turi klaidą skaitmenizacijoje, bet yra parašytas teisingai skenuotėse, tai ta klaida turi būti pataisyta.

Tarpai

  • Tarpai tarp dviejų rašmenų turi atitikti skenuotes. Dažniausiu atvėju (žiūrėti diskusiją #316), tai yra:
    • Vienas tarpas naujiems žodžiams.
    • Dvigubas tarpas naujiems sakiniams.
    • Trigubas tarpas įtraukoms.

Nevisi puslapiai skenuotėse laikosi šių taisykių, jeigu skenuotės turi tik vieną tarpą vietoj dvigubo tarpo, reikia naudoti vieną tarpą.

Eilučių lūžiai

  • Linijų lūžiai su pločiu R0000 pirmame stulpelyje turi tiksliai atitikti skenuotes.
  • Linijų lūžiai su pločiu*out* R0000 pirmame stulpelyje gali turėti tik vieną arba dvi tuščias eilutes iš eilės.
    • Jeigu yra daugiau negu dvi tuščios linijos, reikia ištrinti papildomas eilutes.
      • Linijos su R0000 pirmame stulpelyje nesiskaičiuoja.
    • Šaltinių nuotraukose, šitie buvo sukurti nespausdintu skaitmeniu aštuntame stulpelyje. A 2 - ten buvo dvigubas tarpas (viena tuščia eilutė) ir a 3 buvo trigubas tarpas (dviguba tuščia eilutė). Reikšmės nuo 4-8 buvo apibrėžtos, bet niekada nenaudotos. Daugiau apie tai #159

Pavyzdžiui, šis tekstas:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Turėtų patapti:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Pastabos

Prieš kuriant PR, prašome įsitikinti, kad jūsų pakeitimai atitinka skenuotes!