Documentos XML¶

XML são documentos usados para guardar e catalogar informações de forma intuitiva e flexível, e servem para diversas finalidades!

Importante: Os documentos XMLs possuem “um rosto” diferente para cada finalidade. Exemplo: Enquanto um XML de interface possui um conjunto de informações e marcações específicas, um XML de informações do plugin possui outro conjunto distinto de informações e marcações específicas. Haverá uma documentação própria para guiar seus passos em cada uma dessas finalidades!

Links úteis:

XML na wikipedia: http://pt.wikipedia.org/wiki/XML
Introdução ao XML: http://www.macoratti.net/xml.htm

Se você está tendo problemas com os documentos XML, eis aqui algumas dicas:

Certifique que as marcações/tags abertas estão sendo fechadas corretamente. Nomes de marcações são case-sensitives e precisam ser exatamente iguais à marcação de abertura.
Certifique que as marcações usadas são válidas para a finalidade desejada.
Alguns caracteres são reservados para controle do XML. Se você precisar deles mesmo assim, é preciso fazer substituição por um código especial. Veja Lidando com caracteres reservados do XML.
Em caso de erro relacionado à codificação do texto, cerifique-se que o documento possui um cabeçalho XML identificando corretamente a codificação do documento. O cabeçalho é a primeira linha do documento, onde:
Se o documento estiver codificado em UTF-8, o cabeçalho deve ser:
- \<?xml version="1.0" encoding="UTF-8"?>
Se você não sabe a codificação do documento, talvez o cabeçalho correto seja:
- \<?xml version="1.0" encoding="ISO-8859-1"?>

Lidando com caracteres reservados do XML¶

Alguns caracteres são reservados para controle do XML. Se você precisar deles mesmo assim, é preciso fazer substituição por um código especial:

Tabela de caracteres reservados:¶

Caractere reservado	Substituição
\<	\<
>	\>
\&	\&
‘	\'
“	\"

Exemplos de substituição:¶

\<label text=”D\&D”/> \ Substituição de "\&" por "\&" ... Contém "D\&D"\
\<button text=”20 \> 10”/> \ Substituição de ">" por "\&gt"; .... Contém "20 > 10"

CDATA¶

Você também pode utilizar blocos CDATA para evitar fazer substituições, o que é útil em códigos LUA dentro de XML. \ Saiba mais em http://en.wikipedia.org/wiki/CDATA

Exemplo de CDATA¶

\<event name="onResize"> \<![CDATA[ local teste = "D\&D"; if (x \< y) or (x > z) then local teste = 'D\&D 4.0'; end; ]]> \</event>

Não é preciso fazer nenhuma substituição de caracteres reservados dentro de um bloco CDATA.

Observação: Só é possível utilizar CDATA no corpo de um nodo do XML. Não é possível usar CDATA no valor de um atributo, por exemplo.

Created with the Personal Edition of HelpNDoc: Create help files for the Qt Help Framework