Génération de documentation HTML à partir d'un fichier de schéma XML

La documentation HTML générée à partir d'un schéma XML contient différentes informations sur le schéma comme son nom, son emplacement et son espace de nom, ainsi que des détails sur différents composants (comme des éléments ou des types complexes) contenus dans le schéma. Cela peut être très utile pour fournir un résumé du contenu de votre schéma.

Les instructions suivantes ont été écrites dans la perspective Ressource, mais elles fonctionneront également dans de nombreuses autres perspectives.

Pour générer une documentation HTML basée sur un fichier de schéma XML :

  1. Dans la vue Structure, cliquez avec le bouton droit de la souris sur le schéma XML.
  2. Cliquez sur Générer > Doc HTML. La boîte de dialogue Générer une documentation de schéma XML s'ouvre.
  3. Sélectionnez le style de la documentation HTML que vous voulez :
    1. Si vous voulez qu'un seul fichier HTML contienne toutes les informations, sélectionnez Fichier HTML unique sans cadres.
    2. Sinon, sélectionnez Fichiers HTML multiples avec cadres. Si vous sélectionnez cette option, plusieurs fichiers HTML sont générés au lieu d'un seul. Ils seront configurés de la même manière que les fichiers Javadoc.
  4. Si vous avez sélectionné Fichier HTML unique sans cadres, vous pouvez cliquer sur Terminer et le fichier HTML sera automatiquement généré avec le même nom que le fichier source et dans le même emplacement ou vous pouvez cliquer sur Suivant pour sélectionner le dossier dans lequel vous voulez créer la documentation HTML et spécifier le nom du fichier HTML, puis cliquez sur Terminer. Le fichier HTML est créé. Vous pouvez maintenant l'ouvrir dans l'éditeur HTML.
  5. Si vous avez sélectionné Fichiers HTML multiples avec cadres, cliquez sur Suivant pour spécifier le dossier cible pour vos fichiers HTML, puis cliquez sur Terminer. Les fichiers HTML sont créés à l'emplacement spécifié.

La documentation HTML contient les informations suivantes :

Lorsque l'encodage logique hébreu (ISO-8859-8-I) est sélectionné comme préférence pour l'encodage des fichiers HTML (Fenêtre > Préférences > Fichiers Web et XML > Fichiers HTML dans la section "Lors de la création de fichiers"), les fichiers de documentation HTML générés à partir d'un fichier de schéma XML auront toujours un encodage UTF-8. Il s'agit d'un incident recensé.

Concepts associés
Génération de fichiers à partir de schémas XML
Tâches associées
Création de schémas XML

Vos commentaires