ربط GitHub

في مستند المساعدة هذا

قم بربط Notion و GitHub حتى تتمكن من الحفاظ على مزامنة سير عملك 🧮

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

إعداد عملية ربط GitHub

Note: You can only connect one Notion workspace to a GitHub organization. If you’d like to connect a different Notion workspace to your GitHub organization, you’ll first have to disconnect your current Notion workspace.

ستحتاج إلى أن تكون مالكاً لمساحة عمل Notion ومسؤولاً في مؤسسة GitHub لربط Notion بتطبيق مساحة عمل GitHub.

  1. انتقل إلى الإعدادات في الشريط الجانبي → عمليات ربط.

  2. ابحث عن GitHub (مساحة العمل).

  3. انقر على ربط وتابع إجراءات المصادقة.

إنشاء معاينات كود GitHub

قم بالربط بملف أو أسطر محددة من ملف مباشرة في Notion. يمكنك حتى الربط من التزام (commit) أو فرع (branch) محدد إذا كنت تريد أن يكون الكود الذي تشير إليه محدثاً.

  1. انسخ الرابط الدائم للأسطر التي تريدها من GitHub.

  2. الصقه في صفحة Notion واختر لصق كمعاينة لتضمين الكود في صفحتك.

إنشاء قاعدة بيانات متزامنة

يمكنك مزامنة مستودعات GitHub الخاصة بك (بما في ذلك طلبات السحب والمشكلات) في Notion كقواعد بيانات. للقيام بذلك:

  1. في GitHub، انسخ الرابط الخاص بطلب سحب (PR) أو مشكلة.

  2. الصق الرابط في Notion واختر لصق كقاعدة بيانات.

    • إذا لم تقم بذلك بالفعل، فسيُطلب منك تسجيل الدخول وربط Notion بحسابك على GitHub.

  3. سيتم إنشاء قاعدة البيانات المتزامنة في عرض جدول، مع إضافة جميع خصائص GitHub تلقائياً.

  4. ستبدأ قاعدة البيانات في التعبئة تلقائياً وستستمر في المزامنة إذا انتقلت بعيداً عن الصفحة.

خصائص GitHub المدعومة

فيما يلي قائمة بخصائص GitHub التي ندعمها:

العنوان

المُسند إليهم

الوصف

الولاية

رقم طلب السحب (PR) أو المشكلة

المُنشئ

وقت الإنشاء

وقت الدمج والتحديث والإغلاق

المراجعون

التسميات والعلامات غير مدعومة في هذا الوقت.

خصائص الأشخاص

