CONTRIBUTING.ar.md

المساهمة

🎌 Deutsch, English، Español، Français، Nederlands، Português، Türkçe، العربية، 正體中文، 简体中文، 한국어

تم ترقيم الكود المصدري في هذا المستودع يدويًا من مطبوعات ورقية، لذلك تم إدخال أخطاء مطبعية وما شابه بطريق الخطأ. يجب تعديل الكود ليكون متوافقًا مع المطبوعات الممسوحة:

• مطبوعات AGC لComanche
• مطبوعات AGC لLuminary

ملحقات مفيدة

يحتوي GitHub على دعم للغة تجميع AGC المضمنة. للاسف، لن يدعمه محرر الكود الخاص بك، ولكن هناك ملحقات توفر دعم للغة AGC من المحررين التاليين:

• Atom†
• CodeBlocks
• Eclipse
• Kate
• ProgrammersNotepad
• Sublime Text 3†
• TextPad
• Vim
• Visual Studio Code†
• jEdit

† يدعم التنسيق الآلي

التنسيق

ملاحظة: سيضمن GitHub والإضافات الثلاثة المذكورة أعلاه أنك تستخدم التنسيق الصحيح تلقائيًا.

• استخدام علامة التبويب للمسافة البادئة.
• استخدم العرض 8 لعلامة التبويب
• تقليم الفراغات التابعة

عما أفحص؟

أي تباينات بين الممسوحات والكود المصدري في هذا المستودع، بما في ذلك:

التعليقات

• يجب أن تتطابق التعليقات في الكود المنسوخ مع الممسوحات بالضبط
  • قد يتضمن ذلك إنشاء خطأ مطبعي متعمد أو إزالة أو إضافة تعليق بأكمله.

فواصل الأسطر

• على فواصل الأسطر التي تحتوي على R0000 في العمود 1 التطابق مع الممسوحات بالضبط.
• على فواصل الأسطر التي لا تحتوي على R0000 في العمود 1 أن تتكون من سطر فارغ واحد أو إثنين متتاليين.
  • إذا تتالى أكثر من سطرين فارغين، جرد الأسطر الإضافية.
    • لا يتم إعتبار الأسطر التي تحتوي على R0000 في العمود 1 في هذا.
  • في المصدر، تم إنشاء هذه الفواصل السطرية من خلال رقم غير مطبوع في العمود 8. وجود الرقم 2 هناك فرض فراغ مزدوج (سطر فارغ واحد) ووجود الرقم 3 فرض مساحة ثلاثية (سطران فارغان). تم تعريف القيم 4-8 ولكن لم تستخدم قط. اقرأ المزيد عنها في #159

مثلاً، ما يلي:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

يجب أن يصبح:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

الفراغات

• يجب أن تحترم الفراغات بين الحروف في سلاسل الاصطلاحية على حسب العرف التالي (راجع النقاش في #316):
  • فراغ واحد للكلمات الجديدة.
  • فراغان للجمل الجديدة.
  • ثلاث فراغات للمسافات البادئة.

مثلاً، ما يلي:

	1)  FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
	GARPLY, WALDO.

يجب أن يصبح:

	1) FOO BAR BAZ QUX QUUX QUUZ.  CORGE, GRAULT,
	   GARPLY, WALDO.

ملاحظة

قبل فتح طلبات السحب، يرجى التأكد من أن تغييراتك تتفق مع الممسوحات!