Questo articolo spiega come scrivere in modo ben formato XML mostrando un esempio. La newsletter di Web Writer è scritta utilizzando un formato XML; lo chiamiamo AML o About Markup Language. Sebbene questo sia un documento di lavoro, non è un documento XML ben formato o valido.
Ben formato
Esistono alcune regole specifiche per creare un documento XML ben formato:
- La dichiarazione XML deve venire prima in ogni documento.
- I commenti non sono validi all'interno di un tag. I commenti non possono contenere due trattini di fila, a parte l'inizio e la fine del commento.
- I tag devono avere un tag di fine o essere chiusi all'interno del tag singleton stesso, ad esempio.
- Tutti gli attributi dei tag devono essere tra virgolette, preferibilmente virgolette doppie, a meno che l'attributo stesso non contenga virgolette doppie.
- Ogni documento XML deve contenere un elemento che contenga completamente tutti gli altri elementi.
Ci sono solo due problemi con il documento che lo rendono non ben formato:
- La prima cosa di cui ha bisogno il documento AML è una dichiarazione di dichiarazione XML.
- L'altro problema è che nessun elemento racchiude completamente tutti gli altri elementi. Per risolvere questo problema, aggiungeremo un elemento contenitore esterno:
Apportare queste due semplici modifiche (e assicurarsi che tutti gli elementi contengano solo CDATA) trasformerà il documento non ben formato in un documento ben formato.
Un documento XML valido viene convalidato rispetto a una DTD (Document Type Definition) o a uno schema XML. Si tratta di un insieme di regole create dallo sviluppatore o da un'organizzazione di standard che definiscono la semantica del documento XML. Questi dicono al computer cosa fare con il markup.
Nel caso di About Linguaggio con marcatori, poiché questo non è un linguaggio XML standard, come XHTML o SMIL, il DTD verrebbe creato dallo sviluppatore. Quel DTD sarebbe molto probabilmente sullo stesso server del documento XML e referenziato nella parte superiore del documento.
Prima di iniziare a sviluppare un DTD o uno schema per i tuoi documenti, dovresti renderti conto che semplicemente per il fatto di essere ben formato, un documento XML è autodescrittivo e quindi non ha bisogno di un DTD.
Ad esempio, con il nostro documento AML ben formato, ci sono i seguenti tag:
Se hai familiarità con la newsletter di Web Writer, potresti riconoscere le diverse sezioni della newsletter. Ciò semplifica la creazione di nuovi documenti XML utilizzando lo stesso formato standard. Metteremmo sempre il titolo completo nel tag e l'URL della prima sezione nel tag.
DTD
Se ti viene richiesto di scrivere un documento XML valido, per utilizzare i dati o per elaborarli, lo includerai nel documento con il tag. In questo tag, definisci il tag XML di base nel documento e la posizione del DTD (di solito un URI Web).
Per esempio:
Una cosa bella delle dichiarazioni DTD è che puoi dichiarare che una DTD è locale nel sistema in cui è Il documento XML è con il "SYSTEM". Puoi anche puntare a un DTD pubblico, ad esempio con un documento HTML 4.0:
Quando si utilizzano entrambi, si dice al documento di utilizzare un DTD specifico (l'identificatore pubblico) e dove trovarlo (l'identificatore di sistema).
Infine, puoi includere un DTD interno direttamente nel documento, all'interno del tag DOCTYPE. Ad esempio (questo non è un DTD completo per il documento AML):
Schema XML
Per creare un documento XML valido, puoi anche utilizzare un documento XML Schema per definire il tuo XML. XML Schema è un documento XML che descrive documenti XML. Scopri come scrivere uno schema.
Nota
Il solo riferimento a un DTD o a uno schema XML non è sufficiente. L'XML che si trova nel documento deve seguire le regole del DTD o dello Schema. L'utilizzo di un parser di convalida è un modo semplice per verificare che il tuo XML segua le regole DTD. Puoi trovare molti di questi parser online.