Skip to main content

Adicionar conteúdo ao site do GitHub Pages usando o Jekyll

É possível adicionar uma nova página ou postagem ao site do Jekyll no GitHub Pages.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para obter mais informações, confira "produtos de GitHub".

Pessoas com permissões de gravação para um repositório podem adicionar conteúdo a um site do GitHub Pages usando o Jekyll.

Sobre conteúdo em sites do Jekyll

Para poder adicionar conteúdo a um site do Jekyll no GitHub Pages, você precisa criar o site do Jekyll. Para obter mais informações, confira "Como criar um site do GitHub Pages com o Jekyll".

Os principais tipos de conteúdo para sites do Jekyll são páginas e postagens. As páginas se destinam a conteúdo autônomo que não está associado a uma data específica, como uma página "Sobre". O site padrão do Jekyll contém um arquivo chamado about.md, que é renderizado como uma página no seu site em YOUR-SITE-URL/about. Você pode editar o conteúdo desse arquivo para personalizar a página "Sobre" e usá-la como um modelo para criar novas páginas. Para obter mais informações, confira "Páginas" na documentação do Jekyll.

As postagens são uma postagem de blog. O site padrão do Jekyll contém um diretório chamado _posts que contém um arquivo de postagem padrão. Você pode editar o conteúdo dessa postagem e usá-la como modelo para criar novas postagens. Para obter mais informações, confira "Postagens" na documentação do Jekyll.

O tema engloba layouts, inclusões e folhas de estilo padrão que serão aplicados automaticamente a novas páginas e postagens no site, mas é possível substituir qualquer um desses padrões. Para obter mais informações, confira "Sobre o GitHub Pages e o Jekyll".

Para definir variáveis e metadados, como um título e layout, para uma página ou publicação no seu site, você pode adicionar a página inicial YAML na parte superior de qualquer arquivo Markdown ou HTML. Para obter mais informações, confira "Front Matter" na documentação do Jekyll.

Se você estiver publicando de um branch, as alterações no seu site serão publicadas automaticamente quando forem mescladas na fonte de publicação do seu site. Se você estiver publicando de um fluxo de trabalho personalizado de GitHub Actions, as alterações serão publicadas sempre que seu fluxo de trabalho for disparado (normalmente por um push para o branch padrão). Se você desejar pré-visualizar suas alterações primeiro, você poderá fazer as alterações localmente em vez de fazer em GitHub. Em seguida, teste seu site localmente. Para obter mais informações, confira "Como testar seu site do GitHub Pages localmente com o Jekyll".

Adicionar uma nova página ao site

  1. Em GitHub, acesse o repositório do seu site. 1. Navegue até a fonte de publicação do seu site. Para obter mais informações, confira "Como configurar uma fonte de publicação para o seu site do GitHub Pages."
  2. Na raiz da fonte de publicação, crie um arquivo para sua página chamado PAGE-NAME.md, substituindo PAGE-NAME por um nome de arquivo significativo para a página.
  3. Adicione o frontmatter YAML a seguir ao início do arquivo, substituindo PAGE TITLE pelo título da página e URL-PATH por um caminho desejado para a URL da página. Por exemplo, se a URL base do site for https://octocat.github.io e a URL-PATH for /about/contact/, a página estará localizada em https://octocat.github.io/about/contact.
    layout: page
    title: "PAGE TITLE"
    permalink: /URL-PATH/
  4. Abaixo da página inicial, adicione conteúdo para a página.
  5. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Como criar um commit com vários coautores". Mensagem de commit para a alteração
  6. Se você tiver mais de um endereço de email associado à sua conta do GitHub.com, clique no menu suspenso do endereço de email e selecione o endereço de email a ser usado como o endereço de email do autor do Git. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você habilitou a privacidade do endereço de email, <username>@users.noreply.github.com é o endereço de email do autor de commit padrão. Para obter mais informações, confira "Como definir seu endereço de email de commit". Escolher endereços de email de commit 1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, confira "Como criar uma solicitação de pull". Opções de commit no branch 1. Clique em Propor alteração de arquivo. Botão Propor alteração de arquivo 1. Crie um pull request para suas alterações propostas.
  7. Na lista de "Pull Requests", clique no pull request que você deseja mesclar. 1. Clique em Mesclar solicitação de pull. Para obter mais informações, confira "Como mesclar uma solicitação de pull". 1. Se solicitado, digite uma mensagem de commit ou aceite a mensagem padrão. Campo Mensagem do commit 1. Clique em Confirmar mesclagem. 1. Opcionalmente, exclua o branch. Para obter mais informações, confira "Como criar e excluir branches no seu repositório".

Adicionar uma nova postagem ao site

  1. Em GitHub, acesse o repositório do seu site. 1. Navegue até a fonte de publicação do seu site. Para obter mais informações, confira "Como configurar uma fonte de publicação para o seu site do GitHub Pages."
  2. Navegue até o diretório _posts.
  3. Crie um arquivo chamado YYYY-MM-DD-NAME-OF-POST.md, substituindo YYYY-MM-DD pela data da postagem e NAME-OF-POST pelo nome da postagem.
  4. Adicione o frontmatter YAML a seguir ao início do arquivo, substituindo POST TITLE pelo título da postagem, YYYY-MM-DD hh:mm:ss -0000 pela data e pela hora da postagem e CATEGORY-1 e CATEGORY-2 pela quantidade de categorias que deseja fornecer para a postagem.
    layout: post
    title: "POST TITLE"
    date: YYYY-MM-DD hh:mm:ss -0000
    categories: CATEGORY-1 CATEGORY-2
  5. Abaixo da página inicial, adicione conteúdo para a postagem.
  6. No final da página, digite uma mensagem de commit curta e significativa que descreva a alteração feita no arquivo. Você pode atribuir o commit a mais de um autor na mensagem de commit. Para obter mais informações, confira "Como criar um commit com vários coautores". Mensagem de commit para a alteração
  7. Se você tiver mais de um endereço de email associado à sua conta do GitHub.com, clique no menu suspenso do endereço de email e selecione o endereço de email a ser usado como o endereço de email do autor do Git. Apenas endereços de e-mail verificados aparecem neste menu suspenso. Se você habilitou a privacidade do endereço de email, <username>@users.noreply.github.com é o endereço de email do autor de commit padrão. Para obter mais informações, confira "Como definir seu endereço de email de commit". Escolher endereços de email de commit 1. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. Se seu branch atual for o branch-padrão, você deverá optar por criar um novo branch para seu commit e, em seguida, criar um pull request. Para obter mais informações, confira "Como criar uma solicitação de pull". Opções de commit no branch 1. Clique em Propor alteração de arquivo. Botão Propor alteração de arquivo 1. Crie um pull request para suas alterações propostas.
  8. Na lista de "Pull Requests", clique no pull request que você deseja mesclar. 1. Clique em Mesclar solicitação de pull. Para obter mais informações, confira "Como mesclar uma solicitação de pull". 1. Se solicitado, digite uma mensagem de commit ou aceite a mensagem padrão. Campo Mensagem do commit 1. Clique em Confirmar mesclagem. 1. Opcionalmente, exclua o branch. Para obter mais informações, confira "Como criar e excluir branches no seu repositório".

Seu post já deve estar no seu site! Se a URL base do site for https://octocat.github.io, a nova postagem estará localizada em https://octocat.github.io/YYYY/MM/DD/TITLE.html.

Próximas etapas

É possível adicionar um tema do Jekyll ao site do GitHub Pages para personalizar a aparência do seu site. Para obter mais informações, confira "Como adicionar um tema ao seu site do GitHub Pages usando o Jekyll".