prempyla
25 KiB
קרא בשפות אחרות.
תרומות ראשונות
מטרת פרויקט זה היא לפשט ולהדריך מתחילים בדרכם אל תרומתם הראשונה לקוד פתוח. אם אתם מחפשים דרך לבצע תרומה ראשונית, עקבו אחר ההוראות הבאות.
אם אינכם חשים בנוח להשתמש בשורת פקודה, כאן תוכלו למצוא מדריכים לשימוש בכלים גרפיים.
אם עוד לא התקנתם GIT, התקינו כעת.
בצעו FORK למאגר זה
כדי לבצע FORK למאגר זה, ניתן ללחוץ על כפתור ה – FORK בתחילת העמוד. פעולה זה תיצור עותק של מאגר זה בחשבון שלכם.
שכפול המאגר
כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית copy to clipboard.
פתחו טרמינל והריצו את הפקודה הבאה:
git clone "url you just copied"
כאשר הביטוי "url you just copied" (ללא סימני הגרשיים) הוא הקישור למאגר זה שביצעתם עליו FORK קודם לכן. ראו את הצעדים הקודמים כדי להשיג את הקישור.
לדוגמא:
git clone git@github.com:this-is-you/first-contributions.git
כאשר this-is-you הוא שם המשתמש שלכם ב-GitHub. לכאן אתם מעתיקים את התוכן של מאגר first-contributions ב-GitHub לתוך המחשב שלכם.
יצירת ענף
החליפו לתיקיית המאגר בתוך המחשב שלכם (באם טרם נכנסתם לתיקייה זו):
cd first-contributions
כעת, צרו ענף (branch) בשימוש הפעולה git switch:
git switch -c your-new-branch-name
לדוגמא:
git switch -c add-alonzo-church
אם אתה מקבל שגיאות בעת השימוש ב-git switch, לחץ כאן:
אם מופיעה הודעת השגיאה "Git: switch is not a git command. See git –help",
זה כנראה בגלל שאתה משתמש בגרסה ישנה של Git.
במקרה כזה, נסה להשתמש במקום זאת בפקודה git checkout:
git checkout -b your-new-branch-name
ערכו שינויים הכרחיים ובצעו להם commit
כעת פתחו את הקובץ Contributors.md בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ.
אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה git status, תוכלו לראות את השינויים שביצעתם שם.
הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה git add:
git add Contributors.md
עכשיו, בצעו commit לשינויים הללו תוך שימוש בפקודת git commit:
git commit -m "Add your-name to Contributors list"
החליפו את הביטוי your-name עם השם שלכם.
לדחוף את השינויים ל-GitHub
דחפו את השינויים תוך שימוש בפקודה git push:
git push origin add-your-branch-name
החליפו את add-your-branch-name עם השם של הענף שיצרתם מוקדם יותר.
במידה ומתקבלות שגיאות במהלך הדחיפה, לחץ כאן
-
שגיאת אימות
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: Authentication failed for 'https://github.com/<your-username>/first-contributions.git/'
עברו אל המדריך של GitHub על יצירה והגדרה של מפתח SSH לחשבון שלך.
כמו כן, ייתכן שתרצה להריץ את הפקודה 'git remote -v' כדי לבדוק את הכתובת המרוחקת שלך.
אם זה דומה לזה:
origin https://github.com/your-username/your_repo.git (fetch)
origin https://github.com/your-username/your_repo.git (push)
תחליף את זה בעזרת הפקודה:
git remote set-url origin git@github.com:your-username/your_repo.git
אחרת, עדיין תתבקש לספק שם משתמש וסיסמה ותקבל שגיאת אימות.
הגישו את השינויים שלכם לסקירה
אם תלכו למאגר שלכם ב-GitHub, תוכלו לראות כפתור עם הכיתוב Compare & pull request. לחצו על כפתור זה.
כעת, הגישו את בקשת הדחיפה (pull request):
בקרוב, אצרף את כל השינויים לתוך הענף הראשי של פרויקט זה. אתם תקבלו עדכון במייל ברגע שהשינויים ימוזגו.
מה לעשות מכאן?
כל הכבוד! כרגע סיימתם את מעגל הזרימה הסטנדרטי של fork -> clone -> edit -> pull request שאתם תפגשו באופן שכיח כתורמים!
תחגגו את התרומתכם ושתפו אותה עם החברים והעוקבים שלכם בכך שתלכו ל-web app.
עכשיו אפשר להתחיל לתרום לפרוייקטים אחרים. הכנו רשימה של פרוייקטים על נושאים קלים שאתם יכולים להתחיל לעבוד עליהם. רשימה של פרוייקטים ב- web app.
חומר נוסף
הדרכות בשימוש כלים אחרים
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |
פרוייקט זה נתמך על ידי:
