Improve this page

Front Matter

O front matter é onde o jekyll começa a ficar realmente legal. Qualquer arquivo contendo um bloco YAML front matter vai ser processado pelo jekyll como um arquivo especial. O front matter deve ser a primeira coisa no arquivo e deve assumir a forma de YAML válido colocado entre as linhas tracejadas. Aqui esta um exemplo básico.

---
layout: post
title: Blogging Like a Hacker
---

Entre essas linhas tracejadas, você pode colocar variáveis predefinidas(veja abaixo para uma referencia) ou mesmo criar uma própria. Estas variáveis vão em seguida estar disponiveis para o acesso usando as tags do Liguid tanto mais para baixo no arquivo e também em qualquer layouts ou includes que a página ou o post em questão invoca.

UTF-8 Codificação de caracteres de aviso

Se você usar codificação UTF-8, certifique-se de que não existem caracteresBOM no cabeçalho de seus arquivos ou coisas muito, muito ruins vão acontecer no jekyll. Isto é especialmente relevante se você estiver rodando Jekyll no Windows.

ProTip™: Variáveis são opcionais no Front Matter

Se você deseja usar tags Liquid e variáveis mas não precisa de nada no seu front matter, só deixe vázio! O conjunto de linhas tracejadas sem conteúdo entre elas ainda terá o Jekyll para processar o arquivo. (Isto é muito util para coisas como CSS e feeds RSS!)

Variáveis globais predefinidas

Existe um número de variáveis globais predefinidas que você pode colocar no seu front matter de um página ou de um post.

Variável	Descrição
`layout`	Se definido, especifica o layout do arquivo para usar. Use o nome do layout do arquivo sem sua extenção. Layout de arquivos devem ser colocados no diretório `_layouts`.
`permalink`	Se você precisa que sua URL do post seja diferente do padrão de todo site (`/year/month/day/title.html`), então você pode definir uma variável e vai ser usado como URL final.
`published`	Defina como false se você não quer que um post especifico seja gerado.
`category` `categories`	Ao invés de colocar post dentro de pastas, você pode especificar uma ou mais categorias que o post pertence. Quando o site é gerado o post vai agir como se tivesse sido definido com essas categorias normalmente. Categories (chave plural) pode ser especificado com uma lista YAML ou uma String separada por virgula.
`tags`	Similar a categories, uma ou multiplas tags podem ser adicionadas a um post, também como categories, tags podem ser especificadas como uma lista YAML ou uma String separada por virgula.

Variáveis personalizadas.

Qualquer variavel no front matter que não é predefinida é misturada nos dados que esta sendo enviado para o Liguid templating engine durante a conversação. Por exemplo, se você definir um titulo, você pode usa-lo em seu layout para definir o titulo da página:

<!DOCTYPE HTML>
<html>
  <head>
    <title>{{ page.title }}</title>
  </head>
  <body>
    ...

Variáveis predefinidas para posts

Estas informações estão disponiveis para ser usada no front matter de um post

Variável	Descrição
`date`	A data aqui substitui a data do nome do post. Isto pode ser usado para garantir a ordenação correta dos posts. A data é especificada no formato `YYYY-MM-DD HH:MM:SS +/-TTTT`; horas, minutos, secundos, e deslocamento de fuso horário são opcionais.

ProTip™: Não se repita

Se você não quer repetir as suas variáveis do front matter usados com freqüência de novo e de novo, basta definir padrões para eles e só substitui-los sempre que necessário (ou não em todos). Isso funciona para as variáveis predefinidos e personalizados.

Back