Metadados em HyperCode

Entenda os metadados em HyperCode

Metadados são informações complementares sobre uma postagem ou código. Em HyperCode eles são uteis para informar de forma automatizada informações da página, facilitando edição em lote ou edição off-line.

Usando as tags de Metadados, é possível informar antecipadamente alguns aspectos da postagem sendo escrita.

Na maior parte das vezes, os usuários/editores comuns de postagens em um site HyperFluxCMS não vão precisar conhecer nem utilizar metadados. Eles são mais utilizados para usuários mais avançados, e nas seguintes situações:

• Se você está escrevendo um site inteiro off-line e deseja subir o site inteiro de uma vez e não deseja configurar dados como opções, título e subtítulo de cada página manualmente;
• Quando você salva ou restaura o backup do site, ele salva as informações das postagem em metadados;
• Se você estiver migrando seu site para um novo servidor e está usando a opção de salvar/restaurar backup;
• Se você precisa de algum ajuste fino na página, por exemplo, para otimizá-la para usar HTML como código principal.

Metadados são informações complementares sobre uma postagem ou código. Em HyperCode eles são uteis para informar de forma automatizada informações da página, facilitando edição em lote ou edição off-line.

Tag [postinfo]

postinfo indica os principais dados sobre uma página. Ela tem praticamente todas as configurações que podem ser acessadas pela propriedade da página usando o gerenciador de postagens do HyperFluxCMS.

A tag postinfo é auto-contida, ou seja, ela NÃO PRECISA e NEM DEVE ser usadas em pares "abrir/fechar". Deve ser usadas simplesmente as tags.

A tag postinfo deve ser obrigatoriamente a primeira tag da postagem, com exceção da tag pragma, que PODE vir antes de postinfo.

Sintaxe:

As propriedades title e permalink são obrigatórias. As demais são opcionais.

title indica o título da postagem.

subtitle indica o subtítulo da postagem.

categories é uma lista de palavras, separadas por vírgula, que indica as categorias do site a que a página pertence.

keywords é uma lista de palavras-chave ou expressões, separadas por vírgula, que indica as palavras-chave da página e ajudam a melhorar a posição dela no sistema de busca.

tags é uma lista de "etiquetas", que também são palavras-chave ou expressões, separadas por vírgula, que indica as palavras-chave da página e ajudam a melhorar a posição dela no sistema de busca.

published pode ser true ou false e indica se a postagem será publicada no site. Você pode deixar uma postagem como published="false" se ela ainda não estiver pronta, ou se tiver que ser "retirado do ar" temporariamente mas não deve ser excluída em caráter definitivo.

indexed pode ser true ou false e indica se a postagem será indexada no sistema de buscas do HyperFluxCMS. Você pode querer deixar algumas páginas fora da indexação para que elas só sejam acessíveis por outros caminhos, não pela busca do site.

deleted pode ser true ou false e indica que a postagem foi marcada para ser excluída. Ela não é excluida do banco de dados e poderá ser editada ou restaurada. Mas enquanto estiver marcada como deleted="true", não aparecerá nas buscas, nem será acessível ao visitante.

fixed pode ser true ou false e indica que postagem tem algum destaque especial e deve ser fixada na página inicial (sujeito a outras configurações e condições).

featured pode ser true ou false e indica que a postagem deve ser mostrada com algum destaque especial na buscas ou listagens (sujeito a outras configurações e condições).

ad pode ser true ou false e indica que a postagem é uma propaganda, infomercial, ou tem outro caráter publicitário.

protected pode ser true ou false e indica se a postagem é protegida contra exclusão acidental na listagem de postagens;

allowdisplaysource pode ser true ou false e indica que a postagem pode ter o código-fonte original mostrado ao visitante. Normalmente deve ser deixado "false".

allowdisplaymetadata pode ser true ou false e indica que os metadados da postagem podem ser mostrados ao visitante. Normalmente deve ser deixado "false". Só tem efeito quando allowdisplaysource é "true".

hyperlitesyntax pode ser true ou false e indica se postagem utiliza a linguagem HyperLite. Postagens que não a utilizem tem mais liberdade de usar caracteres como * e / sem precisar de sequência de escape.

authorid é um número que indica a identificação do autor da postagem. Reservado para uso do sistema.

authorusername contém o nome de usuário (não o nome completo) do autor da postagem. Reservado para uso do sistema.

creationdate contém a data e hora em que a postagem foi criada. Segue o formato "yyyy-mm-dd hh:mm:ss", como por exemplo "2024-11-27 17:33:18" para uma postagem criada em 27/nov/2024 às 17:33:18.

editiondate contém a data e hora da última vez que a postagem foi editada.

priority é um número que indica um valor de "prioridade" para a postagem. Postagens com priority maior tendem a aparecer primeiro no sistema de buscas do HyperFluxCMS. Use para destacar as postagens que você considerar mais relevantes para os visitantes.

permalink indica o link curto e permanente para a postagem no seu site. Por exemplo "cardapio" faz com que a postagem seja acessada por "seusite.com/cardapio".

