نشر المقالات إلى Bitbucket

اربط Bitbucket مرة واحدة ويمكنك نشر أي مقال من Clevera إلى مستودع Bitbucket كملف Markdown، جاهز لموقع مستندات أو docs/ مجلد بجوار الكود الخاص بك. يتناول هذا المقال الربط، واختيار المستودع والمجلد، وشكل الملف، وكيفية عمل التحديثات.

قبل البدء#

• الخطة: النشر إلى Bitbucket جزء من خطتي Pro و Custom. في خطتي Free و Starter، تظهر علامة التبويب نشر عبارة "النشر إلى أدواتك مشمول في خطة Pro". راجع اختيار خطة.
• الدور في Clevera: يمكن لمالك مساحة العمل أو المسؤول فقط ربط أو قطع اتصال Bitbucket. بمجرد اتصاله، يمكن لأي شخص لديه صلاحية تعديل المقال نشره.
• Bitbucket Cloud فقط: تتصل Clevera بـ bitbucket.org. لا يتم دعم Bitbucket Data Center و Server.
• الوصول في Bitbucket: يجب أن يكون للحساب الذي يقوم بالربط القدرة على المساهمة في المستودعات التي تريد النشر إليها، مع صلاحية الكتابة إلى الفرع الرئيسي.
• مقال: أنت تنشر المقال الذي ينتمي إلى فيديو أو تسجيل. قم بإنشائه أولاً؛ راجع تحويل تسجيل إلى مقال.

لا يستهلك النشر أي رصيد.

ربط Bitbucket#

1. فتح عمليات التكامل#

   في الشريط الجانبي، افتح قائمة مساحة العمل واختر عمليات التكامل. ابحث عن Bitbucket ضمن عمليات التكامل المتاحة (أو علامة التبويب التطوير) وانقر على ربط.

2. منح الوصول في Bitbucket#

   سجّل الدخول إلى Bitbucket إذا لم تكن قد فعلت ذلك بالفعل. سيطلب منك Bitbucket منح Clevera حق الوصول:

   إذن Bitbucket	السبب
   الحساب: قراءة	لعرض اسم Bitbucket الخاص بك في Clevera
   المستودعات: قراءة	لسرد المستودعات والتحقق مما إذا كان الملف موجوداً بالفعل
   المستودعات: كتابة	لرفع ملف Markdown وصوره

   انقر على منح الوصول.

3. التحقق من الاتصال#

   ستعود إلى عمليات التكامل مع عبارة "تم ربط Bitbucket بنجاح بـ" متبوعة باسم Bitbucket الخاص بك. ينتقل Bitbucket إلى قائمة متصل مع شارة متصل. قبل نشر أي شيء، ستظهر عبارة "لم يتم نشر أي شيء بعد".

نشر مقال#

1. فتح علامة التبويب نشر#

   في المحرر، انقر على مشاركة وافتح علامة التبويب نشر. ضمن انشر المقال، انقر على مربع Bitbucket تحت جاهز للنشر.

   يتم نشر المقال باللغة التي فتحتها في المحرر. قم بتبديل اللغة في الشريط العلوي أولاً لنشر ترجمة.

2. اختيار المستودع والمجلد#

   ضمن أين يذهب، اختر:

   الحقل	ما الذي يجب اختياره	ملاحظات
   مستودع	مستودع Bitbucket للملف	المستودعات التي يمكنك المساهمة فيها، عبر مساحات عمل Bitbucket الخاصة بك، مرتبة حسب الأحدث. يتم اختيار الأول لك تلقائياً
   مجلد	مسار مثل docs أو articles/guides	"يتم إنشاء ملف Markdown هنا. اتركه فارغاً لجذر المستودع." يبدأ كـ docs. سيتم إنشاء المجلدات غير الموجودة بعد

   تحتفظ Clevera بما اخترته للمرة القادمة.

   

3. نشر#

   انقر على نشر إلى Bitbucket. سترى "جاري البحث عن نسخة موجودة في Bitbucket"، ثم جاري كتابة الصفحة. عند الانتهاء، سترى "تم النشر إلى Bitbucket." انقر على فتح في Bitbucket لرؤية الملف.

   يمكنك إغلاق نافذة المشاركة أثناء العملية؛ سيصلك إشعار عند اكتمالها.

أين يذهب الملف#

