ربط GitHub بـ Notion

تجلب مزامنة GitHub المُدارة عمل GitHub الذي تختاره إلى Notion: طلبات السحب، أو المشكلات، أو كليهما. يستورد Notion سجلاتك الحالية ويتحقق من وجود تحديثات في GitHub في الخلفية.

يغطي هذا الدليل مزامنة قاعدة البيانات في إعدادات ربط GitHub الخاصة بك. الخصائص المتزامنة للقراءة فقط. قم بإجراء تغييرات على طلبات السحب والمشكلات في GitHub.

اختر ما تريد جلبه إلى Notion من المستودعات المتاحة من خلال تثبيت تطبيق GitHub: طلبات السحب، أو المشكلات، أو كليهما. المستودعات التي تختارها تُدرج في Notion.

تحتوي خاصية المؤلف (GitHub) على اسم مستخدم GitHub. المؤلف هي خاصية شخص في Notion عندما يطابق البريد الإلكتروني العام المتاح للمؤلف أحد أعضاء مساحة العمل.

تقوم خاصية الوصف بمزامنة وصف طلب السحب كنص عادي، يتم نسخه تماماً كما هو مكتوب في GitHub. ولا يتم عرضه بتنسيق Markdown.

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

ستحتاج إلى:

• عضوية في مساحة عمل Notion.

• حساب GitHub مع إمكانية الوصول إلى المستودعات التي تريد مزامنتها.

• تثبيت تطبيق GitHub مع إمكانية الوصول إلى تلك المستودعات.

• خطة الأعمال (تعتبر خطة Mobile Business مؤهلة أيضاً). مزامنة GitHub غير متاحة في الخطط الأخرى.

يتطلب كل من حساب GitHub الخاص بك وتثبيت التطبيق صلاحية الوصول. قد تتطلب مؤسسة GitHub الخاصة بك موافقة المالك أو تثبيته للتطبيق.

1. في Notion، انتقل إلى Settings → عمليات ربط → GitHub.

2. افتح مزامنة قاعدة البيانات وقم بربط حساب GitHub الخاص بك إذا لم تقم بذلك بالفعل.

3. أكمل خطوات التفويض والتثبيت الخاصة بـ GitHub.

4. اختر المؤسسة أو الحساب الذي تريد مزامنة مستودعاته. استخدم Add organization… إذا كنت بحاجة إلى إضافة تثبيت آخر.

5. حدد المستودعات المراد تضمينها.

6. قم بتسمية مزامنتك واختر ما تريد جلبه إلى Notion: طلبات السحب، أو المشكلات، أو كليهما.

7. اختر كل السجل المتاح أو نافذة سجل محددة.

8. حدد إنشاء مزامنة.

ينشئ Notion قاعدة البيانات المتزامنة في قسم الشريط الجانبي الخاص بك ويبدأ في استيراد السجلات المطابقة.

أثناء الاستيراد الأول، يقرأ Notion طلبات السحب والمشكلات التي اخترتها من كل مستودع محدد، بدءاً من السجلات التي تم تحديثها مؤخراً وصولاً إلى السجل المحدد.

بعد الاستيراد، يتحقق Notion بانتظام من كل مستودع بحثاً عن سجلات جديدة ومحدثة. تؤدي التغييرات مثل إضافة تصنيف جديد، أو إغلاق طلب سحب، أو إعادة فتح مشكلة إلى تحديث الخصائص المطابقة في Notion.

تستمر المزامنة في العمل حتى عند إغلاق Notion. قد تؤدي المستودعات الكبيرة، وحدود طلبات GitHub، ومشكلات الخدمة المؤقتة إلى تأخير التحديثات. تحقق من حالة المزامنة لمعرفة التقدم أو الأخطاء.

اختر All history، أو Last 30 days، أو Last 90 days، أو Last 365 days. عندما يتم توفير مزامنة كل السجل على شكل قائمة قابلة للطي، اترك Sync all available history مفعلاً لتضمين جميع طلبات السحب المتاحة.

تستخدم النافذة وقت Updated At الخاص بطلب السحب. ولا يعتمد ذلك على وقت إنشاء طلب السحب أو ما إذا كان مفتوحاً أو مغلقاً أو مدمجاً.

