هذه المساحة مخصّصة لمستخدمي Earth Engine الذين يريدون مشاركة معلوماتهم مع بقية منتدى Earth Engine. تم إنشاء البرامج التعليمية في هذا القسم من قِبل مستخدمي Earth Engine، وهي مخصّصة لهم، وتناسب جميع مستويات الخبرة، من المبتدئين إلى المستخدمين الأكثر خبرة.
يمكن إرسال البرامج التعليمية كنص عادي ورمز منسَّق باستخدام لغة الترميز Markdown، أو كدفاتر ملاحظات Colab تحتوي على Markdown ورمز Python قابل للتنفيذ. تتم كتابة البرامج التعليمية التي تم إنشاؤها باستخدام مكتبات برامج JavaScript الخاصة بـ Earth Engine بتنسيق Markdown بشكل عام، بينما يُنصح باستخدام Colab للبرامج التعليمية المستندة إلى مكتبات برامج Python الخاصة بـ Earth Engine.
قبل البدء
مدوّنة السلوك
يلتزم فريق Earth Engine بتعزيز بيئة مجتمعية شاملة وخالية من المضايقات. يُرجى الاطّلاع على مدوّنة السلوك قبل المساهمة.
الانضمام إلى GitHub
تتم مشاركة البرامج التعليمية الخاصة بمنتدى Earth Engine ومراجعتها من خلال GitHub. إذا لم يكن لديك حساب على GitHub، عليك أولاً إنشاء حساب من خلال https://github.com/join.
اقتراح برنامج تعليمي
قبل استثمار وقت وجهد كبيرَين في إنشاء برنامج تعليمي جديد، يُطلب من المساهمين المحتملين إرسال اقتراح بسيط يتضمّن بعض المعلومات الأساسية. يتيح ذلك للمؤلفين العمل مع المسؤولين عن صيانة مستندات المطوّرين في Earth Engine لتركيز الجهود على البرامج التعليمية التي تقدّم أكبر قيمة لمجتمع مستخدمي Earth Engine. ويوفّر أيضًا الوقت من خلال تجنُّب المراسلات المحتملة أثناء عملية المراجعة.
الإعداد لأول مرة
إذا كانت هذه هي المرة الأولى التي ترسل فيها برنامجًا تعليميًا إلى مستودع GitHub الخاص بمنتدى Earth Engine، احرص على إكمال هذه الخطوات قبل البدء في العمل على البرنامج التعليمي:
يجب قبول "اتفاقية ترخيص المساهمين" (CLA) على الرابط التالي:
https://cla.developers.google.com
قراءة دليل أسلوب البرامج التعليمية في "المنتدى" وفهمه
كتابة دليل تعليمي وإرساله
بعد أن يقبل المشرفون اقتراحك بشأن البرنامج التعليمي، تتوفّر عدة خيارات لتعديل البرنامج التعليمي وإرساله إلى مستودع Earth Engine المخصّص للمنتدى:
البدء السريع باستخدام Markdown
يمكنك إنشاء نسخة من مستودع GitHub وإنشاء برنامج تعليمي جديد مباشرةً من خلال موقع GitHub الإلكتروني للبدء بسرعة بدون أدوات أو إعدادات إضافية:
سجِّل الدخول إلى GitHub إذا لم يسبق لك إجراء ذلك.
لإنشاء ملف برنامج تعليمي جديد وتعديله، انقر على برنامج تعليمي جديد. سيُطلب منك إنشاء نسخة من المستودع، إذا لزم الأمر.
أدخِل اسمًا لملف البرنامج التعليمي الخاص بالنموذج:
your-tutorial-name/index.mdحيث يمثّل
your-tutorial-nameالاسم المختصر للبرنامج التعليمي بأحرف صغيرة. استخدِم الشُرط ("-") للفصل بين الكلمات. لا تستخدِم المسافات أو أي علامات ترقيم أخرى في اسم المجلد.عدِّل البرنامج التعليمي مباشرةً في أداة تعديل الملفات في GitHub، واستخدِم "معاينة" للتحقّق من الناتج المنسَّق (راجِع أيضًا تعديل الملفات في المستودع ضمن مستندات GitHub).
بعد الانتهاء، نفِّذ التغييرات وافتح طلب سحب.
ورقة ملاحظات Colab
انقر هنا لبدء كتابة دليل تعليمي في Colab:
سيؤدي ذلك إلى فتح دفتر ملاحظات يحتوي على تعليمات حول إنشاء البرنامج التعليمي وإرساله.
إعدادات متقدمة
إذا كنت معتادًا على استخدام GitHub وgit والأدوات ذات الصلة، ستكون العملية الإجمالية هي نفسها عند إرسال برامج تعليمية بتنسيق Markdown وColab:
أنشئ نسخة طبق الأصل من مستودع google/earthengine-community على GitHub واستنسخه.
أنشئ دليلاً ضمن
tutorialsيتضمّن الاسم المختصر المحوّل إلى عنوان URL سهل الاستخدام للبرنامج التعليمي (مثلاًtutorials/my-amazing-tutorial).أضِف العنوان المناسب لغة الترميز Markdown أو Colab.
نفِّذ عملية الإيداع في الدليل الجديد باستخدام اسم الملف
index.md(لغة Markdown) أوtutorial.ipynb(Colab). يجب حفظ الصور المستخدَمة في البرنامج التعليمي في الدليل نفسه.ادفع المحتوى الجديد إلى النسخة المتفرّعة وافتح طلب سحب.
عند إنشاء طلب سحب، احرص على الإشارة إلى الاقتراح الأصلي باستخدام رقم مشكلة GitHub في قسم التعليقات. على سبيل المثال، إذا كانت المشكلة هي 123#، عليك وضع النص "Closes #123" في وصف طلب السحب للإشارة إلى الاقتراح الأصلي، ولتحديد حالته تلقائيًا على أنّه تم تنفيذه بعد نشر البرنامج التعليمي.
بعد فتح طلب سحب، سيتم تعيين واحد أو أكثر من المسؤولين لمراجعة طلبك. سيتعاون المراجعون معك للتأكّد من أنّ طلبك كامل وصحيح ومتوافق مع دليل أسلوب البرامج التعليمية في "منتدى Earth Engine".
بعد الموافقة على طلب الدمج، سينشر المشرفون على المستودع التعليمي الخاص بك.