يمكنك استخدام تعيين الهوية لربط هويات GitHub بملفات تعريف Notion الخاصة بفريقك. للقيام بذلك:

  1. انتقل إلى إعدادات البريد الإلكتروني في GitHub وتأكد من أن إعداد إبقاء عناوين بريدي الإلكتروني خاصةغير محدد.

  2. في ملف تعريف GitHub الخاص بك (https://github.com/{YOUR_USERNAME_HERE})، قم بتحرير ملف تعريفك لإضافة عنوان بريد Notion الإلكتروني الخاص بك.

هذا يُمكِّن هويتك من أن يتم تعيينها لقواعد البيانات المُزامنة في مساحات العمل التي أنت عضو فيها.

ربط طلبات سحب GitHub بـ Notion

To link PRs from GitHub to a Notion, you'll need a prefixed unique ID property in your database.

Learn more about unique IDs here!

ستُبقي خاصية طلب سحب GitHub داخل قاعدة بيانات Notion فرق عملك متعددة الوظائف على اطلاع دائم بحالات المهام تلقائيًا. كما أنها تحتوي على العديد من السمات التي يمكنك استخدامها في التجميعات (rollups)، والمعادلات، وعوامل التصفية.

  1. في قاعدة بيانات Notion، انقر على + لإضافة خاصية جديدة.

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

    • إذا لم تظهر لك قائمة خصائص طلبات سحب GitHub، فانتقل إلى الإعدادات ← المزيد من الإعدادات ← عمليات ربط ← أضف طلب سحب GitHub.

  3. تأكد من أن قاعدة بياناتك تحتوي على خاصية مُعرِّف فريد. ستتم إضافة هذه الخاصية إلى قاعدة بياناتك إذا لم تكن تحتوي على واحدة بالفعل.

  4. لاستخدام خاصية طلب سحب GitHub، تأكد من ربط حساب GitHub الخاص بك بـ Notion. بعد ذلك، إما أن تضيف المُعرِّف الفريد لمهمة Notion إلى طلب السحب، أو تلصق رابط URL الخاص بطلب سحب GitHub في الخاصية.

بشكل افتراضي، تُمكِّن Notion الروابط الخلفية (backlinks) على مهام Notion إلى GitHub. إذا كنت ترغب في إيقاف هذا، فانقر على خاصية طلب سحب GitHub في قاعدة بياناتك ← تحرير الخاصية. أوقف تشغيل الروابط الخلفية في GitHub.

أتمتة تحديثات حالة المهام

يمكنك استخدام خاصية طلبات سحب GitHub لتحديث حالة مهامك في Notion تلقائيًا.

  1. حدد عنوان خاصية طلبات سحب GitHub الخاصة بك وانقر على تحرير الخاصية.

  2. ابحث عن قسم التحديث التلقائي وحدد خاصية الحالة التي تريد تحديثها من القائمة المنسدلة.

  3. حدد حالة المهمة التي سيتم تعيينها عند فتح طلب سحب GitHub، أو طلب مراجعته، أو الموافقة عليه، أو دمجه.

  4. الآن، عندما يتقدم طلب السحب في GitHub، سيتم تحديث حالة مهمتك في Notion تلقائياً بناءً على إعداداتك.

يمكنك أيضاً عرض نشاط GitHub في مهمة Notion المرتبطة. للقيام بذلك، انقر فوق خاصية GitHub في قاعدة بياناتك ← تحرير الخاصية. قم بتشغيل تعليقات النشاط.

GitHub Auto-update status

استخدم الكلمات السحرية لربط طلبات سحب GitHub بمهام Notion

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

الكلمات السحرية هي كلمات رئيسية تساعد في إنشاء علاقات بين مهام Notion وطلبات سحب GitHub. يمكنك استخدام أي من الكلمات التالية:

  • close, closes, closed

  • fix, fixes, fixed

  • resolve, resolves, resolved

  • complete, completes, completed, completing

  • ref, references

  • part of

  • ذات صلة بـ

  • contributes to

  • towards

على سبيل المثال، يمكن أن يحتوي وصف طلب السحب (PR) الخاص بك على "fixes CTT-13". بمجرد تعيين هذا الوصف، سيتم ربط مهمة Notion الخاصة بك التي تحمل المعرف CTT-13 بطلب السحب هذا.

إذا كان وصف طلب السحب الخاص بك يستخدم كلمات سحرية مرتبطة بإغلاق مهمة أو إنهائها، فسيتم وضع علامة "تم" على مهمة Notion عند دمج طلب السحب.

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

يمكنك ربط مهام Notion كمرجع فقط، بحيث لا يتم وضع علامة "تم" على تلك المهام.

إلغاء ربط GitHub بـ Notion

لإلغاء ربط GitHub بـ Notion، يجب أن تكون مالكاً لمساحة عمل Notion.

  1. انتقل إلى الإعدادات.

  2. حدد عمليات ربط.

  3. بجانب GitHub، حدد ••• → إلغاء ربط جميع المستخدمين.

عند إلغاء ربط GitHub بـ Notion، لن يتمكن أي شخص في مساحة عملك من استخدام عملية الربط حتى يتم إعداده مرة أخرى.

تقديم تعليق

هل كان هذا المورد مفيداً؟

Powered by Fruition