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

1. משיכת שינויים שבוצעו בממשק ווב

בתרגיל הסיום של השיעור הקודם ביקשתי מכם להיכנס לממשק ה Web של גיטהאב ולעדכן משם את אחד הקבצים בפרויקט. אם לא הספקתם לעשות זאת בואו נעשה את השינוי כעת יחד. אני לוחץ על הקובץ vegan-tacos.md, לוחץ על אייקון העיפרון ומשנה את כותרת המתכון באמצעות הוספת אימוג'י של טאקו לכותרת כלומר הכותרת היא כעת:

Quick Vegan Tacos 🌮️
=====================

אני לוחץ בממשק ה Web על הכפתור הירוק עם הכיתוב Commit Changes, ובתיבה שהופיעה לא משנה דבר ופשוט לוחץ שוב על הכפתור הירוק Commit Changes. אני רואה בממשק שהשינוי התבצע וברשימת הקומיטים של הפרויקט אני רואה קומיט חדש. שימו לב שלכל קומיט יש מספר מזהה ייחודי.

עכשיו אני חוזר לאפליקציית Github Desktop אצלי על המחשב ורוצה לשאול - איפה הקומיט החדש? ואיפה השינויים?

התשובה היא שהקומיט החדש נשמר בתיקיית .git ששמורה על כונן הרשת שגיטהאב יצר עבורי, אבל עדיין לא העתקתי אותה משם חזרה למחשב שלי ולכן אני לא רואה אותה באפליקציה. מתוך האפליקציה נלחץ על הכפתור Fetch origin שנמצא בפס הכפתורים העליון (זה הכפתור השלישי ברשימה). לאחר הלחיצה הופיעה תיבה חדשה עם הטקסט:

Pull 1 commit from the origin remote
The current branch (main) has a commit on GitHub that does not exist on your machine.

והוא צודק! זה הקומיט שיצרתי דרך ממשק ה Web. הכפתור הכחול Pull Origin מאפשר לשלב את הקומיט הזה לתוך הפרויקט שלי. אני לוחץ עליו, התיבה נעלמה ואני עובר לטאב History כדי לראות את כל הקומיטים כולל הקומיט החדש שבוצע מתוך ממשק ה Web.

2. יצירת קומיט חדש מתוך העותק המקומי

נעדכן את הפרויקט באמצעות הוספת קובץ חדש בשם author.txt ובו רשמו את שמכם. חזרו לאפליקציית Github Desktop ובצעו קומיט. לאחר הקומיט אתם רואים שהופיע כפתור כחול חדש עם הטקסט Push. כפתור זה שולח את הקומיט החדש שיצרתם לתיקיית הרשת ב github.com. נלחץ עליו ולאחר מכן נעבור לממשק ה Web של הפרויקט. נשים לב:

1. בממשק הווב אנחנו רואים את הקובץ author.txt ברשימת הקבצים. לחיצה על הקובץ פותחת אותו כדי להציג את תוכנו.

2. ברשימת הקומיטים אנחנו רואים את הקומיט החדש שיצרנו.

3. משיכת הפרויקט לתיקייה חדשה וסינכרון בין התיקיות

בשביל להמחיש את הרעיון של תיקיית .git עבור הריפוזיטורי ותיקיית .git מרכזית בכונן הרשת בואו ננסה ליצור עותק נוסף של הפרויקט עדיין על המחשב שלי אבל בתיקייה חדשה.

נכנס לתפריט File ונבחר Clone Repository. זאת האפשרות שאני בוחר כשאני רוצה למשוך עותק של פרויקט מתיקיית git שיושבת על גיטהאב אליי למחשב. במקרה שלי אחרי ביצוע הפעולה יהיו לי 2 עותקים של ספר המתכונים בשתי תיקיות שונות, ושניהם יהיו מחוברים לאותה תיקיית git מרוחקת בגיטהאב. אני יכול לבחור תיקיית גיט מרוחקת שכבר משויכת לחשבון המשתמש שלי דרך התפריט, או לבחור בטאב URL שם אני יכול להכניס כתובת של כל תיקיית גיט מרוחקת - כולל של פרויקטים ציבוריים שאינם משויכים דווקא לחשבון שלי. אני בוחר בטאב URL והצעד הבא הוא להשיג את ה URL של מאגר הגיט שלי. אני נכנס לממשק ה Web ושם לוחץ על הכפתור הירוק Code. גם פה יש לי 3 טאבים: SSH, HTTPS ו Github CLI. אני נשאר עם טאב HTTPS ומעתיק משם את הכתובת לאפליקציית Github Desktop שלי.

לאחר ביצוע המשיכה יש לי עכשיו שני עותקים של הפרויקט - אחד בתיקייה הראשונה בה יצרתי אותו ושני בתיקייה החדשה שבחרתי עכשיו. בצד שמאל של המסך בתיבת Repository אני יכול לבחור על איזה פרויקט אני עובד עכשיו בתוך אפליקציית Github Desktop.

4. עכשיו אתם

1. מתוך אחד העותקים של הפרויקט בצעו שינוי בקבצים - הוסיפו מתכון חדש למרק עדשים לפי הטקסט הזה:

// file: lentil-soup.md

Vegan Lentil Soup
==================

Ingredients:
- 1 cup dried lentils (green or brown), rinsed
- 1 onion, diced
- 3 cloves garlic, minced
- 2 carrots, chopped
- 2 celery stalks, chopped
- 1 can diced tomatoes
- 6 cups vegetable broth
- 1 tsp cumin
- 1 tsp paprika
- 1 bay leaf
- 1 tbsp olive oil
- Salt and pepper to taste
- Fresh parsley for garnish (optional)

Preparation:
1. Heat the olive oil in a large pot over medium heat. Add the onion, carrots, and celery, and sauté until softened, about 5 minutes.
2. Add the garlic, cumin, and paprika, and cook for another minute.
3. Add the lentils, diced tomatoes, vegetable broth, and bay leaf. Bring to a boil, then reduce heat and simmer for 25-30 minutes, or until lentils are tender.
4. Remove the bay leaf and season with salt and pepper.
5. Garnish with fresh parsley if desired and serve.

שמרו את הקובץ, בצעו קומיט ופרסמו את הקומיט לגיטהאב באמצעות כפתור Push באפליקציית Github Desktop.

1. וודאו שאתם רואים את הקומיט בממשק ה Web של github.com.

2. עברו לתיקייה השניה (העותק של הפרויקט שיצרנו) ובצעו שם Fetch. שימו לב להודעה שיש קומיט חדש בגיטהאב. בצעו Pull כדי לעדכן את התיקייה השניה עם הקומיט החדש.

3. פתחו את התיקייה השנייה בסייר הקבצים בחלונות כדי לוודא שאתם רואים שם את המתכון למרק עדשים.