diff --git a/CONTRIBUTING.ar.md b/CONTRIBUTING.ar.md index 5dca6ad..d2aebeb 100644 --- a/CONTRIBUTING.ar.md +++ b/CONTRIBUTING.ar.md @@ -45,16 +45,16 @@ [ZH_CN]:CONTRIBUTING.zh_cn.md [ZH_TW]:CONTRIBUTING.zh_tw.md -تم ترقيم الكود المصدري في هذا المستودع يدويًا من مطبوعات ورقية، لذلك تم إدخال أخطاء مطبعية وما شابه بطريق الخطأ. يجب تعديل الكود ليكون متوافقًا مع المطبوعات الممسوحة: +تمّت رقمنة الكود المصدر في هذا المستودع يدويًا من مطبوعات ورقية، لذلك طرأت أخطاء طباعية و تباينات أخرى سهوًا. يجب تعديل الكود ليتّفق مع المسوحات الضوئية للطبعات التالية: -- [مطبوعات AGC لComanche][8] -- [مطبوعات AGC لLuminary][9] +- [طبعات AGC لكود Comanche][8] +- [طبعات AGC لكود Luminary][9] ## ملحقات مفيدة -يحتوي GitHub على دعم للغة تجميع AGC المضمنة. للاسف، لن يدعمه محرر الكود الخاص بك، ولكن هناك ملحقات توفر دعم للغة AGC من المحررين التاليين: +يحوي GitHub دعمًا للتلوين النحويِّ للغة التجميع AGC، و مع أنّ محررات الكود الشائعة لا تدعم ذلك، إلا أنه ثمّة ملحقات توفر الدعم للغة AGC لكلٍ مِنْ المحررات التالية: -- [Atom][Atom]† +- [Atom][Atom]۞ - [CodeBlocks][CodeBlocks] - [Eclipse][Eclipse] - [Kate][Kate] @@ -65,36 +65,55 @@ - [Visual Studio Code][VisualStudioCode]† - [jEdit][jEdit] -† يدعم التنسيق الآلي +۞ يدعم التنسيق الآلي ## التنسيق -**ملاحظة:** سيضمن GitHub والإضافات الثلاثة المذكورة أعلاه أنك تستخدم التنسيق الصحيح تلقائيًا. +**ملاحظة:** GitHub و الملحقات المذكورة أعلاه تضمن تلقائيًّا استخدام التنسيق الصحيح. -- استخدام علامة التبويب للمسافة البادئة. -- استخدم العرض 8 لعلامة التبويب -- تقليم الفراغات التابعة +- استخدام علامة الجدولة للإزاحة أوّل السطر. +- تعيين طول علامة الجدولة بثمان مسافات. +- حذف المسافات اللاحقة للنصوص في السطر -## عما أفحص؟ +## المطلوب التحقّق منه -أي تباينات بين الممسوحات والكود المصدري في هذا المستودع، بما في ذلك: +التباينات بين المسوحات الضوئية و الكود المصدر في هذا المستودع، بما في ذلك: ### التعليقات -- يجب أن تتطابق التعليقات في الكود المنسوخ مع الممسوحات بالضبط - - قد يتضمن ذلك إنشاء خطأ مطبعي متعمد أو إزالة أو إضافة تعليق بأكمله. +يجب أن تتطابق التعليقات في الكود المنسوخ مع ما في المسوحات حرفيًّا -### فواصل الأسطر +من الجوانب التي ينبغي تحرّيها عند المراجعة: -- على فواصل الأسطر التي *تحتوي على* `R0000` في العمود 1 التطابق مع الممسوحات بالضبط. -- على فواصل الأسطر التي __لا__ *تحتوي على* `R0000` في العمود 1 أن تتكون من سطر فارغ واحد أو إثنين متتاليين. - - إذا تتالى أكثر من سطرين فارغين، جرد الأسطر الإضافية. - - لا يتم إعتبار الأسطر التي تحتوي على `R0000` في العمود 1 في هذا. - - في المصدر، تم إنشاء هذه الفواصل السطرية من خلال رقم غير مطبوع في العمود 8. وجود الرقم 2 هناك فرض فراغ مزدوج (سطر فارغ واحد) ووجود الرقم 3 فرض مساحة ثلاثية (سطران فارغان). تم تعريف القيم 4-8 ولكن لم تستخدم قط. اقرأ المزيد عنها في [#159][7] +#### الأخطاء الطباعية +في بعض المواضع وقع مطوّرو البرمجية في أخطاء طباعية أثناء إدخال نصوص التعليقات، و قد تم تصويب بعض تلك الأخطاء من باب الخطأ في أثناء إنجاز الرقمنة ابتداءً، كما طرأت أخطاء أثناء الرقمنة لم توجد في الأصل. -مثلاً، ما يلي: - +على سبيل المثال، إذا تضمّنت التعليقات في الكود في المستودع كلمة `SPACECRAFT` بينما وجدت في الموضع المقابل في المسوحات الضوئية `SPAECRAFT` فيجب تصويب النص إلى `SPAECRAFT` بإغفال حرف `C` +كذلك إذا وُجد في كلمة في الكود المٌرقمَن خطأ طباعي غير موجود في المسوحات الضوئية فيجب تصويبه. + +#### المسافات + +يجب أن تُطابِق المسافات بين الأحرف في الكود المُرقمَن نظيراتها في المسوحات الضوئية، و ذلك يكون على النحو التالي في أغلب الحالات (طالعوا النقاش في [#316][10]): + +- مسافة واحدة بين الكلمات +- مسافتين بين العبارات +- ثلاث مسافات لإزاحة أوّل السطر + +- لكن الصفحات في المسوحات الضوئية لا تتبع كلّها تلك القواعد، و عند التباين يجب اتّباع ما في المسوحات الضوئية. + +### السطور + +- السطور التي *تحوي* `R0000` في العمود 1 يجب أن تطابق الممسوحات حرفيًّا. +- السطور التي __لا__ *تحوي* `R0000` في العمود 1 يجب أن يسبقها سطر فارغ واحد أو اثنين متتاليين. + - إذا وُجد أكثر من سطرين فارغين متتاليين يجب حذف الزائد منها. + - لا تؤخذ الأسطر التي تحوي `R0000` في العمود 1 في الحسبان. + - في المصدر، أنشئت تلك الفواصل بوضع رقم غير مطبوع في العمود 8. فوجود الرقم 2 في ذلك الموضع أوجد فراغًا مزدوجًا (سطر فارغ واحد) و وجود الرقم 3 أوجد فراغًا ثلاثيًّا (سطرين فارغين). القيم 4-8 كانت مُعرَّفة لكنها لم تستخدم قط. المزيد عن هذا في [#159][7] + +على سبيل المثال: + +
+ ```plain R0819 SUBROUTINE TO SKIP... R0820 @@ -103,11 +122,11 @@ R0820 0821 LAMPTEST CS IMODES33 ``` - -
-يجب أن يصبح:
+يُصوّب إلى: +
+ ```plain R0819 SUBROUTINE TO SKIP... R0820 @@ -115,38 +134,13 @@ R0820 0820 LAMPTEST CS IMODES33 ``` - -
- -### الفراغات - -- يجب أن تحترم الفراغات بين الحروف في سلاسل الاصطلاحية على حسب العرف التالي (راجع النقاش في [#316][10]): - - فراغ واحد للكلمات الجديدة. - - فراغان للجمل الجديدة. - - ثلاث فراغات للمسافات البادئة. - -مثلاً، ما يلي:
-```plain - 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT، - GARPLY, WALDO. -``` -
-يجب أن يصبح: -
- -```plain - 1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT، - GARPLY, WALDO. -``` - -
## ملاحظة -قبل فتح طلبات السحب، يرجى التأكد من أن تغييراتك تتفق مع الممسوحات! +قبل وضع طلب الدمج، يُرجى التأكد من اتفاق تحريراتكم مع المسوحات!
diff --git a/README.ar.md b/README.ar.md index 5f7eab00..b587ff3 100644 --- a/README.ar.md +++ b/README.ar.md @@ -69,48 +69,48 @@ [ZH_CN]:README.zh_cn.md [ZH_TW]:README.zh_tw.md -الكود المصدري الأصلي لحاسوب الارشاد لمهمة أبولو 11 (AGC) المستخدم في المركبة القيادية (Comanche055) والمركبة القمرية (Luminary099). تم ترقيمه من قبل [AGC الافتراضية][3] و[متحف MIT][4]. هدف المستودع : توفير مجموعة شاملة من الكود المصدر الأصلي لمهمة أبولو الأصلي لأبولو 11 (AGC). نرحب بطلبات السحب لأي اختلاف يُلاحَظ بين النُسخ في هذا المستودع والمسح الأصلي ل(Luminary099) و(Comanche055)، أو أي ملف قد تم تفويته. +هذا هو الكود المصدر الأصلي لحاسوب الارشاد لمهمة أبولو 11 (AGC) المستخدم في مركبة القيادة (Comanche055) و المركبة القمرية (Luminary099) الذي أتمّ رقمنته القائمون على مشروع [AGC iالافتراضي][3] و [متحف MIT][4] بهدف إنشاء مستودع للكود المصدر الأصلي لمهمة أبولو 11. نرحب بطلبات دمج الكود التي تعالج أيّ تباين بين الكود المحفوظ في هذا المستودع و المسوحات الأصلية لكود (Luminary099) و (Comanche055)، أو أيّة ملفات أكون قد أغفلتها. ## المساهمة -رجاءً راجع [CONTRIBUTING.ar.md][7] قبل فتح طلب سحب. +طالعوا [CONTRIBUTING.ar.md][7] قبل إيداع طلب الدمج. ## التجميع -إذا كنت مهتماً بتجميع الكود المصدري الأصلي، راجع [AGC الافتراضية][8]. +إذا أردتم تجميع الكود المصدر الأصلي فطالعوا مشروع [AGC الافتراضي][8]. -## الاسناد +## النسبة   |   -------------: | -----: -حقوق النشر | المجال العام -Comanche055 | جزء من الكود المصدري لColossus 2A، حاسوب ارشاد أبولو (AGC) للمركبة القيادية (CM) لأبولو 11
`Assemble revision 055 of AGC program Comanche by NASA`
`2021113-051. 10:28 APR. 1, 1969` -Luminary099 | جزء من الكود المصدري لLuminary 1A، حاسوب ارشاد أبولو (AGC) للمركبة القمرية (LM) لأبولو 11
`Assemble revision 001 of AGC program LMY99 by NASA`
`2021112-061. 16:27 JUL. 14, 1969` -المُركِب | yaYUL +حقوق النشر | في الملك العام +Comanche055 | جزء من الكود المصدري للنظامColossus 2A، حاسوب ارشاد أبولو (AGC) للمركبة القيادية (CM) لأبولو 11
`Assemble revision 055 of AGC program Comanche by NASA`
`2021113-051. 10:28 APR. 1, 1969` +Luminary099 | جزء من الكود المصدري للنظامLuminary 1A، حاسوب ارشاد أبولو (AGC) للمركبة القمرية (LM) لأبولو 11
`Assemble revision 001 of AGC program LMY99 by NASA`
`2021112-061. 16:27 JUL. 14, 1969` +المُجمِّع | yaYUL للتواصل | رون بركي -الموقع الالكتروني | www.ibiblio.org/apollo -الترقيم | تم استنساخ الكود المصدري وتكييفه من صور مرقمة لنسخة مطبوعة متوفرة في متحف MIT. تم الترقيم بواسطة بول فيلد (Paul Fjeld)، وقامت ديبورا دوغلاس (Deborah Douglas) من المتحف بترتيبه. نعبر عن شكرنا العميق لكليهما على جهودهما في هذا الصدد. +الموقع على الوِب | www.ibiblio.org/apollo +الرقمنة | تم استنساخ الكود المصدري و تحويله من صور رقمية صُنعت بالمسح الضوئي من نسخة مطبوعة موجودة في متحف MIT. قام بالرقمنة بول فيلد (Paul Fjeld)، بتنسيق من ديبورا دوغلاس (Deborah Douglas) من المتحف، فلهما جزيل الشكر. ### العقد والموافقات *مستمدة من [CONTRACT_AND_APPROVALS.agc]* -سيشار لبرنامج الAGC هذا بColossus 2A. +برمجية AGC هذه سيُشار إليها هنا بالاسم Colossus 2A. -هذا البرنامج مخصص للاستخدام في المركبة القيادية كما هو محدد في التقرير `R-577`. تم إعداد هذا البرنامج في إطار مشروع DSR `55-23870` ، برعاية مركز المركبات الفضائية المأهول التابع للإدارة الوطنية للملاحة الجوية والفضاء من خلال عقد `NAS 9-4065` مع مختبر الأجهزة من معهد ماساتشوستس للتكنولوجيا، كامبريدج، ماساتشوستس. +هذا البرمجية مخصصة للاستخدام في مركبة القيادة كما هو موصوف في التقرير `R-577`. تم إعداد هذه البرمجية في إطار مشروع DSR `55-23870`، برعاية مركز المركبات الفضائية (Manned Spacecraft Center) التابع للإدارة الوطنية للملاحة الجوية و الفضاء (The National Aeronautics and Space Administration) بالعقد `NAS 9-4065` مع مختبر التجهيز (Instrumentation Laboratory) في معهد مستشوستس للتكنولوجيا (Massachusetts Institute of Technology) في كامبريدج بولاية مستشوستس من الولايات المتّحدة الأمريكية. قدمته | الوظيفة | التاريخ --------------------: | ---: | ---: -مارغريت ه. هاملتون | قائدة برمجة Colussus
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 +مارغريت ​ﮪ. هاملتون | قائدة برمجة Colussus
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 -وافق عليه | الوظيفة | التاريخ +أقرّه | الوظيفة | التاريخ -----------------: | ---: | ---: -دانيال ج. ليكلي | مدير تطوير برنامج المهمات
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 -فريد ه. مارتن | مدير مشروع Colussus
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 -نورمان إي. سيرز | مدير تطوير المهمات
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 -ريتشارد ه. باتن | مدير تطوير المهمات
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 -ديفيد ج. هوج | المدير
برنامج أبولو للإرشاد والتنقل | 28 آذار 1969 -رالف ر. راجان | نائب المدير
مختبر الأجهزة | 28 آذار 1969 +دانيال ج. ليكلي | مدير تطوير برامج المهمات
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 +فريد ​ﮪ. مارتن | مدير مشروع Colussus
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 +نورمان إي. سيرز | مدير تطوير المهمات
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 +ريتشارد ​ﮪ. باتن | مدير تطوير المهمات
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 +ديفيد ج. هوج | المدير
برنامج أبولو للتوجيه و الملاحة | 28 آذار 1969 +رالف ر. راجان | نائب المدير
مختبر التجهيز | 28 آذار 1969