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. Se o seu site estiver associado a um projeto existente, você pode adicionar o código-fonte a esse repositório do projeto, em uma pasta de /docs
no branch padrão ou em um branch diferente. Por exemplo, se você estiver criando um site para publicar a documentação de um projeto que já está em GitHub Enterprise Server, você deverá armazenar o código-fonte para o site no mesmo repositório do projeto.
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
. Para obter mais informações, consulte "Sobre GitHub Pages". - Escolha uma visibilidade do repositório. Para obter mais informações, consulte "Sobre a visibilidade do repositório."
- Selecione Initialize this repository with a README (Inicializar este repositório com um LEIAME).
- Clique 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 tiver ativado páginas públicas, GitHub Pages sites estão disponíveis publicamente na internet, Mesmo que o repositório para o site seja privado ou interno. Se tiver dados confidenciais no repositório do seu site, poderá remover os dados antes de publicar. Para mais informações, consulteConfigurando GitHub Pages para a sua empresa" e "Sobre a visibilidade do repositório."
-
Em GitHub Enterprise Server, acesse o repositório do seu site.
-
If you're creating a project site, decide which publishing source you want to use. If you're creating a user or organization site, you must store your site's source code on the
master
branch. For more information, see "About 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 para o seu site de projeto for o branch gh-pages
, e você criar um novo arquivo chamado /about/contact-us.md
no branch gh-pages
, o arquivo estará 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 mais informações consulte "Adicionar um tema ao site de 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".