2019-06-16 15:47:45 +00:00
< div dir = "RTL" >
# المساهمة
2020-06-02 00:13:46 +00:00
🎌
2020-05-05 17:30:37 +00:00
[Deutsch][DE],
2020-01-08 21:10:57 +00:00
[English][EN]،
2020-02-26 20:38:18 +00:00
[Español][ES]،
2020-03-01 20:32:10 +00:00
[Français][FR]،
2020-02-26 10:18:07 +00:00
[Nederlands][NL]،
2020-01-08 21:10:57 +00:00
[Português][PT_BR]،
[Türkçe][TR]،
**العربية**،
[正體中文][ZH_TW]،
[简体中文][ZH_CN]،
2020-01-05 17:39:14 +00:00
[한국어][KO_KR]
2019-06-16 15:47:45 +00:00
[AR]:CONTRIBUTING.ar.md
2020-05-05 17:30:37 +00:00
[DE]:CONTRIBUTING.de.md
2020-01-05 17:39:14 +00:00
[EN]:CONTRIBUTING.md
2020-02-26 20:38:18 +00:00
[ES]:CONTRIBUTING.es.md
2020-02-27 18:21:57 +00:00
[FR]:CONTRIBUTING.fr.md
2019-06-16 15:47:45 +00:00
[KO_KR]:CONTRIBUTING.ko_kr.md
2020-02-27 18:31:08 +00:00
[NL]:CONTRIBUTING.nl.md
2020-01-05 17:39:14 +00:00
[PT_BR]:CONTRIBUTING.pt_br.md
2019-10-14 20:10:11 +00:00
[TR]:CONTRIBUTING.tr.md
2020-01-07 17:48:10 +00:00
[ZH_CN]:CONTRIBUTING.zh_cn.md
2020-01-07 17:42:10 +00:00
[ZH_TW]:CONTRIBUTING.zh_tw.md
2019-06-16 15:47:45 +00:00
تم ترقيم الكود المصدري في هذا المستودع يدويًا من مطبوعات ورقية، لذلك تم إدخال أخطاء مطبعية وما شابه بطريق الخطأ. يجب تعديل الكود ليكون متوافقًا مع المطبوعات الممسوحة:
2020-06-01 23:29:19 +00:00
- [مطبوعات AGC لComanche][8]
- [مطبوعات AGC لLuminary][9]
2019-06-16 15:47:45 +00:00
## ملحقات مفيدة
يحتوي GitHub على دعم للغة تجميع AGC المضمنة. للاسف، لن يدعمه محرر الكود الخاص بك، ولكن هناك ملحقات توفر دعم للغة AGC من المحررين التاليين:
2020-06-01 23:29:19 +00:00
2020-02-19 05:25:00 +00:00
- [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]
† يدعم التنسيق الآلي
2019-06-16 15:47:45 +00:00
## التنسيق
2020-06-01 23:29:19 +00:00
2019-06-16 15:47:45 +00:00
**ملاحظة:** سيضمن GitHub والإضافات الثلاثة المذكورة أعلاه أنك تستخدم التنسيق الصحيح تلقائيًا.
- استخدام علامة التبويب للمسافة البادئة.
- استخدم العرض 8 لعلامة التبويب
- تقليم الفراغات التابعة
## عما أفحص؟
2020-06-01 23:29:19 +00:00
2019-06-16 15:47:45 +00:00
أي تباينات بين الممسوحات والكود المصدري في هذا المستودع، بما في ذلك:
### التعليقات
2020-06-01 23:29:19 +00:00
2019-06-16 15:47:45 +00:00
- يجب أن تتطابق التعليقات في الكود المنسوخ مع الممسوحات بالضبط
- قد يتضمن ذلك إنشاء خطأ مطبعي متعمد أو إزالة أو إضافة تعليق بأكمله.
### فواصل الأسطر
2020-06-01 23:29:19 +00:00
2019-06-16 15:47:45 +00:00
- على فواصل الأسطر التي *تحتوي على* `R0000` في العمود 1 التطابق مع الممسوحات بالضبط.
- على فواصل الأسطر التي __ لا *تحتوي على* `R0000` في العمود 1 أن تتكون من سطر فارغ واحد أو إثنين متتاليين.
- إذا تتالى أكثر من سطرين فارغين، جرد الأسطر الإضافية.
- لا يتم إعتبار الأسطر التي تحتوي على `R0000` في العمود 1 في هذا.
- في المصدر، تم إنشاء هذه الفواصل السطرية من خلال رقم غير مطبوع في العمود 8. وجود الرقم 2 هناك فرض فراغ مزدوج (سطر فارغ واحد) ووجود الرقم 3 فرض مساحة ثلاثية (سطران فارغان). تم تعريف القيم 4-8 ولكن لم تستخدم قط. اقرأ المزيد عنها في [#159][7]
مثلاً، ما يلي:
2020-06-01 23:29:19 +00:00
< / div >
2019-06-16 15:47:45 +00:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
```
2020-06-01 23:29:19 +00:00
< div dir = "RTL" >
2019-06-16 15:47:45 +00:00
يجب أن يصبح:
2020-06-01 23:29:19 +00:00
< / div >
2019-06-16 15:47:45 +00:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
```
2020-06-01 23:29:19 +00:00
< div dir = "RTL" >
2019-06-16 15:47:45 +00:00
### الفراغات
2020-06-01 23:29:19 +00:00
2019-06-16 15:47:45 +00:00
- يجب أن تحترم الفراغات بين الحروف في سلاسل الاصطلاحية على حسب العرف التالي (راجع النقاش في [#316][10]):
- فراغ واحد للكلمات الجديدة.
- فراغان للجمل الجديدة.
- ثلاث فراغات للمسافات البادئة.
2020-01-05 17:39:14 +00:00
2019-06-16 15:47:45 +00:00
مثلاً، ما يلي:
2020-06-01 23:29:19 +00:00
< / div >
2019-06-16 15:47:45 +00:00
```plain
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
```
2020-06-01 23:29:19 +00:00
< div dir = "RTL" >
2019-06-16 15:47:45 +00:00
يجب أن يصبح:
2020-06-01 23:29:19 +00:00
< / div >
2019-06-16 15:47:45 +00:00
```plain
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
```
2020-06-01 23:29:19 +00:00
< div dir = "RTL" >
2019-06-16 15:47:45 +00:00
## ملاحظة
قبل فتح طلبات السحب، يرجى التأكد من أن تغييراتك تتفق مع الممسوحات!
2020-06-01 23:29:19 +00:00
< / div >
2019-06-16 15:47:45 +00:00
[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
2020-06-01 23:29:19 +00:00
[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
