מדריך | יצירת תוסף Tampermonkey עם התקנה בלחיצה דרך GitHub

[פרוזי]

במדריך הזה תלמדו איך להעלות סקריפט Tampermonkey ל־GitHub, כך שכל אחד יוכל להתקין אותו בלחיצה אחת – כולל תמיכה בעדכונים אוטומטיים.

---

🧱 שלב 1: יצירת מאגר (Repository) חדש ב־GitHub

1. היכנס ל־https://github.com/new
   אם אין לך חשבון פשוט צור חשבון חדש (זה חינם...)

2. מלא את הפרטים הבאים:

   • Repository name: (שזה השם) my-userscript (או כל שם אחר)
   • Description: (תיאור) לדוגמה סקריפט Tampermonkey לדוגמה
   • סמן את Public
   • אל תבחר README, .gitignore או LICENSE

3. לחץ על Create repository

---

שלב 2: יצירת קובץ הסקריפט

1. לאחר יצירת המאגר, לחץ על Add file → ואז על Create new file

2. בשורת שם הקובץ כתוב לדוגמה:

   awesome-helper.user.js
   

3. הדבק את קוד הסקריפט שלך (חייב לכלול את בלוק ה־// ==UserScript==)

4. לחץ למטה על Commit new file

---

שלב 3: יצירת קישור התקנה אוטומטית

לאחר שהקובץ עלה, כתובת ההתקנה תהיה:

https://github.com/USERNAME/REPO-NAME/raw/main/awesome-helper.user.js

כאשר USERNAME זה השם משתמש ב github
וREPO-NAME זה השם של הפרוייקט
לדוגמה:

https://github.com/myusername/my-userscript/raw/main/awesome-helper.user.js

כאשר פותחים את הקישור הזה בדפדפן שיש בו את Tampermonkey, הוא מזהה אוטומטית שזה סקריפט ומציע להתקין אותו.

---

שלב 4: עדכונים אוטומטיים

כדי שכל עדכון שתעלה ישפיע אוטומטית על כל המשתמשים:

1. ודא שהקובץ שלך כולל שורת גרסה תקינה:

// @version      1.0.1

2. בכל שינוי שתבצע, הגדל את המספר הזה (למשל ל־1.0.2)
3. Tampermonkey יבדוק לבד כל 24 שעות אם יש גרסה חדשה

---

️ שלב 5: קיצור קישור (רשות)

אפשר לקצר את הקישור עם:

• https://tinyurl.com
• https://bitly.com

ככה תקבל כתובת פשוטה כמו:

https://tinyurl.com/install-helper

---

סיום

עכשיו יש לך תוסף Tampermonkey פתוח, זמין להתקנה ישירה דרך GitHub.
כל מי שתשלח לו את הקישור יוכל להתקין את התוסף בלחיצה אחת.

תודות ל @לאצי שביקש את המדריך

[צדיק וטוב לו 0]

המדריך מיועד עבור מי שרוצה לשתף סקריפט Tampermonkey - בצורת קישור להתקנה ישירה,
יתרון נוסף, זה האפשרות לעדכן אוטומטי בעתיד במקרה הצורך.

נכנסים לגיטאהב, ולוחצים על ה '+' בצד ימין למעלה, ואז בוחרים ב'מאגר חדש' (new repository)

Spoiler

עכשיו:

1. בוחרים את שם המאגר (מקובל בד"כ לבחור שם באנגלית, לא בדקתי האם שם בעברית יוצר בעיות).
   (אחרי 3 שניות יופיע וי ירוק, המאשר שזה שם פנוי)
2. מוודאים שזה מסומן כמו בתמונה על Public.
3. מוודאים שזה מסומן בכחול על Add README.
4. לוחצים על 'יצירת מאגר' (Create repository)

Spoiler

כעת:

1. לוחצים על 'הוספת קובץ' (Add file).
2. ואז בוחרים ב'יצירת קובץ חדש' (Create new file).
   [3. בריבוע הירוק ניתן לערוך את ההסבר שיופיע בעמוד המאגר, מה מטרת המאגר-הסקריפט, מי יצר וכד']

Spoiler

וכעת:

1. בוחרים את שם הקובץ (גם כאן מקובל לבחור שם באנגלית, וכנ"ל).
   לשים לב, חובה ששם הקובץ יסתיים בסיומת של user.js ! (נניח ABC.user.js)
2. בתיבה העיקרית מדביקים את תוכן הסקריפט.
3. לוחצים על שמירת השינויים (Commit changeg).

Spoiler

עכשיו מאשרים
על 1 - 2 ניתן לדלג (זה לרשום תיעוד פנימי, מה השינוי שבוצע בפעולה)
העיקר זה 3 - שמירת השינויים (Commit changeg).

Spoiler

מזל טוב, המאגר נוצר!
כעת מעתיקים את הקישור הישיר להתקנה.
לוחצים על הקובץ שיצרנו (הקובץ בסיומת .user.js, ולא הקובץ הראשון בסיומת .md):

Spoiler

כעת לחיצה עם קליק ימני בעכבר על Raw.
ואז 'העתקת כתובת הקישור'.
הכתובת שהועתקה - זה הכתובת לשיתוף קישור ישיר.

Spoiler

בהצלחה.󠁮󠁢󠁢󠁵󠀱

[צדיק וטוב לו 0]

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

מבנה הקישורים הוא כך:

// @updateURL    https://raw.githubusercontent.com/{1}/{2}/main/{3}
// @downloadURL  https://raw.githubusercontent.com/{1}/{2}/main/{3}

במקום:
{1} - שם המשתמש בגיטאהב.
{2} - שם המאגר שבחרנו.
{3} - שם הקובץ שבחרנו (בעל הסיומת של user.js).

מבנה הגירסא הוא:

// @version      1.0

ובכל עדכון לעלות מספר (או מספר עשרוני, בד"כ מקובל בהתאם לכמה השינוי בגירסא הוא משמעותי).󠁮󠁢󠁢󠁵󠀱

[המלאך]

@צדיק-וטוב-לו-0 מה עם רישיון?

[מייבין במקצת]

@צדיק-וטוב-לו-0 נכתב בעבר כאן