كيف ترفع كود مشروعك إلى GitHub من ChanTan Studio

احتفظ بنسخة من مشروعك في مستودع GitHub خاص بك: اربط حسابك مرة واحدة، ارفع بضغطة زر، وفعّل المزامنة التلقائية إن أردت. خطوة بخطوة.

GitHub مكان تحتفظ فيه بنسخة من ملفات مشروعك داخل حسابك أنت. وإذا لم تستخدمه من قبل فأنت لست مضطرًا إليه — النشر هو ما يضع موقع "دار زيتون" على الإنترنت. أما GitHub فلمن يريد نسخة خاصة من الكود بين يديه.

نقطتان تفهمهما قبل البدء:

• الاتجاه واحد. ChanTan يرسل ملفاتك إلى GitHub، ولا يسحب منه أبدًا.
• مستودعك خاص دائمًا. لا يراه أحد سواك.
• لا يوجد تنزيل بصيغة ZIP لكود المشروع اليوم. GitHub هو الطريق لإخراج الكود. (أما الإعدادات ← "الأمان" ← "تصدير البيانات" فتنزّل بيانات حسابك — ملفك الشخصي وقائمة مشاريعك وسجل رصيدك — لا كود تطبيقك.)

1. اربط حسابك على GitHub

افتح "الإعدادات" ← "التكاملات" واضغط "ربط".

ويمكنك البدء من داخل المشروع أيضًا: اضغط زر GitHub في شريط المشروع ← "رفع إلى GitHub" ← "ربط GitHub".

2. وافق من GitHub

يطلب منك GitHub الموافقة على الربط. وافق، فتعود مباشرة إلى النقطة التي انطلقت منها — كما تقول الواجهة: "ستوافق على GitHub ثم تعود إلى هنا مباشرة."

عند النجاح ترى "تم ربط GitHub" ويظهر @اسم-المستخدم الخاص بك في شارة خضراء. وإن فشل الأمر ستقرأ "تعذّر ربط GitHub. حاول مرة أخرى." — اضغط الزر من جديد.

3. افتح مشروعك واضغط "رفع إلى GitHub"

ادخل إلى المشروع الذي تريد حفظه، اضغط زر GitHub في الشريط، ثم "رفع إلى GitHub".

4. سمِّ المستودع وارفع

في المرة الأولى تختار "اسم المستودع" — وهو معبّأ مسبقًا من اسم مشروعك. وتحته مكتوب: "يُنشأ كمستودع خاص على @اسم-المستخدم — أنت وحدك من يراه."

اضغط "إنشاء المستودع والرفع".

✅ تم! عند الانتهاء يظهر زر "فتح على GitHub". اضغطه لترى ملفاتك مستقرة في مستودعك الخاص.

الرفع مرة أخرى لاحقًا

بعد الرفعة الأولى يتحول الزر إلى "رفع أحدث نسخة"، ويخبرك سطر فوقه بالحقيقة:

ولا يمكنك رفع المشروع نفسه مرتين خلال 30 ثانية — ستقرأ: "Just pushed — give it a few seconds and try again." (رفعتَ للتو — امهله ثوانٍ وحاول مجددًا.)

المزامنة التلقائية

بعد الرفعة الأولى يظهر خيار: "مزامنة GitHub تلقائيًا" — "يرفع تغييراتك خلال ~5 دقائق. عدة تعديلات تصبح إيداعًا واحدًا."

⚠️ "الملفات التي تعدّلها على GitHub تُستبدل في المزامنة التالية. أما التي تضيفها فتبقى." ChanTan هو المصدر الموثوق للملفات التي يديرها — فلا تجعل GitHub مكان تحريرك.

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

ما هو محمي

• المستودعات تُنشأ خاصة دائمًا.
• مفاتيح قاعدة بياناتك تُزال وتُستبدل بعناصر نائبة قبل إرسال أي شيء.
• وإذا تعذّر ضمان هذه الإزالة، لا يُرسل شيء إطلاقًا — وستقرأ: "We couldn't verify your database keys would be removed, so nothing was pushed. Try again in a moment." (تعذّر التأكد من إزالة مفاتيحك، فلم يُرفع شيء — حاول بعد لحظات.)
• ملفات الإعدادات التي تحتوي أسرارًا لا تُرسل أبدًا.

حدود صريحة

وبصراحة أيضًا: رسائل أخطاء GitHub تصل بالإنجليزية، حتى لو كانت بقية الواجهة بلغتك.

فصل الربط

الإعدادات ← "التكاملات" ← "فصل" ← ثم التأكيد بـ "نعم، افصل".

مستودعاتك لا تُحذف. "تُنشأ المستودعات خاصة. فصل الربط يزيل وصول Chantan — وتبقى مستودعاتك ملكك."

وإن رأيت بعدها الرسالة "تم الفصل هنا، لكن GitHub ما زال يعرض التطبيق"، فأكمل الإزالة من جهة GitHub: GitHub ← Settings ← Applications ← احذف "Chantan Studio".

تذكّر

GitHub نسخة احتياطية ووسيلة لتملك كودك. وهو ليس الطريقة التي يذهب بها تطبيقك إلى الإنترنت — تلك هي النشر، وتبقى الطريق الصحيحة لوضع موقعك أمام زوارك.