History

leestott 5b43ca2573 🌐 Update translations via Co-op Translator		2 months ago
..
README.md	🌐 Update translations via Co-op Translator	2 months ago

README.md

Panimula sa GitHub

Ang araling ito ay tumatalakay sa mga pangunahing kaalaman sa GitHub, isang platform para mag-host at mag-manage ng mga pagbabago sa iyong code.

Sketchnote ni Tomomi Imura

Pre-Lecture Quiz

Pre-lecture quiz

Panimula

Sa araling ito, tatalakayin natin ang:

pagsubaybay sa mga ginagawa mo sa iyong makina
pakikipagtulungan sa mga proyekto kasama ang iba
paano mag-ambag sa open source software

Mga Kinakailangan

Bago magsimula, kailangan mong tiyakin kung naka-install na ang Git. Sa terminal, i-type: git --version

Kung hindi pa naka-install ang Git, i-download ang Git. Pagkatapos, i-setup ang iyong lokal na Git profile sa terminal:

git config --global user.name "your-name"
git config --global user.email "your-email"

Para suriin kung naka-configure na ang Git, maaari mong i-type: git config --list

Kailangan mo rin ng GitHub account, isang code editor (tulad ng Visual Studio Code), at kailangan mong buksan ang iyong terminal (o: command prompt).

Pumunta sa github.com at gumawa ng account kung wala ka pa, o mag-login at punan ang iyong profile.

✅ Hindi lang GitHub ang code repository sa mundo; may iba pang mga platform, ngunit ang GitHub ang pinakakilala.

Paghahanda

Kailangan mo ng folder na may code project sa iyong lokal na makina (laptop o PC), at isang pampublikong repository sa GitHub, na magsisilbing halimbawa kung paano mag-ambag sa mga proyekto ng iba.

Pamamahala ng Code

Halimbawa, mayroon kang folder sa lokal na makina na may code project at gusto mong simulan ang pagsubaybay sa iyong progreso gamit ang git - ang version control system. Ang iba ay inihahalintulad ang paggamit ng git sa pagsusulat ng love letter para sa iyong hinaharap na sarili. Sa pagbabasa ng iyong commit messages makalipas ang ilang araw, linggo, o buwan, maaalala mo kung bakit mo ginawa ang isang desisyon, o "rollback" ang isang pagbabago - iyon ay, kung nagsusulat ka ng magagandang "commit messages".

Gawain: Gumawa ng repository at mag-commit ng code

Tingnan ang video

