Como publicar conteúdos no Sitio Web?
1. Escolher a seção do sitio mais apropriada para escrever
"Onde escrever" fica a critério de cada pessoa, porém é bom identificar quando usar uma ou outra seção. Umas dicas (mas o senso comum também ajuda) podem ser:
- Usar a seção do Blog:
- O conteúdo é curto, apresenta novidades e é informativo?
- Usar a seção de Documentos:
- O conteúdo pertence a um projeto, faz parte de seções fixas e é mais "estático"
- Por exemplo: Quem somos?, Valores, Documentos descritivos de um Projeto ou Serviço
- O conteúdo é um manual
- O conteúdo pertence a um projeto, faz parte de seções fixas e é mais "estático"
Se tiver dúvidas sobre como escrever um conteúdo, visite o código do site e veja as páginas dentro do seu computador e no navegador.
Copiar, colar e modificar pode ser muito útil nesses casos!
2. Criar um documento em "markdown"
Salvar o documento seguindo um padrão:
- Usar a data em formato ISO seguido de uma ou duas palavras em minúsculo que identifiquem o conteúdo
- Exemplo: (
Ano-Mês-Dia-palavra-chave)
- Exemplo: (
2026-02-27-sistema-silvipastoril.md
- Markdown é uma linguagem de marcação que permite escrever textos de maneira simples que depois serão transformados em HTML pelo gestor de conteúdos.
- Quanto mais organizada estiver a estrutura do texto, mais simples será a indexação do site e leitura por parte das pessoas
Modelo de documento em markdown
Para escrever documentos em markdown se usam marcas para indicar a formatação. Por exemplo o simbolo "#" cria títulos. O seguinte exemplo apresenta a estrutura básica de um documento em markdown incluindo o cabeçalho e o conteúdo.
O Cabeçalho inclui "metadados" e está separado do resto do texto por três traços (ao início e no final: ---)
Exemplo
---
title: Postagem maneira
date: 2026-01-10
author: John Doe
description:
slug: post-mane
tags: [silvipastoril, agroecologia]
description: Como realizar uma boa postagem
sidebar_label: Post
keywords:
- post
- pecuaria
hide_table_of_contents: false
---
# Titulo nível
Aqui escreva a introdução ou qualquer outro texto
## Título nível 2
### Título nível 3
### Escrever links para páginas web:
[tutorial](https://www.markdownlang.com/pt/intro/ "Introdução à escrita em markdown")
## Escrever links para imagens
### Ênfase:
**enfatizado forte**
*itálico*
Para aprender mais sobre markdown veja o seguinte tutorial
3. Criar um cabeçalho no arquivo markdown com informações relevantes para a publicação
O cabeçalho deve conter informações básicas ("metadados") que permitam:
- Identificar datas de criação e modificação do documento e autoria
- Indexar os conteúdos do sitio em motores de busca
- Para isso é valioso incluir metadados como descrição, palavras-chave e outros
- Facilitar a busca de conteúdos dentro do sitio web
- Incluindo etiquetas para categorizar os conteúdos, por exemplo
O uso de palavras-chave e da descrição no cabeçalho do documento faz parte da estratégia "SEO" (otimização de motor de busca, pela sigla em inglês). Ao incluir essas informações é apropriado pensar em palavras e descrição que coincidam com buscas que são realizadas por potenciais pessoas que tenhma interesse nos conteúdos do Sitio.
Agroecologia, Silvipastoris, Sustentabilidade, podem ser palavras-chaves ou textos para construir a descrição, se houver interesse de chamar público com interesse nessas áreas, por exemplo
Modelo de cabeçalho
O seguinte modelo é um exemplo de opções de metadados que podem ser usadas para melhorar a organização das publicações. Nem todas as opções precisam ser usadas. Caso alguma não seja usada, ela pode ser removida para permitir o que Site seja construído sem problemas.
Existem informações valiosas para incluir no cabeçalho
Por exemplo no Blog podem ser incluídas as seguintes:
---
title: Postagem maneira # Título. Incluir para indexar em motores de busca (estratégia "SEO"). Pode ser diferente do título do documento no corpo do texto
date: 2026-01-10 # Data de criação do documento
author: Joe # Nome da pessoa que elaborou
last_update:
date: 2026-02-28 # Data de atualização (a data de criação pode ser obtida do nome do arquivo, se for incluÍda)
author: Joe # nome da pessoa que atualizou por última vez
description: A Postagem mais maneira do Site PF. # Descrição. Permite indexar informação em motores de busca
slug: post-mane # Define o nome do caminho para chegar na postagem no site (`https://site.multifarm.top/blog/post-mane`)
authors: [ana, alejo] # Autoria (opção vários autores)
tags: [silvipastoril, agroecologia] # Etiquetas para categorizar conteúdos
image: # inclusão de imagem, de baixo peso, para renderizar em pré-visualização, se for de intereses
description: Como realizar uma boa postagem # Descrição com fins de estratégia "SEO": otimizar a busca em motores
sidebar_label: Post # O nome que deve aparecer na barra lateral para identificar o documento. Caso não use, o link terá o mesmo nome do arquivo
keywords: # Lista de palavras-chave para indexar o documento (estratégia "SEO")
- post
- pecuaria
hide_table_of_contents: false # incluir "false" para mostrar a tabela de conteúdos e "true" para não mostrar
---
Essa é a postagem maneira.
PS: todo o que é escrito antes de "truncate" vai aparecer no índice do blog.
<!-- truncate -->
E aqui continua o texto ...
Aqui um link para todas as opções que podem ser usadas no cabeçalho do arquivo markdown.
Para realizar uma publicação, você pode copiar esse cabeçalho e modificar segundo as suas necessidades. Caso não precisar usar uma opção, pode ser removida
Quando for escrever pense em quais informações são relevantes para ter controle da escrita dos textos e inclua essas informações no cabeçalho (exemplo: data, autoria)
Incluir uma lista de pessoas que escrevem frequentemente no Blog
Para escrever no Blog, é necessário preencher o arquivo de autorias. O arquivo (authors.yml) com a relação de cada pessoa que faz contribuições no blog (para simplificar a escrita do cabeçalho no arquivo markdown) está no diretório do blog dentro do Site:
/blog/authors.yml
Dentro do arquivo podemos incluir as informações de pessoas que realizam publicação no Blog.
Aqui um exemplo das informações que podem ser incluídas:
ana: # Nome que será usado nos cabeçalhos dos arquivos markdown
name: Ana Carrilli # Nome por extenso que aparecerá no conteúdo dos textos
title: Assessora Projeto Pecuária-Floresta
image_url: # incluir url para uma imagem, de baixo peso, se for de nosso interesse
email: ana@email.org # e-mail
page: true # Cria uma página com a relação de textos escritos pela pessoa
alejo:
name: Alejo Ayala
title: TI Master
image_url:
email: alejo@email.org
Assim fica mais simples para incluir o nome da pessoa no arquivo markdown. Por exemplo:
---
authors: [ana, alejo]
---
Incluir uma lista de palavras a serem usadas como etiquetas ("tags") no Blog
As etiquetas do Blog permitem criar palavras que agrupam conteúdos e facilitam depois encontrar temas, ou filtrar textos.
O arquivo (tags.yml) se encontra no diretório do Blog:
blog/tags.yml
Details
O arquivo pode ser construído seguindo o exemplo que já está no Site, usando os seguintes itens:
agroecologia:
label: 'Agroecologia'
permalink: '/agroecologia'
description: 'Postagens relacionadas com agroecologia'