คู่มือฉบับย่อสำหรับการใช้ Github

บทช่วยสอนนี้เป็นคำแนะนำโดยย่อในการติดตั้งและใช้งาน GitHub ต่อไปนี้เป็นวิธีสร้างที่เก็บในเครื่องวิธีเชื่อมต่อที่เก็บในเครื่องนี้กับที่เก็บ Github ระยะไกล (ที่ทุกคนสามารถมองเห็นได้) วิธียอมรับการเปลี่ยนแปลงและสุดท้ายวิธีพุชเนื้อหาที่เก็บในเครื่องทั้งหมดไปยัง GitHub รวมถึงงานทั่วไปอื่น ๆ .

ก่อนเริ่มต้นสิ่งสำคัญคือต้องทราบว่าบทช่วยสอนนี้มีความเข้าใจพื้นฐานเกี่ยวกับคำศัพท์ที่ใช้ใน Git: push, pull, กระทำ, ที่เก็บ ฯลฯ นอกจากนี้ยังต้องลงทะเบียนล่วงหน้าใน GitHub.

การติดตั้ง Github

บน Debian / Ubuntu และอนุพันธ์:

sudo apt-get install git

En Fedora และอนุพันธ์:

sudo yum install git

En โค้ง และอนุพันธ์:

sudo pacman -S คอมไพล์

การตั้งค่าเริ่มต้นของ Github

เมื่อการติดตั้งเสร็จสมบูรณ์ขั้นตอนต่อไปคือกำหนดค่ารายละเอียดการกำหนดค่าผู้ใช้ GitHub ในการดำเนินการนี้ให้ใช้คำสั่งต่อไปนี้โดยแทนที่ "ชื่อผู้ใช้" ด้วยชื่อผู้ใช้ GitHub และ "email_id" ด้วยที่อยู่อีเมลที่ใช้สร้างบัญชี GitHub

git config --global user.name "ชื่อผู้ใช้" git config --global user.email "email_id"

สร้างที่เก็บในเครื่อง

สิ่งแรกคือการสร้างโฟลเดอร์ในคอมพิวเตอร์ของคุณซึ่งจะทำหน้าที่เป็นที่เก็บในเครื่อง ในการดำเนินการนี้ให้เรียกใช้คำสั่งต่อไปนี้:

git เริ่มต้น Mytest

คำสั่งนี้สร้างโฟลเดอร์ MyTest ในทางกลับกันโฟลเดอร์ย่อย .in ทำให้ MyTest ได้รับการยอมรับว่าเป็นที่เก็บ Git ในเครื่อง

หากสร้างที่เก็บสำเร็จบรรทัดที่คล้ายกับต่อไปนี้จะปรากฏขึ้น:

เริ่มต้นที่เก็บ Git ว่างใน /home/tu_usuario/Mytest/.git/

จากนั้นคุณต้องไปที่โฟลเดอร์ MyTest:

ซีดี Mytest

สร้างไฟล์ README เพื่ออธิบายที่เก็บ

โดยทั่วไปไฟล์ README จะใช้เพื่ออธิบายสิ่งที่เก็บข้อมูลหรือสิ่งที่โครงการเกี่ยวกับ ในการสร้างเพียงเรียกใช้:

เกดิท README

เมื่อคุณป้อนคำอธิบายที่เก็บแล้วอย่าลืมบันทึกการเปลี่ยนแปลงของคุณ

การเพิ่มไฟล์ที่เก็บลงในดัชนี

นี่เป็นขั้นตอนที่สำคัญ ก่อนที่คุณจะสามารถอัปโหลดการเปลี่ยนแปลงไปยัง Github หรือเซิร์ฟเวอร์อื่นที่เข้ากันได้กับ Git คุณต้องทำดัชนีไฟล์ทั้งหมดที่มีอยู่ในที่เก็บในเครื่อง ดัชนีนี้จะมีไฟล์ใหม่รวมถึงการเปลี่ยนแปลงไฟล์ที่มีอยู่ในที่เก็บในเครื่อง