Gumawa ng repository sa GitHub. Sa GitHub.com, sa tab ng repositories, o mula sa navigation bar sa kanang itaas, hanapin ang new repo button.
1. Bigyan ng pangalan ang iyong repository (folder)
2. Piliin ang create repository.
Pumunta sa iyong working folder. Sa iyong terminal, lumipat sa folder (kilala rin bilang directory) na gusto mong simulan ang pagsubaybay. I-type:
```
cd [name of your folder]
```
I-initialize ang isang git repository. Sa iyong proyekto, i-type:
```
git init
```
Suriin ang status. Para suriin ang status ng iyong repository, i-type:
```
git status
```
Ang output ay maaaring ganito:
```
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

     modified:   file.txt
     modified:   file2.txt
```
Karaniwan, ang git status command ay nagsasabi ng mga bagay tulad ng kung anong mga file ang handa nang i-save sa repo o may mga pagbabago na maaaring gusto mong i-persist.
Idagdag ang lahat ng file para sa pagsubaybay Tinatawag din itong pag-stage ng mga file/pagdaragdag ng mga file sa staging area.
```
git add .
```
Ang git add kasama ang . argument ay nagpapahiwatig na lahat ng iyong mga file at pagbabago ay para sa pagsubaybay.
Idagdag ang mga napiling file para sa pagsubaybay
```
git add [file or folder name]
```
Nakakatulong ito upang idagdag lamang ang mga napiling file sa staging area kapag ayaw mong i-commit ang lahat ng file nang sabay-sabay.
I-unstage ang lahat ng file
```
git reset
```
Ang command na ito ay nakakatulong upang i-unstage ang lahat ng file nang sabay-sabay.
I-unstage ang isang partikular na file
```
git reset [file or folder name]
```
Ang command na ito ay nakakatulong upang i-unstage lamang ang isang partikular na file na ayaw mong isama sa susunod na commit.
I-persist ang iyong trabaho. Sa puntong ito, naidagdag mo na ang mga file sa tinatawag na staging area. Isang lugar kung saan sinusubaybayan ng Git ang iyong mga file. Para gawing permanente ang pagbabago, kailangan mong i-commit ang mga file. Para gawin ito, gumawa ng commit gamit ang git commit command. Ang commit ay kumakatawan sa isang saving point sa kasaysayan ng iyong repo. I-type ang sumusunod para gumawa ng commit:
```
git commit -m "first commit"
```
Iko-commit nito ang lahat ng iyong mga file, na may mensaheng "first commit". Para sa mga susunod na commit messages, mas mainam na maging mas detalyado sa iyong paglalarawan upang maipahayag kung anong uri ng pagbabago ang ginawa mo.
Ikonekta ang iyong lokal na Git repo sa GitHub. Ang isang Git repo ay maganda sa iyong makina ngunit sa isang punto, gusto mong magkaroon ng backup ng iyong mga file sa isang lugar at mag-imbita ng ibang tao na makipagtulungan sa iyong repo. Ang isang mahusay na lugar para gawin ito ay ang GitHub. Tandaan na gumawa na tayo ng repo sa GitHub kaya ang tanging kailangan nating gawin ay ikonekta ang lokal na Git repo sa GitHub. Ang command na git remote add ang gagawa nito. I-type ang sumusunod na command:

Tandaan, bago mo i-type ang command, pumunta sa iyong GitHub repo page upang hanapin ang repository URL. Gagamitin mo ito sa command sa ibaba. Palitan ang https://github.com/username/repository_name.git ng iyong GitHub URL.
```
git remote add origin https://github.com/username/repository_name.git
```
Gumagawa ito ng remote, o koneksyon, na pinangalanang "origin" na tumuturo sa GitHub repository na ginawa mo kanina.
Ipadala ang mga lokal na file sa GitHub. Sa ngayon, gumawa ka ng connection sa pagitan ng lokal na repo at ng GitHub repo. Ipadala natin ang mga file na ito sa GitHub gamit ang sumusunod na command na git push, ganito:

Tandaan, maaaring iba ang pangalan ng iyong branch sa default na main.
```
git push -u origin main
```
Ipinapadala nito ang iyong mga commits sa iyong "main" branch sa GitHub. Ang pag-set ng upstream branch kabilang ang -u sa command ay nagtatatag ng link sa pagitan ng iyong lokal na branch at ng remote branch, kaya maaari mong gamitin ang git push o git pull nang hindi tinutukoy ang pangalan ng branch sa hinaharap. Awtomatikong gagamitin ng Git ang upstream branch at hindi mo na kailangang tukuyin ang pangalan ng branch sa mga susunod na command.
Para magdagdag ng higit pang mga pagbabago. Kung gusto mong magpatuloy sa paggawa ng mga pagbabago at i-push ang mga ito sa GitHub, kakailanganin mo lang gamitin ang sumusunod na tatlong command:
```
git add .
git commit -m "type your commit message here"
git push
```
Tip, Maaaring gusto mo ring gumamit ng .gitignore file upang maiwasan ang mga file na ayaw mong i-track na lumitaw sa GitHub - tulad ng notes file na iniimbak mo sa parehong folder ngunit walang lugar sa isang pampublikong repository. Maaari kang makahanap ng mga template para sa .gitignore files sa .gitignore templates.

Mga Commit Messages

Ang isang mahusay na Git commit subject line ay kumukumpleto sa sumusunod na pangungusap: Kung ilalapat, ang commit na ito ay

