Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

TL Localization - Chapter 6 (1,139 words) #14

Merged
merged 4 commits into from
Feb 10, 2018
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
28 changes: 14 additions & 14 deletions book/06-github/1-github.asc
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,20 @@
== GitHub

(((GitHub)))
GitHub is the single largest host for Git repositories, and is the central point of collaboration for millions of developers and projects.
A large percentage of all Git repositories are hosted on GitHub, and many open-source projects use it for Git hosting, issue tracking, code review, and other things.
So while it's not a direct part of the Git open source project, there's a good chance that you'll want or need to interact with GitHub at some point while using Git professionally.
Ang GitHub ay ang solong pinakamalaking host para sa mga repositoryo ng Git, at ang pangunahing punto ng pagtutulungan para sa milyun-milyong mga developer at proyekto.
Isang malaking porsiyento ng lahat ng mga repositoryo ng Git ay naka-host sa GitHub, at marami sa mga proyekto na open-source ang gumagamit nito sa pag-host ng Git, pagsusubaybay ng isyu, pagsusuri sa code, at iba pang mga bagay.
Kaya habang hindi ito direktang bahagi ng open-source na proyekto ng Git, may isang magandang pagkakataon na gusto mo o kailangang makipag-ugnayan sa GitHub sa ilang punto habang propesyonal na ginagamit ang Git.

This chapter is about using GitHub effectively.
We'll cover signing up for and managing an account, creating and using Git repositories, common workflows to contribute to projects and to accept contributions to yours, GitHub's programmatic interface and lots of little tips to make your life easier in general.
Ang kabantang ito ay tungkol sa epektibong paggamit ng GitHub.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'kabantang' to 'kabanatang'

Ating tatalakayin ang pag-sign up para sa at pamamahala ng isang account, paglilikha at paggamit ng mga repositoryo ng Git, karaniwang mga workflow upang mag-ambag sa mga proyekto at upang tumanggap ng mga kontribusyon sa iyo, programmatic interface ng GitHub at maraming mga tip upang gawing mas madali ang iyong buhay sa pangkalahatan.

If you are not interested in using GitHub to host your own projects or to collaborate with other projects that are hosted on GitHub, you can safely skip to <<_git_tools#_git_tools>>.
Kung hindi ka interesado sa paggamit ng GitHub upang i-host ang iyong sariling mga proyekto o upang mag-ambag sa ibang mga proyekto na naka-host sa GitHub, maaari mong ligtas na lumaktaw sa <<_git_tools#_git_tools>>.

[WARNING]
.Interfaces Change
[PAALALA]
.Pagbabago sa mga Interface
====
It's important to note that like many active websites, the UI elements in these screenshots are bound to change over time.
Hopefully the general idea of what we're trying to accomplish here will still be there, but if you want more up to date versions of these screens, the online versions of this book may have newer screenshots.
Mahalaga na tandaan na katulad ng maraming aktibong mga website, ang mga elemento ng UI sa mga screenshot na ito ay nakasalalay sa pagbabago sa paglipas ng panahon.
Sana ang pangkalahatang ideya ng kung ano ang sinusubukan naming magawa dito ay mananatili pa rin, ngunit kung gusto mo ng higit pang napapanahong bersyon ng mga screen na ito, ang mga online na bersyon ng aklat na ito ay maaaring magkaroon ng mas bagong mga screenshot.
====

include::sections/1-setting-up-account.asc[]
Expand All @@ -28,8 +28,8 @@ include::sections/4-managing-organization.asc[]

include::sections/5-scripting.asc[]

=== Summary
=== Buod

Now you're a GitHub user.
You know how to create an account, manage an organization, create and push to repositories, contribute to other people's projects and accept contributions from others.
In the next chapter, you'll learn more powerful tools and tips for dealing with complex situations, which will truly make you a Git master.
Isa ka na ngayong GitHub user.
Alam mo kung paano lumikha ng isang account, mamahala ng isang organisasyon, gumawa at mag-push sa mga repositoryo, mag-ambag sa mga proyekto ng ibang tao at tumanggap ng mga kontribusyon mula sa iba.
Sa susunod na kabanata, matututo ka ng mas makapangyarihang mga gamit at mga tip para sa pakikitungo sa mga kumplikadong sitwasyon, kung saan tunay kang gagawin na isang master ng Git.
100 changes: 50 additions & 50 deletions book/06-github/sections/1-setting-up-account.asc
Original file line number Diff line number Diff line change
@@ -1,95 +1,95 @@
=== Account Setup and Configuration
=== Pag-setup at pagsasaayos ng Account