• الفرع: الفرع الرئيسي للمستودع (عادة main أو master). تلتزم Clevera بالرفع مباشرة إليه؛ فهي لا تفتح طلب سحب ولا يمكنك اختيار فرع آخر.
• اسم الملف: العنوان بأحرف صغيرة، مع تحويل المسافات إلى واصلات، وينتهي بـ .md. "Create your first invoice" تصبح create-your-first-invoice.md. العناوين بلغات أخرى أو التي تحتوي على علامات تشكيل تُكتب بحروف لاتينية أولاً ("Créer une facture" تصبح creer-une-facture.md). العنوان الذي لا يتبقى منه شيء للكتابة، مثل العنوان المكون من رموز تعبيرية فقط، يحصل على كود قصير ثابت بدلاً من ذلك (article- زائد 8 أحرف). يتم قص الأسماء عند 80 حرفاً.
• الصور: تذهب لقطات شاشة المقال إلى assets/<file name>/ داخل نفس المجلد، في نفس الالتزام.
• رسالة الالتزام: Add article: <title>، أو Update article: <title> عند تحديث ملف موجود.
• مؤلف الالتزام: حساب Bitbucket الذي قام بربط التكامل.

قيود الفرع#

إذا كان للمستودع قيد على فرعه الرئيسي (على سبيل المثال، التغييرات تتم فقط عبر طلبات السحب، أو الكتابة مقصورة على أشخاص معينين)، فسيتم رفض التزام Clevera، على سبيل المثال برسالة "تحتاج إلى صلاحية الكتابة للالتزام في مستودع Bitbucket هذا." أضف الحساب المرتبط إلى الأشخاص الذين يمكنهم الكتابة إلى الفرع ضمن إعدادات المستودع ← قيود الفرع، أو انشر إلى مستودع لا يحتوي على تلك القاعدة.

كيف يبدو الملف#

تكتب Clevera ملف Markdown بسيطاً يمكن لعرض الملفات في Bitbucket إظهاره، مع كتلة بيانات وصفية قصيرة في الأعلى. لا يحتوي على HTML خام، لأن Bitbucket لا يعرضه.

---
title: "Create your first invoice"
created_at: "2026-10-12T09:30:00+00:00"
updated_at: "2026-10-12T10:05:00+00:00"
source: "Clevera"
---

الفيديو الذي جاء منه المقال لا يُضاف إلى الملف. الفيديو من Clevera الموضوع داخل المقال يصبح رابطاً لمشغله، فقط عندما يكون رابط مشاركة ذلك الفيديو مفعلاً. راجع عرض فيديو في مقال.

الصور#

يتم الالتزام بلقطات الشاشة في مستودعك بجوار الملف، وترتبط بها Markdown عبر مسار نسبي (assets/<file name>/…). تستمر في العمل بدون Clevera، وفي المستودع الخاص تظل خاصة مثل بقية محتوياته.

ملف الفيديو الذي حملته إلى المقال لا يتم الالتزام به. يظل رابطاً إلى Clevera تنتهي صلاحيته بعد فترة؛ انشر مرة أخرى لتجديده.

استخدامه مع موقع مستندات#

إذا كان مولد المواقع الثابتة (مثل MkDocs أو Docusaurus أو Hugo) يبني مستنداتك من المستودع، وجه مجلد إلى المجلد الذي يقرأ منه. كل عملية نشر هي التزام عادي، لذا تعمل Bitbucket Pipelines أو عمليات البناء الأخرى كالمعتاد. تقرأ معظم المولدات title من البيانات الوصفية وتتجاهل الحقول التي لا تعرفها.

تحديث مقال نشرته بالفعل#

النشر يسير في اتجاه واحد فقط. التعديلات التي تجريها في Clevera تظل في Clevera حتى تنشر مرة أخرى، والتغييرات التي تتم على الملف في Bitbucket لا تعود أبداً إلى Clevera.

عند النشر إلى نفس المستودع والمجلد، تعثر Clevera على الملف الذي يحمل نفس الاسم وتظهر "هذا المقال موجود بالفعل في Bitbucket." انقر على عرضه لفتح الملف الموجود، ثم اختر:

إذا تغير العنوان في Clevera، يتغير اسم الملف أيضاً، لذا فإن النشر ينشئ ملفاً جديداً بجوار القديم. احذف أو أعد تسمية الملف القديم في Bitbucket بنفسك. لا شيء في Clevera يحذف الملفات من مستودعك.

قطع اتصال Bitbucket#

1. افتح عمليات التكامل، انقر على قائمة ⋯ في صف Bitbucket واختر قطع الاتصال (أو انقر على Bitbucket ثم قطع الاتصال).
2. أكد العملية. "لا يمكنك النشر إليه من المحرر بعد الآن. المحتوى الذي نشرته بالفعل يظل في Bitbucket."

قطع الاتصال يحذف رموز Clevera. لإلغاء وصول Clevera على Bitbucket أيضاً، افتح الإعدادات الشخصية في Bitbucket، وانتقل إلى تراخيص التطبيقات وألغِ Clevera.

استكشاف الأخطاء وإصلاحها#

ذات صلة#