# Início Rápido para Páginas do GitHub

Você pode usar GitHub Pages para mostrar código aberto projetos, hospedar um blog ou até mesmo compartilhar seu currículo. Este guia ajudará você a começar a criar o seu próximo site.

## Introdução

Neste guia, você criará um site de usuário em `<username>.github.io`.

## Criando seu site

1. No canto superior direito de qualquer página, selecione <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="Create something new" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg> e clique em **Novo repositório**.

   ![Captura de tela de um menu suspenso GitHub mostrando as opções para criar novos itens. Há um item de menu "Novo repositório" com o contorno em laranja escuro.](/assets/images/help/repository/repo-create-global-nav-update.png)
2. Insira `username.github.io` como o nome do repositório. Substitua `username` pelo seu nome de usuário GitHub. Por exemplo, se o nome de usuário for `octocat`, o nome do repositório deverá ser `octocat.github.io`.

![Captura de tela das configurações do GitHub Pages em um repositório. O campo nome do repositório contém o texto "octocat.github.io" e é descrito em laranja escuro.](/assets/images/help/pages/create-repository-name-pages.png)

1. Escolha uma visibilidade do repositório. Para saber mais, confira [Sobre repositórios](/pt/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility).
2. Alternar **Adicionar LEIAME** para **Ativado**.
3. Clique em **Criar repositório**.
4. No nome do repositório, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> Settings**. Caso não consiga ver a guia "Configurações", selecione o menu suspenso **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** , clique em **Configurações**.

   ![Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.](/assets/images/help/repository/repo-actions-settings.png)
5. Na seção "Code and automation" da barra lateral, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-browser" aria-label="browser" role="img"><path d="M0 2.75C0 1.784.784 1 1.75 1h12.5c.966 0 1.75.784 1.75 1.75v10.5A1.75 1.75 0 0 1 14.25 15H1.75A1.75 1.75 0 0 1 0 13.25ZM14.5 6h-13v7.25c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25Zm-6-3.5v2h6V2.75a.25.25 0 0 0-.25-.25ZM5 2.5v2h2v-2Zm-3.25 0a.25.25 0 0 0-.25.25V4.5h2v-2Z"></path></svg> Pages**.
6. Em "Build e implantação", em "Fonte", selecione **Fazer implantação de um branch**.
7. Em "Build e implantação", em "Branch", use o menu suspenso do branch e selecione uma fonte de publicação.

![Captura de tela das configurações do Pages em um repositório do GitHub. Há um menu "Nenhum" para e selecionar um branch para uma fonte de publicação com o contorno em laranja escuro.](/assets/images/help/pages/publishing-source-drop-down.png)

1. Opcionalmente, abra o arquivo `README.md` do seu repositório. O arquivo `README.md` é o local em que você escreverá o conteúdo do site. Você pode editar o arquivo ou manter o conteúdo padrão por enquanto.
2. Acesse `username.github.io` para ver seu novo site. Observe que pode levar até 10 minutos para que as alterações no seu site sejam publicadas depois que você enviar as alterações por push para GitHub.

## Alterando o título e a descrição

Por padrão, o título do site é `username.github.io`. Altere o título editando o arquivo `_config.yml` no repositório. Você também pode adicionar uma descrição para o seu site.

1. Clique na guia **Código** do repositório.

2. Na lista de arquivos, verifique se `_config.yml` existe. Se ele não existir, crie um novo arquivo chamado `_config.yml`.

3. Na lista de arquivos, clique em `_config.yml` para abrir o arquivo.

4. Clique <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="The edit icon" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg> para editar o arquivo.

5. O arquivo `_config.yml` já contém uma linha que especifica o tema do site. Adicione uma nova linha com `title:` seguida do título desejado. Adicione uma nova linha com `description:` seguida da descrição desejada. Por exemplo:

   ```yaml
   theme: jekyll-theme-minimal
   title: Octocat's homepage
   description: Bookmark this to keep an eye on my project updates!
   ```

6. Quando finalizar a edição do arquivo, clique em **Confirmar alterações**.

## Próximas Etapas 

Você criou, personalizou e publicou seu primeiro GitHub Pages site com êxito, mas há muito mais para explorar! Aqui estão alguns recursos úteis para executar suas próximas etapas com GitHub Pages:

* [Adicionando conteúdo ao seu site GitHub Pages usando o Jekyll](/pt/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll#about-content-in-jekyll-sites): este guia explica como adicionar páginas ao seu site.

* [Configurando um domínio personalizado para seu site GitHub Pages](/pt/pages/configuring-a-custom-domain-for-your-github-pages-site): Você pode hospedar seu site no GitHubdomínio 's `github.io` ou em seu próprio domínio personalizado.