קרא בשפות אחרות.
מטרת פרויקט זה היא לפשט ולהדריך מתחילים בדרכם אל תרומתם הראשונה לקוד פתוח. אם אתם מחפשים דרך לבצע תרומה ראשונית, עקבו אחר ההוראות הבאות.
אם אינכם חשים בנוח להשתמש בשורת פקודה, כאן תוכלו למצוא מדריכים לשימוש בכלים גרפיים.
אם עוד לא התקנתם GIT, התקינו כעת.
כדי לבצע FORK למאגר זה, ניתן ללחוץ על כפתור ה – FORK בתחילת העמוד. פעולה זה תיצור עותק של מאגר זה בחשבון שלכם.
כעת, שכפלו את המאגר הזה למחשב שלכם. לכו לדף ה-GitHub שלכם, לחצו על כפתור השכפול ואז לחצו על הצלמית copy to clipboard
.
פתחו טרמינל והריצו את הפקודה הבאה:
git clone "url you just copied"
כאשר הביטוי "url you just copied"
(ללא סימני הגרשיים) הוא הקישור למאגר זה שביצעתם עליו FORK קודם לכן. ראו את הצעדים הקודמים כדי להשיג את הקישור.
לדוגמא:
git clone [email protected]: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
כעת פתחו את הקובץ Contributors.md
בתוכנת עריכת טקסט והוסיפו את השם שלכם אליו. אל תוסיפו את השם בתחילת הקובץ או בסופו. הוסיפו אותו באמצע. לאחר שסיימתם, שמרו את הקובץ.
אם תנווטו לתיקיית הפרויקט ותבצעו את הפעולה git status
, תוכלו לראות את השינויים שביצעתם שם.
הוסיפו את השינויים האלו לענף שיצרתם תוך שימוש בפקודה git add
:
git add Contributors.md
עכשיו, בצעו commit לשינויים הללו תוך שימוש בפקודת git commit
:
git commit -m "Add your-name to Contributors list"
החליפו את הביטוי your-name
עם השם שלכם.
דחפו את השינויים תוך שימוש בפקודה 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 [email protected]: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 |
פרוייקט זה נתמך על ידי: