La documentazione HTML generata dallo schema XML contiene diverse informazioni
relative allo schema come il suo nome, la posizione e lo spazio nome, e anche i dettagli relativi a vari componenti(come gli elementi o i tipi complessi) contenuti nello schema. Può essere molto utile per fornire un riepilogo dei contenuti dello
schema.
Le seguenti istruzioni sono state scritte per la prospettiva Risorsa, ma queste funzionano in molte
altre prospettive.
Per generare la documentazione HTML in base al file dello
schema XML:
- Nella vista Schema, fare clic con il pulsante destro del mouse sullo schema XML.
- Fare clic su . Si apre la finestra Genera documentazione schema XML.
- Selezionare lo stile della documentazione HTML che si desidera:
- Se si desidera che un file HTML contenga tutte le informazioni, selezionare File
HTML singolo con nessun frame.
- Altrimenti, selezionare Più file HTML con i frame. Se si seleziona questa opzione, sono generati diversi file HTML invece che solo uno. Questi verranno impostati in un modo simile ai file Javadoc.
- Se è stato selezionato File HTML singolo con nessun frame,
è possibile fare clic su Fine e il file HTML verrà automaticamente
generato con lo stesso nome del file di origine e nella stessa posizione,
o è possibile fare clic su Avanti per selezionare la cartella
in cui si desidera creare la documentazione HTML e specificare il nome del file
HTML, quindi fare clic su Fine. Il file HTML viene creato. È ora possibile aprirlo nell'editor HTML.
- Se è stato selezionato Più file HTML con frame, fare clic su Avanti per specificare la cartella di destinazione per i file HTML, quindi fare clic su Fine. I file HTML sono creati nella posizione specificata.
La documentazione HTML contiene le seguenti informazioni:
- Il nome dello schema.
- La posizione dello schema.
- Lo spazio nome di destinazione dello schema.
- La documentazione fornita nello schema.
- Le informazioni relative ad ogni componente nello schema, come il tipo di componente ed il suo codice di origine. Altre informazioni relative al componente possono essere fornite in base al componente.
Quando viene selezionata la codifica logica dell'Ebreo (ISO-8859-8-I) come preferenza per la codifica dei file HTML ( nella sezione "Creazione di file"), i file della documentazione HTML generati da un file di schema XML avranno ancora una codifica UTF-8.
Questo è un problema noto.