manuallinebreaks pode ser true ou false. Se for true, desabilita o algoritmo padrão de quebra de linhas e parágrafos do HyperFluxCMS. Quebras de linhas devem ser inseridas manualmente usando tags HTML ou HyperCode, como <p>, <br>, [blank], etc. Veja mais em Linhas e Parágrafos Quebra Automática de Linhas em HTML e Evitando Quebra Automática de Linhas.

usehtmlampersand pode ser true ou false. Se for true, faz com que o compilador não converta automaticamente o caractere & em &amp;. Isso permite que se use páginas HTML com caracteres especiais e acentuados já expressos na forma de HTML Named Entities, como &aacute para á. Por padrão é false.

keepcrlfaftertags pode ser true ou false. Se for false, faz com que o compilador ignore quebras de linha depois de uma tag HyperCode ou HTML, até que encontre outra tag HTML ou HyperCode ou o início de uma linha de texto. Se for true, as quebras de linha após tags são entendidas como parte da formatação do texto. Normalmente só deve ser true em casos especiais onde o conteúdo da página foi importado/colado de HTML e a aparência do site não corresponde ao esperado. Por padrão é false.

coverimage indica o nome da imagem de capa da postagem. Normalmente templates, buscas, etc, usarão essa informação para pegar automaticamente a imagem informada da galeria. Deve ser um nome de imagem já existente na galeria. Use somente o nome do arquivo, sem o caminho. Por exemplo NÃO USE "/gallery/image.jpg" nem "https://meusite.com/gallery/image.jpg". Use simplesmente "image.jpg". Não use urls de sites externos. Deve obrigatoriamente ser uma imagem da galeria do site. Se a página não tiver uma imagem de capa, use "".

template indica o nome do template que será usado para exibir a postagem. Precisa ser um template do tipo "top-level".

Sobre allowdisplaysource

Postagens que tem "allowdisplaysource" = "true" podem ter o código-fonte exibido ao visitante através do sufixo ":src" no final do nome da página. Por exemplo "seusite.com/artigo-exemplo:src" mostrará o código-fonte da página.

Na maior parte dos sites, as postagens devem deixar esta opção desabilitada. Normalmente, somente sites em teste, implantação ou sites destinados a ensinar o uso do HyperCode ou HyperLite devem deixar essa opção ligada.

Postagens que tem "allowdisplaysource" = "true" e "allowdisplaymetadata" = "true" podem ter, além do código-fonte, também os metadados exibidos ao visitante, através do sufixo ":src+" no final do nome da página.

Por exemplo "seusite.com/artigo-exemplo:src+" mostrará o código-fonte da página e os metadados. Na maior parte dos sites, as postagens devem deixar esta opção desabilitada. Normalmente, somente sites em teste, implantação ou sites destinados a ensinar o uso do HyperCode ou HyperLite devem deixar essa opção ligada.

Tag [summary]

A Tag summary serve para indicar um texto curto, normalmente de um só parágrafo, que apresenta uma introdução sobre o conteúdo da postagem. Esse conteúdo pode ser usado para exibição em destaque logo após o título ou subtítulo, aparece nas listagens da busca, é utilizado na indexação da postagem e também para dar uma pontuação à postagem no algoritmo de busca.

O conteúdo dentro de summary deve ser texto puro. Não deve conter tags HTML, nem HyperCode, nem HyperLite.

Exemplo

Tag [pragma]

A Tag pragma dá ao compilador orientações sobre como ele deve se comportar a respeito de determinadas situações. Um exemplo é o de substituir o processamento automático de linhas e parágrafos que é padrão do HyperCode/HyperLite por um mais adequado para ser usado em postagens baseadas em HTML.

Algumas das propriedades são experimentais ou reservadas para uso futuro e podem não funcionar como esperado.

Todas as propriedades são opcionais. Apenas as que você desejar modificar fora do padrão precisam ser informados.

Sintaxe:

manuallinebreaks pode ser true ou false. Se for true, faz com que o compilador não gere automaticamente tags de parágrafos e quebras de linhas. False faz a geração automática de parágrafos e quebras de linha no texto. Se for false, o texto deve inserir manualmente quebras de linhas usando as tags [blank], [p], [block], etc, ou equivalente em HTML <br>, <p>, <div>, etc. Por padrão é false para postagens (compilador gera as quebras de linhas e parágrafos), e true para templates (que costumam ter muitas Tags seguidas e pode criar quuebras de linhas desnecessárias).

usehtmlampersand pode ser true ou false. Se for true, faz com que o compilador entenda o símbolo &, usado para indicar os caracteres especiais em HTML, em sua função original. Por exemplo, o texto &acute; é transformado em 'á'. Se for false, o caractere '&' é mostrado no texto da forma comum. Ponha como true se a página tiver letras acentuadas e símbolos especiais já representados usando "html entities", por exemplo, se você está colando texto escrito em HTML. Por padrão é false para postagens e em templates.

keepcrlfaftertags pode ser true ou false. Se for false, faz com que o compilador ignore quebras de linha depois de uma tag HyperCode ou HTML, até que encontre outra tag HTML ou HyperCode ou o início de uma linha de texto. Se for true, as quebras de linha após tags são entendidas como parte da formatação do texto. Normalmente só deve ser true em casos especiais onde o conteúdo da página foi importado/colado de HTML e a aparência do site não corresponde ao esperado. Por padrão é false para postagens e em templates.