Ir para o conteúdo principal
  1. Documentação/

Front Matter

Documentação - Este artigo faz parte de uma série.
Parte 7: Este artigo

Além dos parâmetros de front matter padrão do Hugo, o Blowfish adiciona várias opções adicionais para personalizar a apresentação de artigos individuais. Todos os parâmetros de front matter do tema disponíveis estão listados abaixo.

Os valores predefinidos dos parâmetros de front matter são herdados da configuração base do tema, pelo que só precisa de especificar estes parâmetros no seu front matter quando quiser substituir a predefinição.

NomePredefiniçãoDescrição
titleNão definidoO nome do artigo.
descriptionNão definidoA descrição de texto do artigo. É utilizada nos metadados HTML.
externalUrlNão definidoSe este artigo está publicado num site de terceiros, o URL para este artigo. Fornecer um URL impedirá a geração de uma página de conteúdo e quaisquer referências a este artigo vincularão diretamente ao site de terceiros.
editURLarticle.editURLQuando showEdit está ativo, o URL para a ligação de edição.
editAppendPatharticle.editAppendPathQuando showEdit está ativo, se o caminho para o artigo atual deve ser anexado ao URL definido em editURL.
groupByYearlist.groupByYearSe os artigos são agrupados por ano nas páginas de lista.
menuNão definidoQuando um valor é fornecido, uma ligação para este artigo aparecerá nos menus nomeados. Valores válidos são main ou footer.
robotsNão definidoString que indica como os robôs devem tratar este artigo. Se definido, será apresentado no cabeçalho da página. Consulte a documentação do Google para valores válidos.
sharingLinksarticle.sharingLinksQuais ligações de partilha apresentar no final deste artigo. Quando não fornecido ou definido como false, nenhuma ligação será apresentada.
showAuthorarticle.showAuthorSe a caixa do autor para o autor predefinido é apresentada no rodapé do artigo.
showAuthorBottomarticle.showAuthorBottomAs caixas de autor são apresentadas na parte inferior de cada página em vez do topo.
authorsNão definidoArray de valores para autores, se definido substitui as definições de showAuthor para a página ou site. Utilizado na funcionalidade de múltiplos autores, consulte esta página para mais detalhes sobre como configurar essa funcionalidade.
showAuthorsBadgesarticle.showAuthorsBadgesSe as taxonomias de authors são apresentadas no cabeçalho do artigo ou lista. Isto requer a configuração de multiple authors e a taxonomia authors. Consulte esta página para mais detalhes.
featureimageNão definidoLigação para a imagem de destaque
featureimagecaptionNão definidoLegenda para a imagem de destaque. Apresentada apenas no heroStyle big
showHeroarticle.showHeroSe a imagem em miniatura será mostrada como imagem hero dentro da página do artigo.
heroStylearticle.heroStyleEstilo para apresentar a imagem hero, opções válidas são: basic, big, background, thumbAndBackground.
imagePositionNão definidoDefine a posição da imagem de destaque utilizando o atributo object-position. Valores válidos são como especificado na documentação MDN.
showBreadcrumbsarticle.showBreadcrumbs ou list.showBreadcrumbsSe as migalhas de pão são apresentadas no cabeçalho do artigo ou lista.
showDatearticle.showDateSe a data do artigo é apresentada. A data é definida utilizando o parâmetro date.
showDateUpdatedarticle.showDateUpdatedSe a data em que o artigo foi atualizado é apresentada. A data é definida utilizando o parâmetro lastmod.
showEditarticle.showEditSe a ligação para editar o conteúdo do artigo deve ser apresentada.
showHeadingAnchorsarticle.showHeadingAnchorsSe as ligações de âncora de cabeçalho são apresentadas junto aos cabeçalhos neste artigo.
showPaginationarticle.showPaginationSe as ligações do artigo anterior/próximo são apresentadas no rodapé do artigo.
invertPaginationarticle.invertPaginationSe a direção das ligações do artigo anterior/próximo deve ser invertida.
showReadingTimearticle.showReadingTimeSe o tempo de leitura do artigo é apresentado.
showTaxonomiesarticle.showTaxonomiesSe as taxonomias relacionadas com este artigo são apresentadas.
showTableOfContentsarticle.showTableOfContentsSe o índice é apresentado neste artigo.
showWordCountarticle.showWordCountSe a contagem de palavras do artigo é apresentada.
showCommentsarticle.showCommentsSe o partial de comentários é incluído após o rodapé do artigo.
showSummarylist.showSummarySe o resumo do artigo deve ser apresentado nas páginas de lista.
showViewsarticle.showViewsSe as visualizações do artigo devem ser apresentadas em listas e visualização detalhada. Isto requer uma integração com Firebase. Consulte esta página para um guia sobre como integrar o Firebase.
showLikesarticle.showLikesSe os gostos do artigo devem ser apresentados em listas e visualização detalhada. Isto requer uma integração com Firebase. Consulte esta página para um guia sobre como integrar o Firebase.
seriesOpenedarticle.seriesOpenedSe o módulo de série será apresentado aberto por predefinição ou não.
seriesNão definidoArray de séries às quais o artigo pertence, recomendamos utilizar apenas uma série por artigo.
series_orderNão definidoNúmero do artigo dentro da série.
summaryGerado automaticamente utilizando summaryLength (veja configuração do site)Quando showSummary está ativado, esta é a string Markdown a ser utilizada como resumo para este artigo.
xmltrue a menos que excluído por sitemap.excludedKindsSe este artigo é incluído no ficheiro /sitemap.xml gerado.
excludeFromSearchfalseSe este artigo deve ser excluído do sitemap e índice de pesquisa. Quando true, a página não aparecerá em sitemap.xml ou index.json.
layoutBackgroundBlurtrueFaz a imagem de fundo no heroStyle background desfocar com a rolagem
layoutBackgroundHeaderSpacetrueAdiciona espaço entre o cabeçalho e o corpo.
Documentação - Este artigo faz parte de uma série.
Parte 7: Este artigo

Relacionados