Generowanie dokumentacji HTML na podstawie pliku schematu XML

Dokumentacja HTML wygenerowana na podstawie schematu XML zawiera rozmaite informacje o schemacie, takie jak jego nazwa, położenie i przestrzeń nazw, a także szczegółowe informacje o rozmaitych komponentach (na przykład elementach lub typach złożonych) zawartych w tym schemacie. Może być bardzo przydatna, dostarczając podsumowanie zawartości schematu.

Poniższe instrukcje zostały napisane pod kątem perspektywy Zasób, lecz można je zastosować również do wielu innych perspektyw.

Aby wygenerować dokumentację HTML na podstawie pliku schematu XML:

  1. W widoku Schemat prawym przyciskiem myszy kliknij schemat XML.
  2. Kliknij kolejno opcje: Generuj > Dokument HTML. Otwarte zostanie okno dialogowe Generowanie dokumentacji schematu XML.
  3. Wybierz styl potrzebnej dokumentacji HTML:
    1. Jeśli chcesz uzyskać jeden plik HTML zawierający wszystkie informacje, wybierz opcję Pojedynczy plik HTML bez ramek.
    2. W przeciwnym razie wybierz opcję Wiele plików HTML z ramkami. Jeśli zostanie wybrana ta opcja, wygenerowanych zostanie kilka plików HTML zamiast tylko jednego. Będą one skonfigurowane w sposób podobny do plików dokumentacji Javadoc.
  4. Jeśli została wybrana opcja Pojedynczy plik HTML bez ramek, możesz kliknąć przycisk Zakończ, aby automatycznie wygenerować plik HTML o tej samej nazwie, co plik źródłowy, i w tym samym miejscu, albo kliknąć przycisk Dalej, aby wybrać folder, w którym ma zostać utworzona dokumentacja HTML, oraz określić nazwę pliku HTML, a następnie kliknąć przycisk Zakończ. Utworzony zostanie plik HTML. Teraz będzie go można otworzyć w edytorze HTML.
  5. Jeśli została wybrana opcja Wiele plików HTML z ramkami, kliknij przycisk Dalej, aby określić folder docelowy dla plików HTML, następnie kliknij przycisk Zakończ. Pliki HTML zostaną utworzone w określonym położeniu.

Dokumentacja HTML będzie zawierała następujące informacje:

Gdy jako preferowane kodowanie plików HTML (Okno > Preferencje > Pliki WWW i XML > Pliki HTML w sekcji "Podczas tworzenia plików"), wybrane jest kodowanie Hebrew Logical (ISO-8859-8-I), to mimo to pliki dokumentacji HTML generowane na podstawie pliku schematu XML będą mieć kodowanie UTF-8. Jest to znany problem.

Pojęcia pokrewne
Generowanie plików na podstawie schematów XML
Zadania pokrewne
Tworzenie schematów XML

Opinie