ในกรณีของเราที่เก็บในเครื่องของเรามีไฟล์ใหม่อยู่แล้วนั่นคือ README ดังนั้นเราจะสร้างไฟล์อื่นด้วยโปรแกรม C อย่างง่ายซึ่งเราจะเรียกว่า example.c เนื้อหาจะเป็น:

#include int main () {printf ("สวัสดีชาวโลก"); กลับ 0; }

ตอนนี้เรามี 2 ไฟล์ในที่เก็บในเครื่องของเรา: README และ example.c

ขั้นตอนต่อไปคือการเพิ่มไฟล์เหล่านี้ในดัชนี:

git เพิ่ม README git เพิ่ม smaple.c

คำสั่ง "git add" สามารถใช้เพื่อเพิ่มไฟล์และโฟลเดอร์จำนวนเท่าใดก็ได้ในดัชนี หากต้องการเพิ่มการเปลี่ยนแปลงทั้งหมดโดยไม่ต้องระบุชื่อไฟล์คุณสามารถเรียกใช้ "git add" ได้ (มีจุดต่อท้าย)

บันทึกการเปลี่ยนแปลงที่เกิดขึ้นกับดัชนี

เมื่อเพิ่มไฟล์ทั้งหมดแล้วคุณสามารถเก็บบันทึกการเปลี่ยนแปลงเหล่านี้ไว้ได้โดยการทำสิ่งที่เรียกว่า "คอมมิต" ในศัพท์แสง ซึ่งหมายความว่าการเพิ่มหรือแก้ไขไฟล์เสร็จสมบูรณ์แล้วและสามารถอัปโหลดการเปลี่ยนแปลงไปยังที่เก็บ Github ระยะไกลได้ ในการดำเนินการนี้คุณต้องดำเนินการคำสั่งต่อไปนี้:

คอมมิต -m "ข้อความ"

"ข้อความ" อาจเป็นข้อความใดก็ได้ที่อธิบายการเปลี่ยนแปลงที่เป็นปัญหาโดยสังเขปเช่น "ฉันเพิ่มฟังก์ชันดังกล่าวแล้ว" หรือ "ฉันแก้ไขสิ่งนั้นแล้ว" เป็นต้น

สร้างที่เก็บบน GitHub

ชื่อที่เก็บต้องเหมือนกันกับที่เก็บบนระบบโลคัล ในกรณีนี้จะเป็น "MyTest" ในการดำเนินการนี้ก่อนอื่นคุณต้องเข้าสู่ระบบ Github. จากนั้นคุณต้องคลิกที่เครื่องหมายบวก (+) ที่มุมขวาบนของหน้าแล้วเลือกตัวเลือก "สร้างที่เก็บใหม่" สุดท้ายคุณต้องกรอกข้อมูลและคลิกที่ปุ่ม "สร้างที่เก็บ"

เมื่อเสร็จแล้วที่เก็บจะถูกสร้างขึ้นและจะสามารถอัปโหลดเนื้อหาของที่เก็บในเครื่องไปยังที่เก็บ GitHub ได้ ในการเชื่อมต่อกับที่เก็บระยะไกลบน GitHub คุณต้องรันคำสั่ง:

git ระยะไกลเพิ่มต้นทาง https://github.com/user_name/Mytest.git

พุชไฟล์จากที่เก็บในเครื่องไปยังที่เก็บ GitHub

ขั้นตอนสุดท้ายคือการพุชเนื้อหาของที่เก็บโลคัลไปยังที่เก็บระยะไกลโดยใช้คำสั่ง:

git push master ต้นทาง

เพียงแค่ป้อนข้อมูลรับรองการเข้าสู่ระบบ (ชื่อผู้ใช้และรหัสผ่าน) เท่านั้น

