ربط 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 →