Skip to content

Commit

Permalink
Translated 06-github-setting-up-account (#38)
Browse files Browse the repository at this point in the history
* Translated 06-github-setting-up-account

Co-authored-by: Cupnodes <[email protected]>
Co-authored-by: Carlos Schults <[email protected]>
Co-authored-by: Jean-Noël Avila <[email protected]>
  • Loading branch information
4 people authored Sep 5, 2020
1 parent a2a5f79 commit 40035f5
Show file tree
Hide file tree
Showing 3 changed files with 481 additions and 475 deletions.
12 changes: 9 additions & 3 deletions Gemfile
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,17 @@ gem 'asciidoctor', '1.5.6.2'
gem 'json'
gem 'awesome_print'

gem 'asciidoctor-epub3', '~> 1.5.0.alpha.9'
gem 'asciidoctor-pdf', '~> 1.5.0.beta.8'
gem 'ttfunk', '1.5.1'
gem 'asciidoctor-epub3', '1.5.0.alpha.9'
gem 'asciidoctor-pdf', '1.5.0.alpha.16'
gem 'asciidoctor-pdf-cjk', '~> 0.1.3'
gem 'asciidoctor-pdf-cjk-kai_gen_gothic', '~> 0.1.1'

gem 'coderay'
gem 'pygments.rb'
gem 'thread_safe'
gem 'epubcheck'
gem 'epubcheck-ruby'
gem 'kindlegen'

gem 'octokit'
gem 'github_changelog_generator', github: 'Furtif/github-changelog-generator'
110 changes: 55 additions & 55 deletions book/06-github/sections/1-setting-up-account.asc
Original file line number Diff line number Diff line change
@@ -1,97 +1,97 @@
=== Account Setup and Configuration
=== Configurando uma conta

(((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.
A primeira coisa que você precisa fazer é configurar uma conta gratuita de usuário.
Simplesmente visite https://github.com[], escolha um nome de usuário que esteja disponível, forneça uma conta de email e uma senha, então clique no grande botão verde "Sign up for GitHub"

.The GitHub sign-up form
image::images/signup.png[The GitHub sign-up form]
.O formulário de Sign-in do 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).
A próxima coisa que você verá é a página de preços para planos melhores, mas pode ignorar isso por enquanto.
O GitHub vai te enviar um email para verificar o email que você forneceu.
Vá em frente e verifique, é muito importante (como veremos mais tarde).

[NOTE]
====
GitHub provides almost all of its functionality with free accounts, except some advanced features.
GitHub's paid plans include advanced tools and features as well as increased limits for free services, but we won't be covering those in this book.
To get more information about available plans and their comparison, visit https://github.com/pricing[].
O GitHub oferece quase todas as suas funcionalidades com contas gratuitas, exceto algumas funções avançadas.
Os planos pagos do GitHub incluem ferramentas e funcionalidades avançadas, bem como limites maiores para serviços gratuitos, mas nós não vamos abordá-los neste livro.
====

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.
Clicando na logo do Octocat no canto superior esquerdo da tela você vai para a página de dashboard.
Você está pronto para usar o GitHub.

==== SSH Access
==== Acesso 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.

If you'd like to use SSH remotes, you'll need to configure a public key.
If you don't already have one, see <<ch04-git-server#r_generate_ssh_key>>.
Open up your account settings using the link at the top-right of the window:
A partir de agora, você é completamente capaz de se conectar aos repositórios GitHub usando o protocolo `https://`, autenticando com o nome de usuário e senha que você forneceu.
Entretanto, para simplesmente clonar repositórios públicos, você não precisa nem mesmo estar logado - a conta que criamos vem à tona quando fazemos fork nos nossos projetos e dermos push em nossos forks mais para frente.

.The ``Account settings'' link
image::images/account-settings.png[The ``Account settings'' link]
Se você quiser usar repositórios remotos via SSH, você precisa configurar uma chave pública.
Se você ainda não tiver uma, veja <<ch04-git-server#r_generate_ssh_key>>.
Abra as configurações da sua conta usando o link no canto superior direito da janela:

Then select the ``SSH keys'' section along the left-hand side.
.Link para ``Account settings''.
image::images/account-settings.png[The ``Account settings'' link.]

.The ``SSH keys'' link
image::images/ssh-keys.png[The ``SSH keys'' link]
Então selecione a seção "´SSH keys´´" no lado esquerdo.

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''.
.Link para ``SSH keys''.
image::images/ssh-keys.png[The ``SSH keys'' link.]

A partir daí, clique no botão "`Add an SSH key`", dê um nome para a chave, copie o conteúdo do seu `~/.ssh/id_rsa.pub` (ou qualquer que seja o nome) arquivo de chave pública no text area e clique ``Add key''.

[NOTE]
====
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.
Certifique-se de colocar um nome que possa lembrar para sua chave SSH.
Você pode nomear cada uma das suas chaves (e.g. "Meu laptop" or "Conta atual") então se você precisar fazer revoke de uma chave você pode facilmente dizer qual você está procurando.
====

[[r_personal_avatar]]
==== Your Avatar
==== Seu 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''.
A seguir, caso queira, você pode substituir o avatar que é gerado para você com uma imagem de sua escolha. Primeiro vá para a aba ``Profile'' (acima da aba SSH Keys) e clique em ``Upload new picture''.

.The ``Profile'' link
image::images/your-profile.png[The ``Profile'' link]
.Link para ``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.
Nós vamos escolher uma cópia da logo do Git que está no nosso disco rígido e então podemos recortá-lo.

.Crop your avatar
image::images/avatar-crop.png[Crop your uploaded avatar]
.Recorte seu 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.
Agora sempre que você interagir no site, as pessoas verão seu avatar próximo do seu nome.

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.
Se de repente você tiver carregado um avatar para um serviço Gravatar (geralmente usado para contas Wordpress), este avatar será usado por padrão e você não precisa seguir este passo.

==== Your Email Addresses
==== Seus endereços de email

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.
A maneira que o GitHub mapeia seus commits do Git para seu usuário é pelo endereço de email.
Se você utiliza múltiplos endereços de email nos seus commits e deseja que o GitHub os conecte adequadamente, você precisa adicionar todos os endereços de email que você usou na seção Email da seção admin.

[[r_add_email_addresses]]
.Add email addresses
image::images/email-settings.png[Add all your email addresses]
.Adicionar endereços de email
image::images/email-settings.png[Add all your email addresses.]

In <<r_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.
Em <<r_add_email_addresses>> podemos ver alguns dos diferentes estados possíveis.
O endereço no topo é verificado e definido como endereço padrão, o que significa que é onde você vai receber quaisquer notificações e convites.
O segundo endereço é verificado e então pode ser definido como endereço padrão caso você queira trocá-los.
O último endereço não é verficado, o que significa que você não pode torná-lo seu endereço padrão.
Caso GitHub encontre qualquer um desses endereços em mensagens commit em qualquer repositório no site ele será linkado para seu usuário.

==== Two Factor Authentication
==== Autenticação de Dois Fatores

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.
Finalmente, para uma segurança extra, você realmente deveria usar uma Autenticação de Dois Fatores ou ``2FA''.
Autenticação de Dois Fatores é um mecanismo de autenticação que está se tornando cada vez mais popular para reduzir o risco de sua conta ser compromissada caso sua senha seja roubada.
Utilizando esse método, o GitHub vai pedir dois métodos diferentes de autenticação, então se um deles for compromissado um invasor não terá acesso total a sua conta.

You can find the Two-factor Authentication setup under the Security tab of your Account settings.
Você pode encontrar o Two-factor Authentication setup abaixo da Security tab do seu Account settings.

.2FA in the Security Tab
.2FA na Security Tab
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.
Se você clicar no botão ``Set up two-factor authentication'', será levado para uma página de autenticação onde você pode escolher usar um aplicativo de celular para gerar um código secundário (uma ``senha única baseada no tempo'') ou mandar o GitHub enviar um código via SMS toda vez que você faz login.

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.
Depois que escolher qual método você prefere e seguir as instruções para configurar um 2FA, sua conta ficará um pouco mais segura e você terá que fornecer um código além de sua senha sempre que você fizer login no GitHub.
Loading

0 comments on commit 40035f5

Please sign in to comment.