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

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, consulte "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, consulte "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, consulte "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, consulte "Sobre o GitHub Pages e o Jekyll".

To set variables and metadata, such as a title and layout, for a page or post on your site, you can add YAML front matter to the top of any Markdown or HTML file. For more information, see "Front Matter" in the Jekyll documentation.

Changes to your site are published automatically when the changes are merged into your site's publishing source. If you want to preview your changes first, you can make the changes locally instead of on GitHub Enterprise. Then, test your site locally. Para obter mais informações, consulte "Testar seu site do GitHub Pages localmente com o Jekyll".

Adicionar uma nova página ao site

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. Para obter mais informações sobre fontes de publicação, consulte "Sobre o GitHub Pages".

3. Na raiz da fonte de publicação, crie um novo arquivo para a página chamado PAGE-NAME.md, substituindo PAGE-NAME por um nome de arquivo significativo.

4. Adicione a página inicial YAML a seguir ao topo do arquivo, substituindo PAGE TITLE pelo título da página e URL-PATH por um caminho para a URL da página. Por exemplo, se a URL base do site for https://octocat.github.io e 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/

5. Abaixo da página inicial, adicione conteúdo para a página.

6. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

7. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

8. Clique em Propose file change (Propor alteração no arquivo).

   

Adicionar uma nova postagem ao site

1. On GitHub Enterprise, navigate to your site's repository.

2. Navigate to the publishing source for your site. Para obter mais informações sobre fontes de publicação, consulte "Sobre o GitHub Pages".

3. Navegue até o diretório _posts.

4. Crie um novo arquivo chamado YYYY-MM-DD-NAME-OF-POST.md, substituindo YYY-MM-DD pela data da postagem e NAME-OF-POST pelo nome dela.

5. Adicione a página inicial YAML a seguir ao topo do arquivo, substituindo POST TITLE pelo título da postagem, YYYY-MM-DD hh:mm:ss -0000 pela data e hora da postagem e CATEGORY-1 e CATEGORY-2 por quantas categorias que você quiser que a postagem tenha.

   layout: page
   title: "POST TITLE"
   date: YYYY-MM-DD hh:mm:ss -0000
   categories: CATEGORY-1 CATEGORY-2

6. Abaixo da página inicial, adicione conteúdo para a postagem.

7. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

   

8. Abaixo dos campos de mensagem do commit, opte por adicionar o commit ao branch atual ou a um novo branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. For more information, see "Creating a new pull request."

   

9. Clique em Propose file change (Propor alteração no arquivo).

   

Próximas etapas

You can add a Jekyll theme to your GitHub Pages site to customize the look and feel of your site. Para obter mais informações, consulte "Adicionar um tema ao site do GitHub Pages usando o Jekyll".