Как создать документацию из документов XML?

Question

Мне дали набор XML документы от компании, которая должна включать "документацию" XML схемы. Нет XSDs предоставлена.

Как я могу генерировать документацию (например, HTML или же CHM) из этих XML-документов, которые включают документацию, указанную ниже?

Вот пример содержимого XML:

<ELEMENT1>

  <!--
  documentation text ....
  -->
  <ELEMENT2>
    <ELEMENT3>ABC</ELEMENT3>
  </ELEMENT3>

  <!--
  documentation text ....
  -->
  <ELEMENT4>
    <ELEMENT5>0534564117</ELEMENT5>
    <ELEMENT6>123456</ELEMENT6>
    <ELEMENT7>090314b4-fc7d-42c5-b382-a5b745671ee32b</ELEMENT7>
  </ELEMENT4>

</ELEMENT1>

Answer 1

Для решения вашей проблемы может быть решение. Но это потребует некоторой работы:

1. Генерация XSD из файлов XML (например, с помощью trang -> tutorial)
2. Добавьте документацию к произведенному файлу XSD (используя <xs:annotation/> элементы)
3. Генерация документации из XSD (с xs3p)

Все инструменты здесь бесплатны. Но если вы можете заплатить, у oXygen есть очень мощные возможности.