Esses exemplos fornecem trechos de código testado para a exibição de vários formatos de data em um site Jekyll. Eles também devem funcionar no GitHub Pages, Shopify ou qualquer outra coisa que usa Liquid.

Jekyll (gerador de site estático) usa do Shopify o Liquid Template Engine. Para ver as datas é usando a tag {{ page.date }} fornecida pelo Liquid. Com nenhuma outra alteração, as datas produzidas são algo como:

2015-12-17 09:00:00 -0300

Se houver projetos que usam esse formato, eles são poucos e não se relacionam. A criação de uma data mais amigável é feita através da aplicação do filtro date: do Liquid. Por exemplo, combinando a tag e o filtro:

{{ page.date | date: '%B %d, %Y' }}

produz uma data mais amigável ao leitor:

December 17, 2015

Com isso fica muito melhor, mas dependendo da data, as questões de sutileza no design aparecem. Por exemplo, durante os primeiros nove dias de cada mês “zeros à esquerda” surgem (Ex: “August 03, 2013” em vez de “August 3, 2013”). Outros erros básicos com os filtros do Liquid incluem:

  1. Adicionando uma data com os nomes dos meses abreviados temos que ajustar para lidar com Maio que em ingles fica May. Por exemplo, “Aug. 16, 2013” está abreviado. “May. 16, 2013” não esta.

  2. Setembro é geralmente abreviado em ingle como “Sept” e não “Sep” como é o padrão do Liquid.

  3. Para cumprir com o estilo americano os meses April, May, June e July não devem ser abreviados. Alterações semelhantes são necessárias para atender as orientações do Manual de Estilo de Chicago.

A maioria dos projetos acompanham os padrões disponíveis. Ou usando um formato que não tem esses problemas ou, mais frequentemente, não se importam com esses detalhes. Mesmo com essa situação as datas ainda ficam na home dos sites e como cada projeto tem sua lista de tarefas de possíveis mudanças que se estendem até o horizonte as datas não são itens de importância. Então é comum adiar encontrar uma solução, mas não ter formatação de data adequada é sempre um incomodo. Enquanto essas soluções resolverem a questão, esta postagem será como uma referência pública também.

Este conjunto de filtros para datas do Liquid resolve os problemas listados acima e explora algumas outras opções de formatação. Cada um oferece uma solução para um formato de exibição específico e é fornecido com quatro exemplos de saída para as seguintes datas: 1) 3 de Maio de 2015, 2) 4 de Julho 2015, 3) 23 Setembro de 2015 e 4) 26 de Novembro de 2015. Estes exemplos demonstram como os vários problemas de formatação são manipulados. Após os exemplos, alguns trechos de código para elementos individuais são fornecidos. Com estas amostras, é fácil conseguir praticamente qualquer formato de data desejado.

Usando Filtros do Jekyll para Date

Formatação de datas no Jekyll com Liquid


Referências


comments powered by Disqus