Para sa subject, gamitin ang imperative, present tense: "change" hindi "changed" o "changes". Tulad ng sa subject, sa body (opsyonal) ay gamitin din ang imperative, present tense. Ang body ay dapat maglaman ng motibasyon para sa pagbabago at ikumpara ito sa nakaraang behavior. Ipinaliwanag mo ang bakit, hindi ang paano.

✅ Maglaan ng ilang minuto upang mag-surf sa GitHub. Makakakita ka ba ng isang talagang mahusay na commit message? Makakakita ka ba ng isang talagang minimal na isa? Anong impormasyon ang sa tingin mo ay pinakamahalaga at kapaki-pakinabang na ipahayag sa isang commit message?

Gawain: Makipagtulungan

Ang pangunahing dahilan ng paglalagay ng mga bagay sa GitHub ay upang gawing posible ang pakikipagtulungan sa ibang mga developer.

Pagtatrabaho sa mga proyekto kasama ang iba

Tingnan ang video

Sa iyong repository, pumunta sa Insights > Community upang makita kung paano ikinukumpara ang iyong proyekto sa mga inirerekomendang pamantayan ng komunidad.

Narito ang ilang bagay na maaaring magpabuti sa iyong GitHub repo:

Description. Nagdagdag ka ba ng description para sa iyong proyekto?
README. Nagdagdag ka ba ng README? Nagbibigay ang GitHub ng gabay para sa pagsusulat ng README.
Contributing guideline. Mayroon bang contributing guidelines ang iyong proyekto?
Code of Conduct. Mayroon bang Code of Conduct?
License. Marahil ang pinakamahalaga, isang license?

Ang lahat ng mga resource na ito ay makikinabang sa onboarding ng mga bagong miyembro ng team. At ang mga ito ay karaniwang ang uri ng mga bagay na tinitingnan ng mga bagong contributor bago pa man tingnan ang iyong code, upang malaman kung ang iyong proyekto ay ang tamang lugar para sa kanila upang gugulin ang kanilang oras.

✅ Ang mga README file, bagama't nangangailangan ng oras upang ihanda, ay madalas na napapabayaan ng mga abalang maintainer. Makakakita ka ba ng halimbawa ng isang partikular na deskriptibong README? Tandaan: may ilang tools para tumulong gumawa ng magagandang README na maaaring gusto mong subukan.

Gawain: Mag-merge ng code

Ang mga contributing docs ay tumutulong sa mga tao na mag-ambag sa proyekto. Ipinaliwanag nito kung anong uri ng mga kontribusyon ang hinahanap mo at kung paano gumagana ang proseso. Ang mga contributor ay kailangang dumaan sa isang serye ng mga hakbang upang makapag-ambag sa iyong repo sa GitHub:

Forking ng iyong repo. Malamang na gusto mong mag-fork ang mga tao sa iyong proyekto. Ang pag-fork ay nangangahulugan ng paggawa ng replika ng iyong repository sa kanilang GitHub profile.
Clone. Mula doon, i-clone nila ang proyekto sa kanilang lokal na makina.
Gumawa ng branch. Gusto mong hilingin sa kanila na gumawa ng branch para sa kanilang trabaho.
Mag-focus sa isang lugar ng pagbabago. Hilingin sa mga contributor na ituon ang kanilang kontribusyon sa isang bagay lamang sa bawat pagkakataon - sa ganitong paraan, mas mataas ang tsansa na ma-merge ang kanilang trabaho. Halimbawa, nagsulat sila ng bug fix, nagdagdag ng bagong feature, at nag-update ng ilang tests - paano kung gusto mo, o maaari mo lamang i-implement ang 2 sa 3, o 1 sa 3 pagbabago?

✅ Mag-isip ng sitwasyon kung saan ang mga branch ay partikular na mahalaga sa pagsusulat at pagpapadala ng magandang code. Anong mga use case ang naiisip mo?

Tandaan, maging ang pagbabago na gusto mong makita sa mundo, at gumawa ng mga branch para sa iyong sariling trabaho. Ang anumang mga commit na gagawin mo ay gagawin sa branch na kasalukuyan mong "checked out". Gamitin ang git status upang makita kung aling branch iyon.

