Usando HTML

Usando HTML em suas postagens

Veja como incluir código HTML nas suas postagens e templates.

Apesar de possuir duas linguagens de marcação fáceis de usar e aprender (HyperCode e HyperLite), existem alguns casos em que você pode querer ou precisar usar HTML em suas postagens.

Existem alguns motivos principais para usar HTML.

• Usar algum recurso da linguagem HTML que não possua um equivalente em HyperCode. Por exemplo, elementos de formulários (forms) HTML;
• Reaproveitar um texto pré-formatado escrito em algum editor HTML;
• Fazer ajustes finos na página;
• Inserir scripts ou folhas de estilo;
• Criar e editar Templates.

O HyperFluxCMS suporta o uso de tags HTML dentro de postagens e códigos de templates. Inclusive permite que a mesma postagem ou template use simultaneamente duas ou três linguagens de marcação.

Para usar HTML, basta editar a postagem ou template e inserir normalmente as Tags HTML ao longo do texto. Ou cole diretamente o arquivo gerado a partir do seu editor favorito.

Por exemplo:

O objetivo deste artigo não é ensinar HTML. Se você entrou aqui, provavelmente já possui algum conhecimento da linguagem, seja básico ou avançado.

Além disso, existem diversos excelentes cursos na Internet, alguns gratuitos, outros pagos.

O objetivo deste artigo é explicar as particulares de usar HTML nas páginas HyperCode e as adaptações do código que devem ser feitas para o funcionamento e apresentação adequados.

Particularidades Gerais:

Veja as particularidades às que você deve prestar atenção quando estiver usando HTML no HyperFluxCMS.

Letras acentuadas

Os textos no HyperFluxCMS podem ser escritos diretamente com símbolos acentuados como "É" ou "Ç". O HyperFluxCMS faz automaticamente a conversão para entidades HTML para serem exibidos corretamente no navegador do visitante do site.

Para mais detalhes, veja Acentuação

Símbolos especiais

O HyperFluxCMS utiliza alguns caracteres como marcação de formatação para as linguagens HyperCode e HyperLite.

Alguns exemplos desses caracteres são \#, @, <

Simbolos &, " e #

Se seu código possui símbolos que tem significados especiais tanto em HTML como no HyperCode, eles são tratados de forma diferente.

O &, por exemplo, em HTML é usado para indicar uma "named html entity", como uma letra acentuada ou um símbolo como >. No Hypercode, ele é entendido como o caracter & literal.

Sendo assim, o caractere & por exemplo no texto &Ccedil;, que em html é exibido como Ç, no HyperFlux é exibido mesmo como &, o que faz com que &Ccedil; seja mostrado literalmente como &Ccedil;

O mesmo se aplica aos caracteres " e #.

Para evitar problemas, as HTML Entities, tanto as nomeadas, como &aacute; como as numéricas como &#x00E1; devem ser convertidas para os caracteres originais, mesmo que acentuados.

Existem alguns editores de texto, como o PSPad, que possuem ferramentas para converter "HTML Entities" nos respectivos caracteres originais.

Simbolos \, <, >, [, ],

Esses símbolos são usados para inserir diversos tipos de tags de marcação no HyperFluxCMS. Para que eles sejam tratados como caracteres comuns, imprimíveis, que será exibidos ao visitante do site, eles devem ser "escapeados", inserindo o caractere contrabarra \ imediatamente antes deles.

Por exemplo, para mostrar o símbolo > na sua página, ela tem que estar desta forma: \>

Simbolos |\#;.@*^/~_

Esses símbolos são usados como marcação na linguagem HyperLite. Em alguns casos eles também deve ser escapeados para que sejam exibidos no navegador em vez de serem entendidos como tags de marcação.

Parágrafos e Quebras de Linhas

A forma como HTML tratar os parágrafos e quebras de linha é diferente da forma do HyperFluxCMS.

Enquanto HTML ignora quebras de linha e parágrafos no código e exige que sejam explicitamente indicados com as tags <p> e <br>, o HyperFluxCMS simplifica isso aproveitando a forma em que o texto é digitado para determinar automaticamente as quebras de linhas e parágrafos.

Blocos de HTML puro

É recomendável transformar as HTML Entities em seus caracteres originais para facilitar que a postagem seja posteriormente editada. É muito mais fácil e menos sujeito a erros, entender uma palavra como "Acentuação" do que "Acentua&ccedil;&atilde;o".

Mas pode ser que por algum motivo você prefira manter o HTML no formato original. Para isso, basta marcar toda a parte HTML da página (que pode ser página inteira, inclusive) como um bloco HTML puro.

Para fazer isso, marque o bloco começando com os caracteres "<<" antes da parte em que começa o HTML puro. Depois que o bloco terminar, feche com ">>". Veja mais em Blocos em HTML puro.

Não é possível usar tags HyperCode ou HyperLite nem variáveis dentro de um bloco HTML.

Reaproveitando código

Se você está reaproveitando código de uma página HTML inteira, note que somente o que está DEPOIS da tag <body> e ANTES de </body> deve ser usado. Essas tags não devem fazer parte do código usado na página.

Além disso, informações contidas no HEADER HTML (entre <head> e </head> não são usadas e não devem ser inseridas. Informações como o título da página devem ser informadas na página de propriedades da postagem no próprio HyperFluxCMS.

Para mais informações, veja:
Acentuação
A Linguagem HyperCode
A Linguagem HyperLite
Símbolos Especiais
Símbolos Especiais em HyperLite
Quebra Automática de Linhas em HTML.
Evitando Quebra Automática de Linhas.