Tornando-se usuário do GitHub
Este breve manual de usuário invisual para GitHub pressupõe conhecimento básico de Git e prática em navegação estrutural HTML.
Em caso de dúvidas, por favor escreva a Alexandre Magno. Ele buscará responder a você por e-mail particular e possivelmente corrigirá ou aperfeiçoará o manual.
Infelizmente a interface do GitHub é toda em inglês. Sendo assim, preste atenção nas leituras em inglês que são exemplificadas em cada instrução.
Criando a conta
Na primeira tela nós vamos submeter informação que nos identifica.
- Acesse github.com
- O cursor (modo de foco) estará no primeiro campo que nos interessa — "Pick a username", que significa: "Digite um nome de usuário".
- Preencha a informação. Para os videntes, já neste momento, ao digitar, o sistema sinaliza quando um nome de usuário está reservado, em uso por outra pessoa. Não se preocupe com isso. Vamos tentar prosseguir e tentar finalizar o cadastro. Se algo der errado, voltaremos a este passo.
- Pressione
TAB
e o cursor irá para o segundo campo de entrada que nos interessa — "Your e-mail", que quer significar: "Digite seu endereço de e-mail". - Preencha a informação. Mais uma vez trata-se de um campo de identificação, você não poderá usar um endereço de e-mail que já tenha usado para cadastrar outro nome de usuário. Obviamente, você não pode e não deve tentar usar um endereço de e-mail de outra pessoa. O sistema de cadastramento lhe enviará e-mail de confirmação, ao final do processo.
- Pressione
TAB
e o cursor irá para terceiro campo de entrada que nos interessa — "Create a password", que quer significar: "Digite uma senha para sua nova conta GitHub" - Preencha a informação. Use pelo menos uma letra maiúscula e um numeral. A senha deve ter no mínimo 7 caracteres.
- Pressione
TAB
e o cursor repousará em cima do botão de apertar "Sign up for GitHub". Em português, algo como: "Cadastrar-se no GitHub". - Aperte o botão pressionando a tecla
ENTER
.
Se tudo aconteceu como o esperado e não houve erros no preenchimento do formulário, você será levado à segunda tela, para escolha do plano.
- Pressione
t
para navegar até a tabela de planos de assinatura, uma tabela com 6 linhas e 4 colunas. Não se preocupe, o serviço tem um plano gratuito, e é o que vamos escolher. - O plano padrão é gratuito! Por segurança, seria interessante navegar a tabela, conhecendo as opções, e garantir nossa opção por ele. Infezlimente parece que a escolha por outro plano está inacessível. Vamos então pelos menos confirmar se o plano gratuito é o que está selecionado. Tecle
SETA-PARA-BAIXO
sucessivamente, até chegar à linha 6. O leitor de tela deverá ler: "Free ponto $0/month ponto 0 ponto Choosen botão de apertar". Atenção à última palava; deve ser "Choosen" (que singifica "Escolhido"), com "n" no final, e não "Choose" (que significa "Escolher"), sem o "n". - Pressione
TAB
e o cursor irá para uma caixa de seleção não selecionada: "Help me set up an organization next". Matenha desmarcado. Não nos interessa criar ou configurar uma organização agora. Queremos apenas criar um usuário comum, individual. - Pressione
TAB
e o cursor irá para o link "Learn more about organizations" (em português: "Aprender mais sobre organizações"). Não o acesse! Além dele ser em inglês, nesse momento não nos interessa saber sobre organizações de GitHub. - Pressione
TAB
mais um vez em finalmente você estará no botão de apertar "Finish sign up" para "Finalizar o cadastro". PressioneENTER
. - Um tela de início ou de "boas vindas", em inglês, será exibidas no endereço github.com.
Um e-mail de confirmação de cadastro será enviado a você. Na verdade, o sistema do GitHub enviará dois ou três e-mails:
- "[GitHub] Please verify your email address" é o assunto do primeiro e-mail, que é o de confirmação de cadastro propriamente dito. A mensagem HTML tem um botão "Verify email address". Você deve clicá-lo para confirmar o cadastro confirmando (fazendo a verificação para) esse endereço de e-mail.
- "ambdm + GitHub = <3" é o assunto do segundo e-mail, uma mensagem de "boas vindas" dadas pela equipe que faz o GitHub.
- [GitHub] Attention: Your email address needs to be verified." foi um terceiro e-mail de confirmação que eu recebi, provavelmente por tentar acessar github.com sem antes confirmar (fazer a verificação para) o endereço de e-mail a partir da primeira mensagem recebida.
Se algo der errado e o link de confirmação de endereço de e-mail estiver expirado ou inválido, você será levado a github.com/settings/emails. Despreze isso e volte a sua Caixa de Entrada, pois você pode ter recebido uma terceira mensagem (como eu recebi; ver acima).
Uma coisa interessante a se notar é que o primeiro parágrafo (tecle p
para chegar até ele) desta página é exatamente o seguinte:
Your primary GitHub email address will be used for account-related notifications (e.g. account changes and billing receipts) as well as any web-based GitHub operations (e.g. edits and merges).
Ele nos explica, em inglês, que o endereço de e-mail principal de uma conta GitHub recebe notificações de mudanças na conta, cobranças (no caso dos planos pagos), e notificações de atividades em repositórios monitorados (mesclagens, pull requests, respostas a comentários, etc.).
Quando você conseguir confirmar seu endereço de e-mail por clique em link de confirmação recebido por e-mail, você será redirecionado a github.com.
Lembre-se de que, no Firefox, F6
nos permite alterar entre a barra de endereços e corpor da página.
Acessando o próprio perfil
Todo perfil de usuário pode ser acessado por meio de uma URL na forma github.com/NOMEDEUSUARIO
. Mas, para dificultar um pouco e termos a oportunidade de ir aprendendo navegação estrutural invisual de GitHub, vamos ao seu próprio perfil navegando os menus do site. Pressuposto que você já está logado.
- Acesse github.com
- Pressione
TAB
uma vez, para pular para o conteúdo da página — "Skip to content". - Pressione
L
duas vezes, para ir à segunda lista. A primeira lista começa com o link "Pull requests". A segunda lista, com um link que é alguma coisa sobre "notifications" (notificações). Essas listas são menus superiores horizontais. - Pressione
TAB
sucessivamente para ir ao terceiro item da lista (menu). Será o link "View profile and more" — em português: "visualizar perfil e mais". - Pressione
ENTER
e abrir-se-á um submenu vertical flutuante. - Use
SETA-PARA-BAIXO
sucessivamente até encontrar o link "Your profile", que dá acesso ao seu perfil. - Clique o link com
ENTER
e a página de seu perfil será aberta.
Conhecendo um perfil de usuário
- Nome do usuário
- Se você quer rever o nome de usuário do perfil que está aberto, simplesmente tecle
1
, pois o nome será o único cabeçalho de nível 1 nesta página de perfil.
- Se você quer rever o nome de usuário do perfil que está aberto, simplesmente tecle
- Cidade, e-mail e data de inscrição
- Estando no ponto inicial da página, tecle
L
três vezes para ir até a terceira lilsta. Navega-a com as setas verticais e conheça o local da pessoa (se ela declarou), o endereço de e-mail dela (se ela declarou), ou pelo menos a data em que esse usuário cadastrou-se no GItHub.- A informação da data estará em inglês. Algo como "Joined on 21 Jun 2015", que significa: "Entrou em 21 de junho de 2015"
- Estando no ponto inicial da página, tecle
- Seguidores, projetos favoritos e pessoas seguidas
- Todo usuário de GitHub pode seguir outros usuários, favoritar projetos (marcado-os com estrelas), e ser seguido por outros.
- A finalidade de favoritar projetos é apenas ter e compartihar com todos uma lista de projetos que por algum motivo um dia lhe interessaram.
- Pessoas seguem umas às outras para dizer a todos que ambas tem afinidades nessa rede social que é o GitHub, de compartilhamento de projetos de código aberto. E também para serem notificadas (até por e-mail) de algumas das ações de quem elas seguem.
- O perfil do usuário mostra um contador de seguidores, um contador de favoritos, e um contador de pessoas seguidas; nessa ordem. Para acessar esses contadores, percorra toda a lista anterior, aquela que teria cidade, e-mail e data de inscrição, e prossiga apertando
TAB
após a data. Serão 3 links para 3 respectivas páginas de listagem. Cada um está associado a um contador. Nos exemplos de leitura a seguir, um * (asterisco) representa o número do contador. No real, as expressões estão em inglês e sem as áspas.- O primeiro link é o contador de seguidores
- Leitura: "* Followers link ponto * link"
- O segundo link é o contador de projetos favoritos
- Leitura: "* Starred link ponto * link"
- O terceiro link é o contador de usuários seguidos por este usuário que você está conhecendo
- Leitura: "* Following link ponto * link"
- O primeiro link é o contador de seguidores
- Todo usuário de GitHub pode seguir outros usuários, favoritar projetos (marcado-os com estrelas), e ser seguido por outros.
- Para seguir ou não seguir um usuário...
- Chegue aos contadores como ensinado acima e ultrapasse-os com mais um
TAB
- Você estará em cima do botão de apertar que ou chama-se "Follow" (seguir) ou chama-se "Unfollow" (deixar de seguir). Basta apertar
ENTER
para alternar esse valor e com isso seguir ou deixar de seguir o usuário em questão.
- Chegue aos contadores como ensinado acima e ultrapasse-os com mais um
- Você quer bloquear este usuário? Ou denunciá-lo?
- Apenas pressione
TAB
mais uma vez e você estará noutro botão de apertar. Este é um menu. PressioneENTER
- Pressione
TAB
uma vez para chegar ao item de menu para bloquear ou desbloquear o usuário. Se o texto desse botão estiver sendo "Block user", apertá-lo comENTER
bloqueará o usuário. Se o texto desse botão estiver sendo "Unblock user", apertá-lo desbloqueará o usuário. A ação recarrega a página. - Ou...
Se você pressionou
TAB
duas vezes dentro do menu, estará em cima do botão de apertar "Report abuse", que serve para denunciar o usuário ao pessoal do GitHub. Por razões óbvias, não foi possível testarmos esse botão. Descubra sozinho como é a ação dele ou envie a Alexandre Magno um e-mail candidatando-se a ser o usuário cobaia a ser denunciado durante um teste.
- Apenas pressione
Navegar a lista de repositórios de um usuário
Após passar os contadores pressionando TAB
três vezes, passar o botão de seguir pressionando TAB
uma vez, passar o menu de bloqueio ou denúcia pressionando TAB
mais uma vez, e finalmente a aba de página "Contributions" (contribuições), a qual simplesmente está na ordem, prossiga com mais umTAB
até a aba de página "Repositories" (repositórios). Então pressione ENTER
e essa aba de página será aberta.
Na aba de página que você acabou de abrir, nomes de projetos/repositórios estarão como cabeçalhos de nível 3 que também são links. Após cada um deles haverá descrição do projeto (quando configurado pelo dono) e data de criação do projeto abreviada em inglês, ambos como parágrafos que podem ser visitados com a tecla p
.
Buscar repositórios de um usuário
Estando com a aba de página "Repositories" (repositórios) aberta, o campo de busca por repositórios no perfil sendo visitado é o segundo campo de formulário encontrado na página. Quando o conteúdo da página começa a ser explorado por TAB
, esses campos de digitação tem prioridade. A passagem por eles é no modo de foco. Sendo assim, comece ou recomece a navegação da página, pressione TAB
duas vezes, e você estará no campo de busca. Então é só digitar sua chave de busca e apertar ENTER
. Você será levado à página de busca com a listagem dos resultados.