على سبيل المثال، يمكن أن يقع طلب سحب أو مشكلة مفتوحة لم تتغير منذ أكثر من 90 يوماً خارج نافذة الـ 90 يوماً.

افتح المزامنة في Settings → عمليات ربط → GitHub → مزامنة قاعدة البيانات.

• إضافة أو إزالة المشكلات أو طلبات السحب: قم بتغيير ما تجلبه المزامنة وحدد حفظ التغييرات. تؤدي إضافة نوع إلى استيراد سجلاته المطابقة. وتؤدي إزالة نوع إلى إزالة تلك الصفحات. تظل السجلات التي استوردتها بالفعل للأنواع التي تحتفظ بها في مكانها.

• Add repositories: قم بتعديل التحديد واختر Save changes. سيقوم Notion باستيراد طلبات السحب المطابقة من المستودعات المضافة.

• Remove repositories: قم بإلغاء تحديدها واحفظ التغييرات. ستتم إزالة صفحات طلبات السحب التي تمت مزامنتها من Notion.

• سجل التغييرات: تؤدي النافذة الأطول إلى استيراد سجلات إضافية. بينما تؤدي النافذة الأقصر إلى إزالة السجلات الموجودة خارج النطاق الزمني الجديد.

• إيقاف التحديثات مؤقتاً: حدد إيقاف المزامنة مؤقتاً. تظل البيانات والإعدادات الحالية كما هي.

• استئناف التحديثات: حدد استئناف المزامنة لمتابعة المزامنة.

قبل إزالة المستودعات أو تقصير السجل، احتفظ بأي معلومات خاصة بـ Notion تحتاجها من الصفحات المتأثرة.

أنشئ طرق عرض حسب المستودع، أو الحالة، أو المؤلف، أو التصنيف. أضف خصائصك الخاصة لتتبع جاهزية الإصدار أو ربط طلبات السحب والمشكلات بعملية التخطيط الخاصة بفريقك. تظل قيم خصائصك الخاصة في Notion.

لتغيير خاصية GitHub، افتح السجل باستخدام رابط GitHub وقم بإجراء التغيير في GitHub.

تبدأ قاعدة البيانات كخاصة. إذا قمت بمشاركتها، فإن إعدادات المشاركة في Notion تحدد من يمكنه رؤية البيانات المستوردة. لا يحتاج المشاهدون جميعاً إلى الوصول إلى المستودع المصدر، لذا راجع أذونات قاعدة البيانات قبل مشاركة معلومات المستودع الخاص.

تحقق من اختيارك لحساب GitHub وتثبيت التطبيق الصحيحين. تأكد من أن كلاً من حسابك والتطبيق لديهما صلاحية الوصول إلى المستودع. إذا كانت المؤسسة تقيد تثبيتات التطبيقات، فاطلب من المالك الموافقة على الوصول.

افتح إعدادات مستودع المزامنة، وراجع اختيار المستودع، ثم احفظه مرة أخرى. إذا تم نقله إلى مؤسسة مختلفة، فتأكد من أن الربط لديه صلاحية الوصول في الموقع الجديد.

لا يحتوي اسم مستخدم GitHub دائماً على بريد إلكتروني عام متاح يطابق عضوًا في مساحة العمل في Notion. استخدم المؤلف (GitHub) لتحديد المؤلف عندما تكون خاصية الشخص فارغة. قد لا يتم تحديث التغييرات التي تطرأ على البريد الإلكتروني للمؤلف أو عضويته في مساحة العمل في طلبات السحب التي تمت مزامنتها مسبقاً تلقائياً.

تأكد من تضمين نوعه في المزامنة، ومن تحديد المستودع الخاص به، وأن آخر تحديث له يقع ضمن نافذة السجل، وأن عرض Notion الخاص بك لا يقوم باستبعاده. قد يكون الاستيراد الأول لا يزال قيد التشغيل.

افتح تفاصيل حالة المزامنة. أعد توصيل حساب GitHub الخاص بك أو استعد صلاحية الوصول إلى المستودع إذا طُلب منك ذلك. يمكن أن تؤدي حدود طلبات GitHub والانقطاعات المؤقتة إلى تأخير التحديثات بينما تعيد Notion المحاولة.

للمقارنة مع Workers والحصول على إرشادات استكشاف الأخطاء وإصلاحها المشتركة، راجع مزامنة البيانات من أدوات أخرى إلى Notion →