Criar um repositório para seu site
Se o seu site for um projeto independente, você pode criar um novo repositório para armazenar o código-fonte do seu site. If your site is associated with an existing project, you can add the source code for your site to a gh-pages
branch or a docs
folder on the master
branch in that project's repository. For example, if you're creating a site to publish documentation for a project that's already on GitHub Enterprise Server, you may want to store the source code for the site in the same repository as the project.
Se você deseja criar um site em um repositório existente, pule para a seção "Criar o seu site.
- No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório.
- Use o menu suspenso Proprietário e selecione a conta que você deseja que seja proprietária do repositório.
- Digite um nome para o repositório e uma descrição opcional. Se você estiver criando um site de usuário ou organização, o seu repositório deve ser denominado
<user>.github.io
ou<organization>.github.io
. If your user or organization name contains uppercase letters, you must lowercase the letters. Para obter mais informações, consulte "Sobre GitHub Pages". - Escolha uma visibilidade do repositório. Para obter mais informações, consulte "Sobre repositórios".
- Selecione Initialize this repository with a README (Inicializar este repositório com um README).
- Clique em Create Repository (Criar repositório).
Criar seu site
Antes de criar seu site, você deve ter um repositório para seu site no GitHub Enterprise Server. Se você não estiver criando o site em um repositório existente, consulte "Criar um repositório para o site".
Aviso: Se o administrador do site habilitou as páginas públicas, os sites de GitHub Pages estarão disponíveis publicamente na internetmwsmo que o repositório para o site seja privado ou interno. Se você tiver dados confidenciais no repositório do seu site, você deverá remover os dados antes de publicá-los. For more information, see "Configuring GitHub Pages for your enterprise" and "About repositories."
-
Em GitHub Enterprise Server, acesse o repositório do seu site.
-
se você está criando um site de projeto, decida qual fonte de publicação você deseja usar. Se você estiver criando um site de usuário ou organização, você deverá armazenar o código-fonte do seu site no branch
mestre
. Para obter mais informações, consulte "Sobre GitHub Pages." -
Se a fonte de publicação que você escolheu já existe, navegue até ela. Caso contrário, crie a fonte de publicação.
-
Na raiz da fonte de publicação, crie um novo arquivo chamado
index.md
com o conteúdo que você deseja exibir na página principal do seu site. -
Configure a sua fonte de publicação. Para obter mais informações, consulte "Configurar uma fonte de publicação para seu site do GitHub Pages".
-
No nome do seu repositório, clique em Configurações.
-
Para ver seu site publicado, em "GitHub Pages", clique na URL do seu site.
Observação: podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no GitHub Enterprise Server. Se você não vir suas alterações no navegador após uma hora, consulte "Sobre erros de criação do Jekyll para sites de GitHub Pages".
Observação: Se os arquivos de origem de do site estão localizados na fonte de publicação padrão —mestre
para sites de usuário e organização ou gh-pages
para sites de projeto — mas seu site não fez a publicação automaticamente, certifique-se de que alguém com permissões de administrador e um endereço de e-mail verificado tenha feito push para a fonte de publicação.
Próximas etapas
Você pode adicionar mais páginas ao seu site criando novos arquivos. Cada arquivo ficará disponível no site na mesma estrutura de diretórios que a fonte de publicação. Por exemplo, se a fonte de publicação do site de projeto for o branch gh-pages
e você criar um arquivo chamado /about/contact-us.md
no branch gh-pages
, o arquivo novo ficará disponível em http(s)://<hostname>/pages/<username>/<repository>/about/contact-us.html
.
Também é possível adicionar um tema para personalizar a aparência do site. Para obter mais informações, consulte "Adicionar um tema ao site do GitHub Pages usando o Jekyll".
Para personalizar seu site ainda mais, você pode usar o Jekyll, um gerador de site estático com suporte integrado para o GitHub Pages. Para obter mais informações, consulte "Sobre o GitHub Pages e o JJekyll".