Estilização de post de blog

:discourse: Resumo O Blog Post Styling permite designar uma categoria de blog, alterando a aparência dos tópicos dentro dela para se assemelhar mais a posts de blog tradicionais.
:eyeglasses: Pré-visualização Pré-visualizar no theme-creator.discourse.org
:hammer_and_wrench: Repositório github.com/discourse/discourse-blog-post-styling
:open_book: Novo em Temas do Discourse? Guia para iniciantes sobre o uso de Temas do Discourse

Instalar este componente de tema

O componente de tema Blog Post Styling transforma os tópicos do Discourse em um layout tradicional de post de blog. Quando aplicado a uma categoria, a primeira imagem de cada tópico é promovida a um destaque de largura total acima do título, e o conteúdo é estilizado com tipografia e exibição de metadados adequados a blogs.

Configurações

Abaixo estão as diversas configurações associadas a este componente de tema:

  • Categoria de blog: Tópicos que pertencem a qualquer uma das categorias selecionadas terão o estilo de post de blog aplicado.

  • Tag de blog: Escolha uma ou mais tags que, ao serem aplicadas a um tópico, atribuirão a ele o estilo de post de blog.

  • Tamanho da imagem: Decida como a imagem de destaque preenche a área do cabeçalho:

    • Sem imagem: Oculta a imagem de destaque.
    • Largura total (padrão): A imagem ocupa toda a área de conteúdo.
    • Centralizada: A imagem mantém a proporção e é centralizada na área de conteúdo.
  • Posição da imagem: Decida onde mostrar a imagem em relação ao título:

    • Acima do título (padrão): Mostra a imagem acima do título do tópico.
    • Abaixo do título: Mostra a imagem abaixo do título do tópico. Quando selecionada, você também pode incluir um resumo que será exibido entre o título e a imagem. Abaixo, você pode ver como a imagem se parece quando a configuração posição da imagem está definida como acima do título e abaixo do título:
  • Dropcap ativado: Quando ativado, a primeira letra do post de blog terá um estilo ampliado, como este:
  • Mobilidade ativada: Quando ativado, o estilo de post de blog é aplicado ao ler o tópico em dispositivos móveis.

Escrevendo um Post de Blog

Depois de configurar sua categoria de blog (ou aplicar sua tag de post de blog), há algumas coisas especiais a observar sobre o funcionamento do tópico de post de blog.

Imagem de destaque

Coloque a imagem que deseja usar como destaque na primeira linha do post, seguida de uma linha em branco antes do início do seu conteúdo:

![descrição da imagem|1100x440](upload://hash-da-sua-imagem.jpg)

O conteúdo do seu post começa aqui...

O componente posiciona automaticamente essa imagem com base na configuração posição da imagem (veja acima). Se qualquer outro conteúdo — incluindo linhas em branco — aparecer antes da imagem, ela não será promovida à posição de destaque.

Após publicar um post pela primeira vez, atualize a página para ver a imagem aparecer na posição designada. (Isso afeta apenas o autor do post na publicação inicial; membros que acessam o post devem ver a imagem no lugar correto imediatamente.)

Dicas de dimensionamento de imagem

O contêiner da imagem tem 440px de altura e 100% de largura. Para melhores resultados quando a configuração tamanho da imagem está definida como largura total:

  • Use ou recorte imagens para 1100x400px antes de fazer o upload para evitar recortes, ou
  • Escolha imagens com um assunto centralizado ou conteúdo não específico (paisagens, padrões) para que o recorte não remova detalhes importantes.

Resumos

Quando a configuração posição da imagem está definida como abaixo do título, você pode adicionar um resumo opcional ao seu post de blog, que aparecerá entre o título e a imagem de destaque.

Para fazer isso, envolva o conteúdo que deseja que apareça no seu resumo da seguinte forma:

[summary] Aqui está o conteúdo que será seu resumo. [/summary]

Citações estilizadas

Ao criar tópicos em uma categoria de blog, as citações recebem um estilo especial. Você pode criar citações no compositor usando o símbolo > ou o botão da barra de ferramentas do compositor .

Configuração de categoria recomendada

Nas configurações da sua categoria de blog, considere ativar a configuração de categoria Navegar para o primeiro post após os tópicos serem lidos. Isso envia leitores recorrentes diretamente ao conteúdo do post de blog, em vez de sua última posição lida.

Blog Post Styling + Miniaturas da Lista de Tópicos

Este componente é compatível com Miniaturas da Lista de Tópicos, que destaca a imagem de destaque do seu post de blog na lista de tópicos:

Nota: O componente Miniaturas da Lista de Tópicos não é compatível com o tema Horizon. A captura de tela acima está usando o tema Foundation.

105 curtidas