Símbolos especiais em HyperLite

Caracteres adicionais que devem ser escapeados usando HyperLite

A linguagem HyperLite possui uma sintaxe ainda mais simples do que HyperCode. Mas para isso, foi necessário usar uma quantidade maior de caracteres para marcação de formatação. Consequentemente, a lista de caracteres que, se forem usados em suas funções normais (não a de formatação) precisarão ser escapeados é maior. Veja quais são esses caracteres e em que condições eles precisam ser escapeados.

A linguagem HyperLite usa mais caracteres especiais para a marcação da formatação do texto. Se postagem que você está criando ou editando tem habilitada a opção "Utilizar sintaxe HyperLite", existem outros caracteres que exigem a sequência de escape.

A forma de escapear esses caracteres é a mesma dos outros já descritos em Símbolos Especiais, ou seja, digitando uma contrabarra \ imediatamente à esquerda do caractere a ser escapeado. Isso indica ao HyperFluxCMS que o caractere a seguir deve ser tratado como o próprio caractere, e não como um símbolo de marcação.

Normalmente, só é obrigatório o escapeamento de um caractere nas condições em que ele possa ser confundido com um caracter de marcação.

Caracteres de marcação em linha

Caracteres de marcação em linha são aqueles que podem ser usados para formatar desde um único caractere de uma linha até um trecho inteiro do texto contendo vários parágrafos.

Eles são: *, /, ^, ~, _ e |.

Um exemplo é o asterisco *, que, na sintaxe HyperLite é usado para marcar uma parte do texto em negrito. Mas para isso, ele deve seguir algumas condições, como estar no
início de uma linha ou antes de uma palavra, ou estar fechando uma marcação de negrito previamente aberta.
Em outras condições, normalmente ele é tratado normalmente e nesses casos não é necessário o escapeamento.

Por exemplo, o asterisco * somente é considerado um símbolo de marcação quando:

• é o primeiro da página; ou
• é o primeiro de uma linha; ou
• vem logo depois de um espaço ou tabulação;
• é o último da página e existe uma marcação de início de negrito ativa; ou
• é o último de uma linha e existe uma marcação de início de negrito ativa; ou
• vem logo antes de um espaço ou tabulação e existe uma marcação de início de negrito ativa;

Nesses casos, se você quiser que asterisco seja entendido como parte do texto, e não a marca de início ou fim de texto em negrito, você precisa inserir o \ antes dele. Caso contrário, ele será entendido como início ou fim de texto em negrito.

Este é um texto em *negrito*;

Este é um texto \*cercado por asteriscos\* sem negrito porque o '*' está escapeado com \.

Nos outros casos, não é obrigatório o uso da sequência de escape. Mas ela é aceita e recomendada.

Por exemplo, a expressão 2*3*2=12 é um texto com asterisco mas o Hyperflux não considera o asterisco como marcação de negrito porque não atende aos requisitos. No caso, ele está cercado de caracteres que não são espaços nem separadores nem outros marcadores. Mas ela também PODE ser escrita como 2\*3\*2=12 e o resultado mostrado também será 2*3*2=12.

Caracteres de marcação em bloco

Caracteres de marcação em bloco são aqueles que indicam que a linha que iniciam tem algum significado especial de marcação. São considerados somente se são os primeiros caracteres de uma linha.

São #, ; e .. Você somente precisará escapeá-los se por acaso uma linha começar com um deles e você quiser que eles apareçam como são, em vez de serem considerados marcações de formatação do texto.

Caracteres de marcação de objetos

Caracteres de marcação de objetos são aqueles que indicam a marcação de um objeto, que pode ser uma imagem ou um link. São considerados somente se são os primeiros caracteres de uma linha ou se vêm logo depois de um espaço.

É o caractere arroba (@) seguido de uma letra que pode ser U, X, L, A ou I, maiúsculas ou minúsculas.

Por exemplo, @i:logo.jpg indica um objeto do tipo imagem ("i").

Se seu texto for utilizar em alguma parte o caractere @ logo no início de uma linha ou após um espaço e você quiser mostrá-lo como caractere comum, em vez de indicar um objeto, o '@' deve ser escapeado, precedido por '\', ficando assim: "\@".

Resumo

Pode parecer confuso no início, mas você entenderá melhor conforme for utilizando o HyerfluxCMS e estudando a estrutura da linguagem HyperLite.