פרסום מאמרים ל-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
   מאגרים: קריאה	כדי להציג רשימת מאגרים ולבדוק אם קובץ כבר קיים
   מאגרים: כתיבה	כדי לבצע commit לקובץ ה-Markdown ולתמונות שלו

   לחץ על הענק גישה.

3. בדוק את החיבור#

   תחזור ל-אינטגרציות עם הכיתוב "Bitbucket מחובר בהצלחה ל-" ואחריו שם ה-Bitbucket שלך. Bitbucket יעבור לרשימת ה-מחובר עם תג מחובר. לפני שתפרסם משהו, יופיע הכיתוב "טרם פורסם דבר".

פרסם מאמר#

1. פתח את כרטיסיית הפרסום#

   בעורך, לחץ על שיתוף ופתח את כרטיסיית פרסם. תחת פרסם את המאמר, לחץ על האריח Bitbucket תחת מוכן לפרסום.

   המאמר מתפרסם בשפה הפתוחה בעורך. החלף שפה בסרגל העליון תחילה כדי לפרסם תרגום.

2. בחר את המאגר והתיקייה#

   תחת לאן זה הולך, בחר:

   שדה	מה לבחור	הערות
   מאגר	מאגר ה-Bitbucket עבור הקובץ	מאגרים שאתה יכול לתרום להם, ברחבי סביבות העבודה שלך ב-Bitbucket, מהמעודכן ביותר לראשון. הראשון נבחר עבורך
   תיקייה	נתיב כגון docs או articles/guides	"קובץ ה-Markdown נוצר כאן. השאר ריק עבור שורש המאגר." מתחיל כ-docs. תיקיות שעדיין לא קיימות ייווצרו

   Clevera זוכרת מה בחרת לפעם הבאה.

   

3. פרסם#

   לחץ על פרסם ל-Bitbucket. תראה "מחפש עותק קיים ב-Bitbucket", ולאחר מכן כותב את הדף. כשתסיים, תראה "פורסם ל-Bitbucket." לחץ על פתח ב-Bitbucket כדי לראות את הקובץ.

   אתה יכול לסגור את חלון השיתוף בזמן שזה רץ; התראה תודיע לך כשהפעולה תסתיים.

לאן הקובץ הולך#

• ענף: הענף הראשי של המאגר (בדרך כלל main או master). Clevera מבצעת commit ישירות אליו; היא לא פותחת בקשת מיזוג (pull request) ולא ניתן לבחור ענף אחר.
• שם קובץ: ה-כותרת באותיות קטנות, עם רווחים שהופכים למקפים, ומסתיים ב-.md. "Create your first invoice" הופך ל-create-your-first-invoice.md. כותרות בכתבים אחרים או עם סימני הטעמה נכתבות תחילה באותיות לטיניות ("Créer une facture" הופך ל-creer-une-facture.md). כותרת שאין בה מה לכתוב, כגון כזו המורכבת רק מאימוג'י, מקבלת קוד קבוע קצר במקום (article- פלוס 8 תווים). שמות נחתכים ב-80 תווים.
• תמונות: צילומי המסך של המאמר נכנסים ל-assets/<file name>/ בתוך אותה תיקייה, באותו commit.
• הודעת commit: Add article: <title>, או Update article: <title> כשאתה מעדכן קובץ קיים.
• כותב ה-commit: חשבון ה-Bitbucket שחיבר את האינטגרציה.

הגבלות ענף#

אם למאגר יש הגבלת ענף על הענף הראשי שלו (למשל, שינויים רק דרך בקשות מיזוג, או כתיבה מוגבלת לאנשים מסוימים), ה-commit של Clevera יסורב, למשל עם "You need write access to commit to this Bitbucket repository." הוסף את החשבון המחובר לאנשים שיכולים לכתוב לענף תחת הגדרות מאגר → הגבלות ענף, או פרסם למאגר ללא כלל זה.

איך נראה הקובץ#

Clevera כותבת Markdown פשוט שתצוגת הקבצים של Bitbucket יכולה להציג, עם בלוק front matter קצר למעלה. הוא אינו מכיל 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 שהושם בתוך המאמר הופך לקישור לנגן שלו, רק כאשר קישור השיתוף של אותו סרטון פעיל. ראה הצג סרטון במאמר.

תמונות#

צילומי מסך עוברים commit למאגר שלך לצד הקובץ, וקישורי ה-Markdown מפנים אליהם בנתיב יחסי (assets/<file name>/…). הם ממשיכים לעבוד ללא Clevera, ובמאגר פרטי הם נשארים פרטיים כמו שאר המאגר.

קובץ וידאו שהעלית למאמר לא עובר commit. הוא נשאר קישור ל-Clevera שפג תוקפו לאחר זמן מה; פרסם שוב כדי לחדש אותו.

השתמש בו עם אתר תיעוד#

אם מחולל אתרים סטטיים (כגון MkDocs, Docusaurus או Hugo) בונה את התיעוד שלך מהמאגר, כוון את תיקייה לתיקייה שהוא קורא ממנה. כל פרסום הוא commit רגיל, כך ש-Bitbucket Pipelines או הרצות הבנייה האחרות שלך פועלות כרגיל. רוב המחוללים קוראים title מה-front matter ומתעלמים משדות שהם לא מכירים.

עדכן מאמר שכבר פרסמת#

הפרסום הוא חד-כיווני. עריכות שאתה מבצע ב-Clevera נשארות ב-Clevera עד שתפרסם שוב, ושינויים שבוצעו לקובץ ב-Bitbucket לעולם לא חוזרים ל-Clevera.

כשאתה מפרסם לאותו מאגר ואותה תיקייה, Clevera מוצאת את הקובץ עם אותו שם ומציגה "מאמר זה כבר נמצא ב-Bitbucket." לחץ על צפה בו כדי לפתוח את הקובץ הקיים, ואז בחר:

אם הכותרת השתנתה ב-Clevera, שם הקובץ משתנה גם הוא, כך שהפרסום יוצר קובץ חדש לצד הישן. מחק או שנה את שם הקובץ הישן ב-Bitbucket בעצמך. שום דבר ב-Clevera לא מוחק קבצים מהמאגר שלך.

נתק את Bitbucket#

1. פתח את אינטגרציות, לחץ על תפריט ה-⋯ בשורת Bitbucket ובחר ב-נתק (או לחץ על Bitbucket ואז על נתק).
2. אשר. "לא תוכל עוד לפרסם אליו מהעורך. תוכן שכבר פרסמת נשאר ב-Bitbucket."

ניתוק מוחק את האסימונים של Clevera. כדי לבטל את הגישה של Clevera גם ב-Bitbucket, פתח את הגדרות אישיות ב-Bitbucket, עבור ל-הרשאות אפליקציות ובטל את Clevera.

פתרון בעיות#

קשור#