Antes de começar

O que você precisa saber antes de começar a escrever seus textos

Não importa qual linguagem de marcação você vai usar para publicar sua postagens, existem algumas particularidades do HyperFluxCMS que você deve entender antes de começar a escrever os textos. Veja aqui.

Antes de começar a publicar conteúdo no seu site, existem algumas coisas que você precisa saber e que se aplicam a todas as páginas de conteúdo.

As informações e cuidados se aplicam a qualquer linguagem de marcação que você utilizar: HTML, HyperCode e HyperLite.

Acentuação

Você não deve se preocupar com acentuação. O HyperFluxCMS as converte automaticamente em entidades HTML. Entenda melhor em Acentuação.

Caracteres especiais e sequências de escape

Em uma linguagem de marcação ou programação ou sistema eletrônico de comunicação, quando você quer indicar ao sistema que determinado caractere deve ser usado de uma forma diferente da padrão, se faz um processo chamado "escape" ou "escapear" ou "sequência de escape". Isso pode ser feito, por exemplo, substituindo o caracter por um outro, uma sequência de outros ou colocando um ou mais caracteres antes do caractere que se deseja diferenciar.

O HyperFluxcCMS utiliza alguns caracteres especiais para a marcação. E eles devem ser escapeados.

Caracteres especiais como [, ], <, >, \ devem ser escapeados, precedidas pelo símbolo \. Entenda melhor em Símbolos Especiais.

Se você habilitar a linguagem HyperLite na publicação, você também precisará escapear outros caracteres na situação onde eles possam ser confundidos com marcadores.

Esses caracteres são: *, /, ^, |, _, ~, ;, :, ., # e @. Entenda melhor em Símbolos Especiais em HyperLite.

O caractere \

O caractere \ pode ser usado para duas funções:

• sequência de escape para indicar que o próximo caractere deve ser tratado com um caractere literal, não como símbolo de marcação;
• para quebrar linhas código do texto sendo editado, sem que elas sejam interpretadas e compiladas como quebra de linha ou fim de parágrafo. Veja Quebra Automática de Linhas.

Se o caractere \ aparecer no texto, em qualquer posição que seja (exceto dentro de blocos HTML e texto puros), ele deve obrigatoriamente ser escapeado, sendo precedido por OUTRO \, ficando \\.

Dentro de blocos HTML Puro e Texto Puro, caracteres não devem ser escapeados e devem ser informados exatamente da forma literal (veja Blocos em HTML puro e Blocos em texto puro).

Linhas e Parágrafos

O HyperFluxCMS trata automaticamente quebras de linhas e parágrafos. Uma quebra de linha simples quebra a linha sem começar um novo parágrafo. Uma ou mais linhas em branco iniciam um novo parágrafo.

Em linhas terminadas com \ a quebra de linha é ignorada e a linha seguinte é tratada como uma continuação da anterior.

Entenda melhor em Linhas e Parágrafos.

Se a página for preformatada em HTML normalmente convém desativar o tratamento automático padrão de quebras de linhas, pela configuração da página ou com a tag
[pragma manuallinebreaks="true" usehtmlampersand="true" keepcrlfaftertags="true"]

Entenda melhor em Quebra Automática de Linhas em HTML.

Se você quiser que determinada linha não seja quebrada, e sim concatenada com a próxima, essa linha deve terminar com contrabarra \.

Veja Evitando Quebra Automática de Linhas.

Blocos de Texto Puro

Pode-se incluir blocos de texto puro, não processado, dentro de uma página com código HyperLite.

Isso é feito inserindo os caracteres <<< "menor-que" três vezes seguidas, sem espaços, para iniciar o bloco. Em seguida deve-se inserir o texto desejado e terminar o bloco com o >>> "maior-que", três vezes seguidas e sem espaço.

Assim:

que renderiza assim:

Este é um texto /preformatado/.
Aqui dentro não é necessário usar sequência de escape *como aqui*.
Por outro lado, marcação hypercode nao tem efeito aqui dentro.

Note o que o uso de <<< >>> para blocos de texto puro faz com que eles sejam considerados como textos preformatados, como com a tag <pre> do HTML.

Eles são exibidos com todos os espaços e quebras de linha que foram digitados, e normalmente com uma fonte com largura fixa de caracteres. O texto quue existir dentro desse bloco será tratado e exibido literalmente, incluindo quebras de linhas, caracteres especiais, etc. Tags HTML, HyperCode, marcação Hyperlite e sequências de escape não são processadas e são exibidas exatamente como estiverem.

Blocos de HTML Puro

Assim como blocos de texto puro, pode-se incluir blocos de HTML puro, não processado, dentro de uma página com código HyperLite.

Isso é feito inserindo os caracteres << "menor-que" duas vezes seguidas, sem espaços, para iniciar o bloco. Em seguida deve-se inserir o código HTML e terminar o bloco com o >> "maior-que", duas vezes seguidas e sem espaço.

Isso também pode ser usado para inserir códigos Javascript na página.

Dentro de bloco de código HTML, o que estiver escrito é usado literalmente pelo HyperFluxCMS, sem nenhum tipo de checagem, processamento ou tratamento.

Não é possível utilizar Tags HyperCode, nem formatação HyperLite, nem variáveis nem parâmetros. O que estiver escrito dentro do bloco demarcado com << e >> será incluido na página exatamente como está.

Não use sequências de escape para caracteres especiais dentro de blocos HTML.

Assim:

que renderiza assim:

Avançado

Você pode usar Variáveis HyperFluxCMS nas suas postagens e também ao criar Templates. Veja mais em Variáveis.

Conclusão

Como já foi dito, essas características são gerais do HyperFluxCMS e se aplicam a qualquer linguagem de marcação que você escolher usar nas páginas do seu site.

A seguir, veja particularidades de cada uma das linguagens suportadas.

• Usando HTML no HyperFluxCMS
• Usando HyperCode no HyperFluxCMS
• Usando HyperLite no HyperFluxCMS