Solucionar problemas de erros de criação do Jekyll para sites do GitHub Pages

Solucionar problemas de erros de criação

Se o Jekyll encontrar um erro ao criar seu site do GitHub Pages localmente ou no GitHub Enterprise, você poderá usar mensagens de erro para solucionar problemas. Para obter mais informações sobre mensagens de erro e como visualizá-las, consulte "Sobre erros de criação do Jekyll para sites do GitHub Pages".

Se você recebeu uma mensagem de erro genérica, verifique os problemas comuns.

• Você está usando plugins incompatíveis. Para obter mais informações, consulte "Sobre o GitHub Pages e o Jekyll".
• Você alterou a configuração source no arquivo _config.yml. GitHub Pages substitui essa configuração durante o processo de criação.
• Um nome de arquivo na fonte de publicação contém dois pontos (:), o que não é permitido.

Se você recebeu uma mensagem de erro específica, revise abaixo as informações de solução de problemas relativas à mensagem de erro.

Depois que tiver corrigido os possíveis erros, faça push das alterações para a fonte de publicação do seu site para ativar outra criação no GitHub Enterprise.

Erro no arquivo de configuração

Este erro significa que ocorreu falha na criação do seu site porque o arquivo _config.yml contém erros de sintaxe.

Para solucionar problemas, verifique se o arquivo _config.yml segue estas regras:

• Use spaces instead of tabs.
• Include a space after the : for each key value pair, like timezone: Africa/Nairobi.
• Use only UTF-8 characters.
• Quote any special characters, such as :, like title: "my awesome site: an adventure in parse errors".
• For multi-line values, use | to create newlines and > to ignore newlines.

To identify any errors, you can copy and paste the contents of your YAML file into a YAML linter, such as YAML Validator.

Esta é uma data/hora inválida

Este erro significa que uma das páginas do seu site inclui uma data/hora inválida.

Para solucionar problemas, pesquise o arquivo na mensagem de erro e os layouts do arquivo para as exigências de qualquer filtro de data do Liquid. Verifique se alguma variável passada em filtros de data do Liquid tem valores em todos os casos e nunca passa nil ou "". Para obter mais informações, consulte "Filtros do Liquid" na documentação do Liquid.

O arquivo não existe no diretório includes

Este erro significa que o código faz referência a um arquivo que não existe no diretório _includes.

To troubleshoot, search the file in the error message for include to see where you've referenced other files, such as {% include example_header.html %}. Se algum dos arquivos a que você fez referência não estiver no diretório _includes, copie ou mova os arquivos para o diretório _includes.

O arquivo é um link simbólico

Este erro significa que o código faz referência a um arquivo com link simbólico que não existe na fonte de publicação do seu site.

To troubleshoot, search the file in the error message for include to see where you've referenced other files, such as {% include example_header.html %}. Se algum dos arquivos a que você fez referência for com link simbólico, copie ou mova os arquivos para o diretório _includes.

Arquivo codificado por UTF-8 incorretamente

Este erro significa que você usou caracteres não latinos, como 日本語, sem avisar ao computador que esperava esses símbolos.

Para solucionar problemas, force a codificação UTF-8 adicionando a seguinte linha ao arquivo _config.yml:

encoding: UTF-8

Linguagem inválida do realçador

Este erro significa que você especificou algum realçador de sintaxe diferente de Rouge ou Pygments no arquivo de configuração.

Para solucionar problemas, atualize o arquivo _config.yml para especificar Rouge ou Pigmentos. Para obter mais informações, consulte "Sobre o GitHub Enterprise e o Jekyll".

Data de postagem inválida

Este erro significa que uma postagem no seu site contém uma data inválida no nome de arquivo ou na página inicial YAML.

Para solucionar problemas, verifique se todas as datas estão no formato YYYY-MM-DD HH:MM:SS para UTC e se são datas reais do calendário. Para especificar um fuso horário com um intervalo de tempo UTC, use o formato YYYY-MM-DD HH:MM:SS +/-TTTT (ano-mês-dia horas:minutos:segundos +/-TTTT), como 2014-04-18 11:30:00 +0800.

Se você especificar um formato de data no arquivo _config.yml, verifique se o formato está correto.

Sass ou SCSS inválido

Este erro significa que seu repositório contém um arquivo Sass ou SCSS com conteúdo inválido.

Para solucionar problemas, revise o número de linha incluído na mensagem de erro referente a Sass ou SCSS inválido. Para ajudar a prevenir erros no futuro, instale um linter Sass ou SCSS para seu editor de texto favorito.

Submódulo inválido

Este erro significa que seu repositório inclui um submódulo que não foi inicializado corretamente.

To troubleshoot, first decide if you actually want to use a submodule, which is a Git project inside a Git project; submodules are sometimes created accidentally.

If you don't want to use a submodule, remove the submodule, replacing PATH-TO-SUBMODULE with the path to the submodule:

$ git submodule deinit PATH-TO-SUBMODULE
$ git rm PATH-TO-SUBMODULE
$ git commit -m "Remove submodule"
$ rm -rf .git/modules/PATH-TO-SUBMODULE

Caso queira utilizar o submódulo, lembre-se de usar https:// quando fizer referência ao submódulo (a não http://) e de que o submódulo está em um repositório público.

YAML inválido no arquivo de dados

Este erro significa que um ou mais arquivos na pasta _data contém YAML inválido.

Para solucionar problemas, verifique se os arquivos YAML na pasta _data seguem estas regras:

• Use spaces instead of tabs.
• Include a space after the : for each key value pair, like timezone: Africa/Nairobi.
• Use only UTF-8 characters.
• Quote any special characters, such as :, like title: "my awesome site: an adventure in parse errors".
• For multi-line values, use | to create newlines and > to ignore newlines.

