פרסום מאמרים ל-GitLab

חבר את GitLab פעם אחת ותוכל לפרסם כל מאמר ב-Clevera לפרויקט ב-GitLab כקובץ Markdown, מוכן לאתר תיעוד, docs/ תיקייה או מדריך פרויקט. מאמר זה מכסה את החיבור, בחירת הפרויקט והתיקייה, איך הקובץ נראה ואיך עדכונים עובדים.

לפני שמתחילים#

• תוכנית: פרסום ל-GitLab הוא חלק מהתוכניות Pro ו-Custom. בתוכניות Free ו-Starter, הלשונית פרסם מציגה "פרסום לכלים שלך כלול ב-Pro". ראה בחר תוכנית.
• תפקיד ב-Clevera: רק בעל סביבת העבודה או מנהל מערכת יכולים לחבר או לנתק את GitLab. ברגע שהוא מחובר, כל מי שיכול לערוך מאמר יכול לפרסם אותו.
• GitLab.com בלבד: Clevera מתחברת ל-GitLab.com. שרתי GitLab בניהול עצמי אינם נתמכים.
• תפקיד ב-GitLab: Clevera מציגה פרויקטים שבהם לחשבון המחובר יש תפקיד מפתח (Developer) ומעלה. כדי לבצע Commit לענף ברירת מחדל מוגן, החשבון בדרך כלל זקוק לתפקיד מתחזק (Maintainer) (ראה ענפים מוגנים).
• מאמר: אתה מפרסם את המאמר ששייך לסרטון או להקלטה. צור אותו תחילה; ראה הפוך הקלטה למאמר.

הפרסום אינו משתמש בקרדיטים.

חיבור GitLab#

1. פתח אינטגרציות#

   בסרגל הצד, פתח את תפריט סביבת העבודה ובחר אינטגרציות. מצא את GitLab תחת אינטגרציות זמינות (או לשונית פיתוח) ולחץ על חיבור.

2. היכנס ל-GitLab ואשר#

   היכנס ל-GitLab.com אם אינך מחובר כבר. GitLab מבקשת ממך לאשר ל-Clevera את ההרשאות הבאות:

   הרשאת GitLab	למה
   api	ממשק ה-API של הקבצים ב-GitLab זקוק לו כדי ליצור ולעדכן קבצים
   read_user	כדי להציג את שם המשתמש שלך ב-GitLab בתוך Clevera
   read_repository	כדי לבדוק אם קובץ כבר קיים
   write_repository	כדי לבצע Commit לקובץ ה-Markdown ולתמונות שלו

   לחץ על אשר.

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

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

פרסם מאמר#

1. פתח את לשונית הפרסום#

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

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

2. בחר את הפרויקט והתיקייה#

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

   שדה	מה לבחור	הערות
   מאגר	פרויקט ה-GitLab עבור הקובץ	פרויקטים שבהם אתה מפתח (Developer) ומעלה, מוצגים לפי עדכון אחרון. הראשון נבחר עבורך
   תיקייה	נתיב כגון docs או articles/guides	"קובץ ה-Markdown נוצר כאן. השאר ריק עבור שורש המאגר." מתחיל כ-docs. תיקיות שאינן קיימות עדיין ייווצרו

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

   

3. פרסם#

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

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

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

• ענף: ענף ברירת המחדל של הפרויקט (בדרך כלל main). Clevera מבצעת Commit ישירות אליו; היא לא פותחת בקשת מיזוג (Merge 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: חשבון ה-GitLab שחיבר את האינטגרציה.

ענפים מוגנים#

GitLab מגינה על ענף ברירת המחדל כברירת מחדל, ובדרך כלל רק מתחזקים (Maintainers) יכולים לבצע Push אליו. אם החשבון המחובר הוא מפתח (Developer), ה-Commit מסורב עם "GitLab סירבה ל-Commit: אתה זקוק להרשאת מפתח ומעלה, והענף לא יכול להיות מוגן." תן לחשבון ההוא תפקיד מתחזק, או אפשר למפתחים לבצע Push תחת הגדרות → מאגר → ענפים מוגנים בפרויקט.

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

Clevera כותבת Markdown ש-GitLab מרנדרת, עם בלוק front matter קצר בראש הדף:

---
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 שפג תוקפו לאחר זמן מה; פרסם שוב כדי לחדש אותו.

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

אם GitLab Pages או מחולל אתרים סטטיים אחר (כגון MkDocs, Docusaurus או Hugo) בונה את התיעוד שלך מהפרויקט, כוון את תיקייה לתיקייה שהוא קורא ממנה. כל פרסום הוא Commit רגיל, כך שה-Pipeline שלך רץ כרגיל. רוב המחוללים קוראים title מה-front matter ומתעלמים משדות שהם לא מכירים.

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

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

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

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

נתק את GitLab#

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

ניתוק מוחק את האסימונים (Tokens) של Clevera. כדי לבטל את הגישה של Clevera גם ב-GitLab, פתח את תפריט האווטאר שלך ב-GitLab → ערוך פרופיל → יישומים, מצא את Clevera תחת יישומים מורשים ולחץ על ביטול.

פתרון בעיות#

קשור#