Skip to content

Latest commit

 

History

History
176 lines (135 loc) · 6.43 KB

CONTRIBUTING.az.md

File metadata and controls

176 lines (135 loc) · 6.43 KB

Töhfə

🌐 Azerbaijani, bahasa Indonesia, Català، Čeština, Dansk, Deutsch, English, Español, Français, Galego, Italiano, Kurdi, Kurdî, Lietuvių, Mongolia, Nederlands, Norsk, Polski, Português, tiếng Việt, Türkçe, Ελληνικά, Українська، العربية, हिन्दी, 한국어, 日本語, 正體中文, 简体中文

Bu repodakı mənbə kodu kağız çıxışlarından əl ilə rəqəmsallaşdırılıb. Belə ki, yanlışlıqla hərf səhvləri və digər uyğunsuzluqlar edilib. Kod aşağıdakı skan edilmiş çıxışa uyğun olmaq üçün redaktə edilməlidir:

The following website can be used to easily navigate around the scanned printouts for both Comanche and Luminary: https://28gpc.csb.app/

Faydalı Pluginlər

GitHub, AGC assembly dili için sentaks desteği sağlıyor ama sizin kodu düzenlemek için kullandığınız editör sağlamayacaktır. Aşağıdaki editörler AGC dili sentaks vurgulaması için eklentiler sunmaktadır:

GitHub, AGC assembly dilinin sintaksını dəstəkləyir amma sizin kodu redaktə etmək üçün istifadə edəcəyiniz IDE dəstəkləməyəcək. Aşağıdakı IDE-lər AGC dili üçün sintaks dəstəyi təqdim etməkdədir.

† Avtomatik formatlaşdırmanı dəstəkləyirlər

Formatlaşdırma

Not: GitHub və yuxarıdakı 3 plagin avtomatik olaraq düzgün formatlaşdırmadan istifadə etməyə imkan verəcək.

  • Girintiləməni TAB ilə buraxın.
  • 8 TAB genişliyi istifadə edin.
  • Davamındakı boşluqları silin.

Nəyi kontrol edim?

Skan edilmiş çıxışlar və bu repodakı mənbə kodu arasında hər hansı uyğunsuzluq.

Şərhlər

Uyğunlaşdırılmış koddakı şərh sətirləri çıxışlarla dəqiq uyğunlaşmalıdır.

Düzəltmək üçün axtarmaq lazım olan bəzi əsas problemlər bunlardır:

Yazım Xətaları

Bəzi yerlərdə orijinal tərtibatçılar şərhləri yazarkən hərf səhvlərinə yol verdiblər. Bunlardan bəziləri rəqəmsallaşdırma prosesinin əvvəlində səhvən düzəldildi, lakin rəqəmsallaşdırma prosesi skan edilmiş çıxışda olmayan yeni yazı xətaları da yol açdı.

Məsələn, rəqəmsal şərhlərdə SPACECRAFT sözü varsa, lakin skan edilmiş çaplarda SPAECRAFT oxunursa, rəqəmsal şərh SPAECRAFT olaraq düzəldilməlidir (C yoxdur).

Eyni şəkildə, rəqəmsal şərhlərdə yazı xətası varsa, lakin skan edilmiş çaplar düzgün yazılıbsa, yazı xətası düzəldilməlidir.

Boşluqlar

Şərhlər arasındakı iki simvol arasındakı boşluqlar skan edilmiş çıxışa uyğun olmalıdır. Əksər hallarda (#316-da müzakirəyə baxın) boşluqlar aşağıdakılardır:

  • Yeni sözlər arasında tək boşluq.
  • Yeni cümlələr arasında iki boşluq.
  • Yeni girintilər üçün üç boşluq.

Skan edilmiş çaplardakı bütün səhifələr bu ümumiləşdirmələrə uyğun gəlmir. Çıxışda iki boşluq əvəzinə boşluq varsa, bir boşluqdan istifadə edin.

Sətir sonları

  • İlk sütunu "R0000" ilə bitən sətir sonları çıxışa tam uyğun gəlməlidir.
  • Birinci sütunda R0000 olmadan ilə bitən sətir sonunda yalnız 1 və ya 2 boş sətir olmalıdır.
    • Əgər 2-dən çox sətir sonu varsa artıq olanları silin.
      • Birinci sütunu R0000 ilə bitən sətirlər bu qanun daxilində deyillər.
    • Mənbə şəkillərində onlar 8-ci sətirdə basdırılmamış rəqəmlə yaradılmışdır. 2 iki boşluğu (bir boş sətir), 3 isə üç boşluğu (iki boş sətir) təmsil edir. 4 və 8 müəyyən edilmişdir, lakin heç vaxt istifadə edilməmişdir. Bu barədə daha çox oxumaq üçün: #159

Məsələn bu:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Buna çevrilməlidir:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Not

PR-dən əvvəl, zəhmət olmasa, dəyişikliklərinizin nəticələrə uyğun olduğundan əmin olun!