สิ่งนี้จะอัปโหลดเนื้อหาทั้งหมดของโฟลเดอร์ MyTest (ที่เก็บในเครื่อง) ไปยัง GitHub (ที่เก็บภายนอก) สำหรับโครงการต่อ ๆ ไปคุณไม่จำเป็นต้องทำตามขั้นตอนเหล่านี้ตั้งแต่ต้นอีกต่อไป คุณสามารถเริ่มจากขั้นตอนที่ 3 ได้โดยตรง สุดท้ายนี้อย่าลืมว่าการเปลี่ยนแปลงจะพร้อมใช้งานจากเว็บไซต์ Github

การสร้างสาขา

เมื่อนักพัฒนาต้องการแก้ไขข้อบกพร่องหรือเพิ่มคุณสมบัติใหม่พวกเขามักจะสร้าง Branch หรือสำเนาของโค้ดเพื่อให้สามารถคอมมิตแยกกันโดยไม่ส่งผลกระทบต่อโปรเจ็กต์เดิม จากนั้นเมื่อเสร็จแล้วพวกเขาสามารถรวมสาขานี้กลับไปที่สาขาหลัก (หลัก)

ในการสร้างสาขาใหม่มีสองตัวเลือก:

ตัวเลือกยาว:

git branch mirama # สร้างสาขาใหม่ชื่อ mirama git checkout mirama - เปลี่ยนไปใช้ mirama branch

ตัวเลือกสั้น ๆ :

git checkout -b mirama - สร้างและเปลี่ยนไปใช้สาขา mirama

เมื่อทำการเปลี่ยนแปลงแล้วให้เพิ่มลงในดัชนีสาขาและทำการคอมมิตที่เกี่ยวข้อง:

คอมไพล์เพิ่ม คอมมิตคอมมิต -m "เปลี่ยนมิราม่า"

จากนั้นคุณต้องกลับไปที่สาขาหลักและทำการเปลี่ยนแปลงใน mirama:

git checkout master git ผสาน mirama

สุดท้ายคุณต้องลบ mirama (เนื่องจากการเปลี่ยนแปลงถูกรวมไว้ใน master):

สาขา git -d mirama

และอัปโหลดต้นแบบไปยัง Github:

git push master ต้นทาง

การสร้างที่เก็บ Git ที่ได้รับ (ส้อม)

ต้องขอบคุณ Git และการมีอยู่ของไลบรารีพื้นที่เก็บข้อมูลสาธารณะขนาดใหญ่เช่น Github โดยส่วนใหญ่ไม่จำเป็นต้องเริ่มเขียนโปรแกรมโครงการของเราตั้งแต่เริ่มต้น ในกรณีดังกล่าวเป็นไปได้ที่จะใช้รหัสพื้นฐานนี้เพื่อสร้างโครงการใหม่

ในการทำสิ่งนี้สิ่งแรกที่ต้องทำคือการแยกที่เก็บที่มีอยู่นั่นคือโปรเจ็กต์ที่ได้มาจากมันตามรหัสของโปรเจ็กต์ดั้งเดิม ใน Github สามารถทำได้โดยการคลิกปุ่มที่เกี่ยวข้องดังที่เห็นในภาพหน้าจอด้านล่าง

จากนั้นสิ่งที่เราต้องทำคือโคลนที่เก็บของโครงการใหม่นี้บนคอมพิวเตอร์ของเรา ตัวอย่างเช่นเราสามารถใช้ที่เก็บ Ankifox ของฉันซึ่งเป็นส่วนขยายสำหรับ Firefox ที่อนุญาตให้เพิ่มคำเข้าไป Ankiซึ่งมีอยู่ใน Github:

โคลน git https://github.com/usemoslinux/Ankifox.git

อย่าลืมแทนที่ https://github.com/usemoslinux/Ankifox.git ด้วย URL ที่ตรงกับโครงการของคุณ การรับที่อยู่นี้ทำได้ง่ายมากดังที่เห็นในภาพด้านล่าง

คำสั่งนี้จะสร้างไดเร็กทอรีชื่อ« Ankifox »โดยจะเริ่มต้นไดเร็กทอรี. git ที่อยู่ภายในและจะดาวน์โหลดข้อมูลทั้งหมดจากที่เก็บนั้นเพื่อให้ทำงานกับเวอร์ชันล่าสุดได้