Dumaan tayo sa workflow ng isang contributor. Ipagpalagay na ang contributor ay nag-fork at nag-clone na ng repo kaya mayroon silang Git repo na handa nang trabahuin, sa kanilang lokal na makina:

Gumawa ng branch. Gamitin ang command na git branch upang gumawa ng branch na maglalaman ng mga pagbabago na balak nilang i-ambag:
```
git branch [branch-name]
```
Lumipat sa working branch. Lumipat sa tinukoy na branch at i-update ang working directory gamit ang git switch:
```
git switch [branch-name]
```
Gumawa ng trabaho. Sa puntong ito, gusto mong idagdag ang iyong mga pagbabago. Huwag kalimutang ipaalam ito sa Git gamit ang mga sumusunod na command:
```
git add .
git commit -m "my changes"
```
Tiyaking bibigyan mo ang iyong commit ng magandang pangalan, para sa iyong kapakanan pati na rin sa maintainer ng repo na tinutulungan mo.
Pagsamahin ang iyong trabaho sa main branch. Sa isang punto, tapos ka na sa paggawa at gusto mong pagsamahin ang iyong trabaho sa main branch. Ang main branch ay maaaring nagbago sa pagitan kaya siguraduhing i-update muna ito sa pinakabago gamit ang mga sumusunod na command:
```
git switch main
git pull
```
Sa puntong ito, gusto mong tiyakin na anumang conflicts, mga sitwasyon kung saan hindi madaling ma-combine ng Git ang mga pagbabago, ay mangyayari sa iyong working branch. Kaya't patakbuhin ang mga sumusunod na command:
```
git switch [branch_name]
git merge main
```
Ang git merge main command ay magdadala ng lahat ng pagbabago mula sa main papunta sa iyong branch. Sana ay maaari kang magpatuloy. Kung hindi, sasabihin sa iyo ng VS Code kung saan nalilito ang Git at babaguhin mo lang ang mga apektadong file upang sabihin kung aling content ang pinaka-tama.

Para lumipat sa ibang branch, gamitin ang modernong git switch command:
```
git switch [branch_name]
```
Ipadala ang iyong trabaho sa GitHub. Ang pagpapadala ng iyong trabaho sa GitHub ay nangangahulugan ng dalawang bagay. Ang pag-push ng iyong branch sa iyong repo at pagkatapos ay magbukas ng PR, Pull Request.
```
git push --set-upstream origin [branch-name]
```
Ang command sa itaas ay lumilikha ng branch sa iyong forked repo.
Magbukas ng PR. Susunod, gusto mong magbukas ng PR. Magagawa mo ito sa pamamagitan ng pagpunta sa forked na repo sa GitHub. Makikita mo ang indikasyon sa GitHub kung saan tinatanong kung gusto mong gumawa ng bagong PR, i-click mo iyon at dadalhin ka sa interface kung saan maaari mong baguhin ang pamagat ng commit message, magbigay ng mas angkop na deskripsyon. Ngayon, makikita ng maintainer ng repo na iyong na-fork ang PR na ito at sana ma-appreciate nila at i-merge ang iyong PR. Isa ka nang contributor, yay :)
Linisin ang branch. Itinuturing na magandang praktis ang linisin ang branch pagkatapos mong matagumpay na ma-merge ang isang PR. Gusto mong linisin ang parehong lokal na branch at ang branch na iyong na-push sa GitHub. Una, burahin ito sa lokal gamit ang sumusunod na command:
```
git branch -d [branch-name]
```
Siguraduhing pumunta sa GitHub page ng forked na repo at tanggalin ang remote branch na iyong na-push dito.

Ang Pull request ay tila nakakatawang termino dahil ang totoo ay gusto mong i-push ang iyong mga pagbabago sa proyekto. Ngunit ang maintainer (may-ari ng proyekto) o core team ay kailangang suriin ang iyong mga pagbabago bago ito i-merge sa "main" branch ng proyekto, kaya't talagang humihiling ka ng desisyon sa pagbabago mula sa maintainer.

