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

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

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

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

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

חיבור GitHub#

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

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

   

2. אשר את Clevera ב-GitHub#

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

3. התקן את האפליקציה במאגרים שלך#

   לאחר מכן GitHub פותח את דף התקנת האפליקציה Clevera AI. בחר את החשבון האישי שלך או ארגון, ולאחר מכן בחר All repositories או Only select repositories. האפליקציה מבקשת:

   הרשאת GitHub	למה
   Contents: read and write	כדי ליצור ולעדכן את קובץ ה-Markdown והתמונות שלו
   Metadata: read-only	נדרש על ידי GitHub עבור כל אפליקציה; מאפשר ל-Clevera להציג מאגרים

   לחץ על Install. חזור על הפעולה עבור כל ארגון שאליו ברצונך לפרסם.

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

   בחזרה ב-אינטגרציות, GitHub עובר לרשימת מחובר עם שם חשבון ה-GitHub או הארגון שלך ותג מחובר. לפני שתפרסם משהו, יופיע הכיתוב "Nothing published yet".

   

הוסף או הסר מאגרים מאוחר יותר#

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

פרסם מאמר#

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

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

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

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

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

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

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

   

3. פרסם#

   לחץ על פרסם ל-GitHub. תראה "Looking for an existing copy in GitHub", ואז Writing the page. כשהפעולה תסתיים תראה "Published to GitHub." לחץ על Open in GitHub כדי לראות את הקובץ.

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

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

• ענף: ענף ברירת המחדל של המאגר (בדרך כלל main). 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: חשבון ה-GitHub שחיבר את האינטגרציה.

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

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

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

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

1. כוון את ה-תיקייה לתיקייה שאתר התיעוד שלך קורא ממנה, למשל docs או content/guides.
2. פרסם כל מאמר שם; תהליך הבנייה הרגיל של האתר שלך יקלוט את ה-commit החדש.
3. בדוק אם המחולל שלך מרנדר התראות GitHub, מתמטיקה ו-<details>; חלקם מציגים התראות כציטוטים רגילים.

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

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

כשאתה מפרסם לאותו מאגר ואותה תיקייה, Clevera מוצאת את הקובץ עם אותו שם ומציגה "This article is already in GitHub." לחץ על View it כדי לפתוח את הקובץ הקיים, ואז בחר:

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

שום דבר ב-Clevera לא מוחק קבצים מהמאגר שלך.

ניתוק GitHub#

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

ניתוק מוחק את אסימון הגישה של Clevera. כדי להסיר את הגישה של Clevera גם ב-GitHub, הסר את התקנת האפליקציה Clevera AI (ב-GitHub: Settings → Applications → Installed GitHub Apps → Configure → Uninstall) ובטל את ההרשאה תחת Authorized GitHub Apps.

פתרון בעיות#

קשור#