(((GitHub, user accounts)))
The first thing you need to do is set up a free user account.
Simply visit https://github.com[], choose a user name that isn't already taken, provide an email address and a password, and click the big green ``Sign up for GitHub'' button.
Ang unang bagay na kailangan mong gawin ay mag-setup ng isang libreng account ng user.
Bisitahin lamang ang https://github.com[], pumili ng pangalan ng user na hindi pa nakuha, magbigay ng isang email address at password, at i-click ang malaking berdeng pindutan na ``Mag-sign up sa GitHub''.

.The GitHub sign-up form.
.Ang form ng pag-sign-up sa GitHub.
image::images/signup.png[The GitHub sign-up form.]

The next thing you'll see is the pricing page for upgraded plans, but it's safe to ignore this for now.
GitHub will send you an email to verify the address you provided.
Go ahead and do this, it's pretty important (as we'll see later).
Ang susunod na bagay na iyong makikita ay ang pahina ng pagpepresyo para sa naka-upgrade na mga plano, ngunit ito'y ligtas na huwag pansinin ito sa ngayon.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ligtas na balewalain muna sa ngayon.

Magpapadala sa iyo ng email ang GitHub upang mapatunayan ang address na iyong ibinigay.
Sige at gawin ito, ito ay mahalaga (tulad ng makikita natin kinamamayaan).

[NOTE]
[TANDAAN]
====
GitHub provides all of its functionality with free accounts, with the limitation that all of your projects are fully public (everyone has read access).
GitHub's paid plans include a set number of private projects, but we won't be covering those in this book.
Ang GitHub ay nagbibigay ng lahat ng pag-andar nito na may mga libreng account, may limitasyon na ang lahat ng iyong mga proyekto ay ganap na pampubliko (bawat isa ay may access sa pagbasa).
Kasama sa mga bayad na plano ay isang hanay ng bilang ng mga pribadong proyekto, ngunit hindi natin tatalakayin sa librong ito.
====

Clicking the Octocat logo at the top-left of the screen will take you to your dashboard page.
You're now ready to use GitHub.
Pag-clikc sa Ocotocat na logo sa itaas sa kaliwa ng screen ay magdadala sa iyo sa pahina ng iyong dashboard.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pag-clikc changed to Pag-click

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi sir @Robin-Ho, i have updated my PR. thank you for pointing out my typos :)

Handa ka na ngayon gumamit ng GitHub.

==== SSH Access
==== Pag-access sa SSH

(((SSH keys, with GitHub)))
As of right now, you're fully able to connect with Git repositories using the `https://` protocol, authenticating with the username and password you just set up.
However, to simply clone public projects, you don't even need to sign up - the account we just created comes into play when we fork projects and push to our forks a bit later.
Sa ngayon, ikaw ay ganap na makakonekta sa mga repositoryo ng Git gamit ang protocal na `https://`, pinapatunayan ang username at password na iyo lamang na-setup.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

protocal change to protocol

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR has been updated correcting the typo

Gayunpaman, upang i-clone ang mga pampublikong proyekto, hindi mo na kailangan mag-sign up - ang account na ating nalikha ay mahalaga kapag mag-fork tayo ng mga proyekto at mag-push sa atong mga fork kinamamayaan.