To identify any errors, you can copy and paste the contents of your YAML file into a YAML linter, such as YAML Validator.

Para obter mais informações sobre arquivos de dados do Jekyll, consulte ""Arquivos de dados" na documentação do Jekyll.

Erros de markdown

Este erro significa que seu repositório contém erros de markdown.

Para solucionar problemas, verifique se você está usando um processador markdown compatível. Para obter mais informações, consulte "Definir um processador markdown para seu site do GitHub Pages usando o Jekyll".

Em seguida, verifique se o arquivo na mensagem de erro usa uma sintaxe markdown válida. Para obter mais informações, consulte "Markdown: sintaxe" no Daring Fireball.

Pasta docs ausente

Este erro significa que você escolheu a pasta docs como fonte de publicação, mas não existe nenhuma pasta docs na raiz do seu repositório no branch master.

Para solucionar problemas, caso a pasta /docs tenha sido movida acidentalmente, tente mover a pasta /docs de volta para a raiz do seu repositório no branch master. Se a pasta docs tiver sido excluída acidentalmente, siga um destes procedimentos:

• Use o Git para reverter ou desfazer a exclusão. Para obter mais informações, consulte "git-revert" na documentação do Git.
• Crie uma nova pasta docs na raiz do seu repositório no branch master e adicione os arquivos de origem do seu site à pasta. Para obter mais informações, consulte "Criar arquivos".
• Altere a fonte de publicação. Para obter mais informações, consulte "Configurar uma fonte de publicação do GitHub Pages".

Submódulo ausente

Este erro significa que seu repositório inclui um submódulo que não existe ou não foi inicializado corretamente.

To troubleshoot, first decide if you actually want to use a submodule, which is a Git project inside a Git project; submodules are sometimes created accidentally.

If you don't want to use a submodule, remove the submodule, replacing PATH-TO-SUBMODULE with the path to the submodule:

$ git submodule deinit PATH-TO-SUBMODULE
$ git rm PATH-TO-SUBMODULE
$ git commit -m "Remove submodule"
$ rm -rf .git/modules/PATH-TO-SUBMODULE

Se você quiser usar um submódulo, inicialize-o. Para obter mais informações, consulte "Ferramentas Git - Submódulos" no livro Pro Git.

Permalinks relativos configurados

Este erro significa que você tem permalinks relativos, que não são compatíveis com o GitHub Pages no arquivo _config.yml.

Permalinks são URLs permanentes que fazem referência a uma determinada página no seu site. Os permalinks absolutos iniciam com a raiz do site, enquanto os permalinks relativos iniciam com a pasta que contém a página referenciada. O GitHub Pages e o Jekyll não são mais compatíveis com permalinks relativos. Para obter mais informações sobre permalinks, consulte "Permalinks" na documentação do Jekyll.

Para solucionar problemas, remova a linha relative_permalinks do arquivo _config.yml e reformate os permalinks relativos no site com permalinks absolutos. Para obter mais informações, consulte "Editar arquivos no repositório".

O link simbólico não existe no repositório do site

Este erro significa que seu site inclui um link simbólico que não existe na fonte de publicação do site. Para obter mais informações sobre links simbólicos, consulte "Link simbólico" na Wikipédia.

Para solucionar problemas, determine se o arquivo na mensagem de erro é usado para criar o site. Se ele não for ou se você não quiser que o arquivo seja um link simbólico, exclua o arquivo. Se o arquivo de link simbólico for necessário para criar seu site, verifique se o arquivo ou o diretório a que ele faz referência está na fonte de publicação do site. Para incluir ativos externos, considere usar um gerenciador de pacotes terceirizado como o Bower.

Erro de sintaxe no loop 'for'

Este erro significa que o código inclui sintaxe inválida em uma declaração de loop for do Liquid.

Para solucionar problemas, verifique se todos os loops for no arquivo da mensagem de erro têm sintaxe adequada. Para obter mais informações sobre a sintaxe adequada para loops for, consulte "Tags de Iteração" na documentação do Liquid.

Tag fechada incorretamente

Esta mensagem de erro significa que o código inclui uma tag lógica que foi fechada incorretamente. Por exemplo, {% capture example_variable %} deve ser fechada por {% endcapture %}.

Para solucionar problemas, verifique se todas as tags lógicas no arquivo da mensagem de erro estão fechadas corretamente. Para obter mais informações, consulte "Tags do Liquid" na documentação do Liquid.

Tag terminada incorretamente

Este erro significa que o código inclui uma tag de saída que não foi terminada corretamente. Por exemplo, {{ page.title } em vez de {{ page.title }}.

Para solucionar problemas, verifique se todas as tags de saída no arquivo da mensagem de erro estão terminadas com }}. Para obter mais informações, consulte "Objetos do Liquid" na documentação do Liquid.

Erro de tag desconhecida

Este erro significa que o código contém uma tag do Liquid não reconhecida.

Para solucionar problemas, verifique se todas as tags do Liquid no arquivo da mensagem de erro correspondem a variáveis padrão do Jekyll e se não há erros de digitação nos nomes das tags. Para obter uma lista de variáveis padrão, consulte "Variáveis" na documentação do Jekyll.

Plugins incompatíveis são uma fonte comum de tags não reconhecidas. Se você usar um plugin incompatível ao gerar seu site localmente e fazer push dos arquivos estáticos para o GitHub Enterprise, verifique se o plugin não está inserindo tags que não estão nas variáveis padrão do Jekyll. Para obter uma lista de plugins compatíveis, consulte "Sobre o GitHub Pages e o Jekyll".