f3d3081767
* add file CONTRIBUTING.zh_cn.md as a chinese version for CONTRIBUTING.md * Update CONTRIBUTING.md * Update CONTRIBUTING.zh_cn.md * Update CONTRIBUTING.ko_kr.md * Update CONTRIBUTING.ar.md * Update CONTRIBUTING.zh_cn.md Resolve some grammar issue and syntax errors . @liyishuai And thank you for your reviews * Update CONTRIBUTING.zh_cn.md * Update CONTRIBUTING.zh_cn.md * Update CONTRIBUTING.zh_cn.md Co-authored-by: James Harris <wopian@wopian.me>
4.3 KiB
4.3 KiB
المساهمة
🎌 English, Português, Türkçe, العربية, 正體中文, 简体中文, 한국어
تم ترقيم الكود المصدري في هذا المستودع يدويًا من مطبوعات ورقية، لذلك تم إدخال أخطاء مطبعية وما شابه بطريق الخطأ. يجب تعديل الكود ليكون متوافقًا مع المطبوعات الممسوحة:
ملحقات مفيدة
يحتوي GitHub على دعم للغة تجميع AGC المضمنة. للاسف، لن يدعمه محرر الكود الخاص بك، ولكن هناك ملحقات توفر دعم للغة AGC من المحررين التاليين:
التنسيق
ملاحظة: سيضمن 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.
ملاحظة
قبل فتح طلبات السحب، يرجى التأكد من أن تغييراتك تتفق مع الممسوحات!