ربط GitHub بـ Notion

تنشئ مزامنة GitHub المُدارة قاعدة بيانات طلبات سحب GitHub من المستودعات التي تختارها. يستورد Notion طلبات السحب الحالية ويتحقق من وجود تحديثات في GitHub في الخلفية.

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

يمكنك مزامنة طلبات السحب من مستودعات متعددة متاحة من خلال تثبيت تطبيق 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. اختر كل السجل المتاح أو نافذة سجل محددة.

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

ينشئ Notion GitHub Pull Requests في قسم الشريط الجانبي Private الخاص بك ويبدأ في استيراد طلبات السحب المطابقة.

أثناء الاستيراد الأول، يقرأ 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 →