Ang pull request ay lugar kung saan maikukumpara at mapag-uusapan ang mga pagkakaiba na idinagdag sa isang branch gamit ang mga review, komento, integrated tests, at iba pa. Ang isang mahusay na pull request ay sumusunod sa halos parehong mga patakaran tulad ng commit message. Maaari kang magdagdag ng reference sa isang isyu sa issue tracker, halimbawa kung ang iyong trabaho ay nag-aayos ng isang isyu. Ginagawa ito gamit ang # na sinusundan ng numero ng iyong isyu. Halimbawa, #97.

🤞Sana pumasa ang lahat ng checks at i-merge ng may-ari ng proyekto ang iyong mga pagbabago sa proyekto🤞

I-update ang kasalukuyang lokal na working branch gamit ang lahat ng bagong commits mula sa kaukulang remote branch sa GitHub:

git pull

Paano mag-contribute sa open source

Una, maghanap ng repository (o repo) sa GitHub na interesado ka at gusto mong magdagdag ng pagbabago. Gusto mong kopyahin ang nilalaman nito sa iyong makina.

✅ Isang magandang paraan para makahanap ng 'beginner-friendly' na mga repo ay ang maghanap gamit ang tag na 'good-first-issue'.

May ilang paraan para makopya ang code. Isa sa mga paraan ay ang "i-clone" ang nilalaman ng repository, gamit ang HTTPS, SSH, o ang GitHub CLI (Command Line Interface).

Buksan ang iyong terminal at i-clone ang repository tulad nito: git clone https://github.com/ProjectURL

Para magtrabaho sa proyekto, pumunta sa tamang folder: cd ProjectURL

Maaari mo ring buksan ang buong proyekto gamit ang Codespaces, ang embedded code editor / cloud development environment ng GitHub, o GitHub Desktop.

Sa huli, maaari mong i-download ang code sa isang zipped folder.

Ilang mga kawili-wiling bagay tungkol sa GitHub

Maaari kang mag-star, mag-watch, at/o "mag-fork" ng anumang pampublikong repository sa GitHub. Makikita mo ang iyong mga starred repositories sa drop-down menu sa kanang itaas. Para itong pag-bookmark, pero para sa code.

Ang mga proyekto ay may issue tracker, kadalasan sa GitHub sa tab na "Issues" maliban kung may ibang indikasyon, kung saan pinag-uusapan ng mga tao ang mga isyu na may kaugnayan sa proyekto. At ang tab na Pull Requests ay kung saan pinag-uusapan at nire-review ang mga pagbabago na nasa proseso.

Ang mga proyekto ay maaaring may diskusyon sa mga forum, mailing lists, o chat channels tulad ng Slack, Discord, o IRC.

✅ Tingnan ang paligid ng iyong bagong GitHub repo at subukan ang ilang bagay, tulad ng pag-edit ng mga setting, pagdaragdag ng impormasyon sa iyong repo, at paggawa ng proyekto (tulad ng isang Kanban board). Maraming magagawa!

🚀 Hamon

Makipag-partner sa isang kaibigan upang magtrabaho sa code ng isa't isa. Gumawa ng proyekto nang magkasama, mag-fork ng code, gumawa ng mga branch, at mag-merge ng mga pagbabago.

Post-Lecture Quiz

Post-lecture quiz

Review & Self Study

Magbasa pa tungkol sa pag-contribute sa open source software.

Git cheatsheet.

Practice, practice, practice. May magagandang learning paths ang GitHub na makikita sa skills.github.com:

First Week on GitHub

Makakakita ka rin ng mas advanced na mga kurso.

Assignment

Kumpletuhin ang First Week on GitHub course

Paunawa:
Ang dokumentong ito ay isinalin gamit ang AI translation service na Co-op Translator. Bagama't sinisikap naming maging tumpak, mangyaring tandaan na ang mga awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa kanyang katutubong wika ang dapat ituring na opisyal na pinagmulan. Para sa mahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang hindi pagkakaunawaan o maling interpretasyon na dulot ng paggamit ng pagsasaling ito.