If you'd like to use SSH remotes, you'll need to configure a public key.
(If you don't already have one, see <<_git_on_the_server#_generate_ssh_key>>.)
Open up your account settings using the link at the top-right of the window:
Kung gusto mong gumamit ng mga remote na SSH, kinakailangan mong isaayos ang isang publikong key.
(Kung wala ka pa, tingnan ang <<_git_on_the_server#_generate_ssh_key>>.)
Buksan ang settings ng iyong account gamit ang link na nasa itaas na kanan ng window:

.The ``Account settings'' link.
.Ang link ng ``settings ng Account''.
image::images/account-settings.png[The ``Account settings'' link.]

Then select the ``SSH keys'' section along the left-hand side.
Pagkatapos piliin ang seksyon na ``SSH keys'' sa tabi ng kaliwang bahagi.

.The ``SSH keys'' link.
.Ang link ng ``SSH keys''.
image::images/ssh-keys.png[The ``SSH keys'' link.]

From there, click the "`Add an SSH key`" button, give your key a name, paste the contents of your `~/.ssh/id_rsa.pub` (or whatever you named it) public-key file into the text area, and click ``Add key''.
Mula doon, i-click ang pindutan na "`Magdagdag ng isang SSH key`", bigyan ng pangalan ang iyong key, i-paste ang mga nilalaman ng iyong `~/.ssh/id_rsa.pub` (o anuman ang iyong pinangalanan) file na public-key sa text area, at i-click ang ``Magdagdag ng key''.

[NOTE]
[TANDAAN]
====
Be sure to name your SSH key something you can remember.
You can name each of your keys (e.g. "My Laptop" or "Work Account") so that if you need to revoke a key later, you can easily tell which one you're looking for.
Siguraduhin na pangalanan ang iyong SSH key ng isang bagay na maaalala mo.
Maaari mong pangalanan ang bawat key mo (halimbawa "Aking Laptop" o "Account sa Trabaho") upang kung kailangan mong bawiin ang key mamaya, madali mong masabi kung alin ang iyong hinahanap.
====

[[_personal_avatar]]
==== Your Avatar
==== Ang iyong Avatar

Next, if you wish, you can replace the avatar that is generated for you with an image of your choosing.
First go to the ``Profile'' tab (above the SSH Keys tab) and click ``Upload new picture''.
Susunod, kung nais mo, maaari mong palitan ang avatar na ginawa para sa iyo ng isang imahe ng iyong pagpili.
Una, pumunta sa tab na ``Profil'' (sa taas ng tab ng SSH Keys) at i-click ang ``Mag-upload ng bagong larawan''.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Profil


.The ``Profile'' link.
.Ang link ng ``Profile''.
image::images/your-profile.png[The ``Profile'' link.]

We'll choose a copy of the Git logo that is on our hard drive and then we get a chance to crop it.
Pipili tayo ng kopya ng logo ng Git na nasa ating hard drive at pagkatapos ay makakakuha tayo ng pagkakataong i-crop ito.

.Crop your avatar
.I-crop ang iyong avatar
image::images/avatar-crop.png[Crop your uploaded avatar.]

Now anywhere you interact on the site, people will see your avatar next to your username.
Ngayon kahit saan ka makipag-ugnayan sa site, makikita ng mga tao ang iyong avatar kasunod ng iyong username.

If you happen to have uploaded an avatar to the popular Gravatar service (often used for Wordpress accounts), that avatar will be used by default and you don't need to do this step.
Kung mangyari mong na-upload ang isang avatar sa tanyag na serbisyo ng Gravatar (kadalasang ginamit para sa mga account ng Wordpress), ang avatar na iyon ay gagamitin bilang default at di mo kailangang gawin ang hakbang na ito.

==== Your Email Addresses
==== Ang iyong Email Addresses

The way that GitHub maps your Git commits to your user is by email address.
If you use multiple email addresses in your commits and you want GitHub to link them up properly, you need to add all the email addresses you have used to the Emails section of the admin section.
Ang paraan ng pagmapa ng GitHub ng iyong mga commit ng Git sa iyong mga user ay sa pamamagitan ng email address.
Kung gagamit ka ng maramihang mga email address sa iyong commit at gusto mo iugnay nang maayos ang mga ito ng GitHub, kailangan mong idagdag ang lahat ng mga email address na iyong ginamit sa seksyon ng mga Email ng seksyon ng admin.

[[_add_email_addresses]]
.Add email addresses
.Magdagdag ng mga email address
image::images/email-settings.png[Add all your email addresses.]

In <<_add_email_addresses>> we can see some of the different states that are possible.
The top address is verified and set as the primary address, meaning that is where you'll get any notifications and receipts.
The second address is verified and so can be set as the primary if you wish to switch them.
The final address is unverified, meaning that you can't make it your primary address.
If GitHub sees any of these in commit messages in any repository on the site, it will be linked to your user now.
Sa <<_add_email_addresses>> maaari nating makita ang ilan sa iba't-ibang mga estado na posible.
Ang pinakamataas na address ay napatunayan na at itinakda bilang pangunahing address, ibig sabihin na dito mo makukuha ang anumang mga abiso at mga pagtanggap.
Ang pangalawang address ay napatunayan na at kaya maaari ng itakda bilang pangunahin kung nais mong ilipat ang mga ito.
Ang panghuling address ay hindi pa napatunayan, ibig sabihin na hindi mo maaaring gawin itong pangunahing address.
Kung nakikita ng GitHub ang alin man sa mga ito sa mga mensahe ng commit sa alinmang repositoryo sa site, ito ay maiuugnay na ngayon sa iyong user.

==== Two Factor Authentication
==== Dalawang Kadahilanan ng Pagpapatunay

Finally, for extra security, you should definitely set up Two-factor Authentication or ``2FA''.
Two-factor Authentication is an authentication mechanism that is becoming more and more popular recently to mitigate the risk of your account being compromised if your password is stolen somehow.
Turning it on will make GitHub ask you for two different methods of authentication, so that if one of them is compromised, an attacker will not be able to access your account.
Sa wakas, para sa dagdag na seguridad, kailangan mong mag-setup ng Dalawang-Kadahilanan ng Pagpapatunay o ``2FA''.
Ang Dalawang-Kadahilanan ng Pagpapatunay ay isang mekanismo ng pagpapatunay na nagiging mas at mas tanyag kumakailan lamang upang mapigilan ang panganib na makompromiso ang iyong account kung ang iyong password ay nanakaw.
Ang pag-on nito ay maging dahilan ng paghihiling sa iyo ng GitHub para sa dalawang iba't-ibang mga paraan ng pagpapatunay, upang kapag isa sa mga ito ay nakompromiso, hindi maa-access ng attacker ang iyong account.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

umaatake? 🗡


You can find the Two-factor Authentication setup under the Security tab of your Account settings.
Maaari mong mahanap ang setup ng Dalawang-Kadahilanan ng Pagpapatunay sa ilalim ng tab ng Seguridad sa settings ng iyong Account.

.2FA in the Security Tab
.2FA sa Tab ng Seguridad
image::images/2fa-1.png[2FA in the Security Tab]

If you click on the ``Set up two-factor authentication'' button, it will take you to a configuration page where you can choose to use a phone app to generate your secondary code (a ``time based one-time password''), or you can have GitHub send you a code via SMS each time you need to log in.
Kapag i-click mo ang pindutan na ``Mag-setup ng dalawang-kadahilanan ng pagpapatunay'', dadalhin ka nito sa pahina ng pagsasaayos kung saan maaari kang mamili na gumamit ng isang app sa phone upang makabuo ng pangalawangcode (``isang-beses na password'' na nabatay sa oras), o maaari mong hayaan ang GitHub na magpadala sa iyo ng isang code sa pamamagitan ng SMS sa bawat oras na kailangan mong mag-login.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

pangalawangcode change to pangalawang code
please check if this is correct : nabatay

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

changed on new PR updates


After you choose which method you prefer and follow the instructions for setting up 2FA, your account will then be a little more secure and you will have to provide a code in addition to your password whenever you log into GitHub.
Pagkatapos mong pumili kung anong paraan ang mas gusto mo at sundin ang mga instruksiyon sa pag-setup ng 2FA, ang iyong account ay magiging mas ligtas nang kaunti at kinakailangan mong magbigay ng isang code bilang karagdagan sa iyong password sa tuwing ikaw ay mag-login sa GitHub.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i think mga direksiyon or mga pagtuturo would fit for instructions instead of instruksiyon

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hi @severinolorillajr, which will i use?