A veces es más fácil entender cómo escribir XML bien formado al ver un ejemplo. El boletín informativo de Web Writer se escribe en una forma de XML: lo llamamos AML o About Markup Language (ver figura). Si bien este es un documento de trabajo, en realidad no es un documento XML bien formado o válido.
Bien formado
Hay algunas reglas específicas para crear un documento XML bien formado:
- La declaración XML debe aparecer primero en cada documento.
- Los comentarios no son válidos dentro de una etiqueta. Los comentarios no pueden contener dos guiones seguidos, excepto el principio y el final del comentario.
- Las etiquetas deben tener una etiqueta final o estar cerradas dentro de la propia etiqueta singleton, por ejemplo
. - Todos los atributos de las etiquetas deben estar entre comillas, preferiblemente comillas dobles a menos que el propio atributo contenga una comilla doble.
- Cada documento XML debe contener un elemento que contenga completamente todos los demás elementos.
Solo hay dos problemas con el documento que hacen que no esté bien formado:
Lo primero que necesita el documento AML es una declaración de declaración XML.
El otro problema es que no hay un elemento que encierre completamente todos los demás elementos. Para solucionar esto, agregaremos un elemento contenedor externo: Realizar esos dos cambios simples (y asegurarse de que todos los elementos contengan solo CDATA) convertirá el documento no bien formado en un documento bien formado. Un documento XML válido se valida con una Definición de tipo de documento (DTD) o Esquema XML. Estas son un conjunto de reglas creadas por el desarrollador o una organización de estándares que definen la semántica del documento XML. Estos le dicen a la computadora qué hacer con el marcado. En el caso de About Markup Language, ya que este no es un lenguaje XML estándar, como XHTML o SMIL, el desarrollador creará la DTD. Es probable que esa DTD esté en el mismo servidor que el documento XML y se haga referencia en la parte superior del documento. Antes de comenzar a desarrollar una DTD o un esquema para sus documentos, debe darse cuenta de que simplemente al estar bien formado, un documento XML se autodescribe, y por lo tanto no necesita una DTD. Por ejemplo, con nuestro documento AML bien formado, hay las siguientes etiquetas: Si está familiarizado con el boletín de Web Writer, puede reconocer las diferentes secciones del boletín. Esto hace que sea muy fácil crear nuevos documentos XML utilizando el mismo formato estándar. Siempre pondríamos el título completo en la etiqueta y la primera URL de la sección en la etiqueta. Si debe escribir un documento XML válido, ya sea para usar los datos o para procesarlos, debe incluirlo en su documento con la etiqueta. En esta etiqueta, define la etiqueta XML base en el documento y la ubicación de la DTD (generalmente un URI web). Por ejemplo:
Una cosa buena acerca de las declaraciones de DTD es que puede declarar que una DTD es local al sistema donde está el documento XML con el "SISTEMA". También puede apuntar a una DTD pública, como con un documento HTML 4.0:
Cuando usa ambos, le está diciendo al documento que use un DTD específico (el identificador público) y dónde encontrarlo (el identificador del sistema). Finalmente, puede incluir una DTD interna directamente en el documento, dentro de la etiqueta DOCTYPE. Por ejemplo (esto no es una DTD completa para el documento AML):
> Para crear un documento XML válido, también puede usar un documento de esquema XML para definir su XML. El esquema XML es un documento XML que describe documentos XML. Aprende a escribir un esquema. El solo hecho de apuntar a un esquema DTD o XML no es suficiente. El XML que se encuentra en el documento debe seguir las reglas de la DTD o el esquema. El uso de un analizador de validación es una forma sencilla de verificar que su XML sigue las reglas de DTD. Usted puede encontrar muchos analizadores de este tipo en línea.
DTDs
Esquema XML
Nota
