Бесплатный инструмент для автоматического документирования XSD

Когда вы создаете XML для некоторой коммуникации или как файл конфигурации, вы, вероятно, захотите объяснить другим, как этот файл работает. Какой тег для чего используется.

Сначала вы создадите XSD, где определите, как создавать и использовать XML. И есть теги annotation и documentation, чтобы лучше это объяснить. Но есть ли инструмент для преобразования XSD в документацию, более удобную для чтения обычным пользователям? Например, в наборе html файлов или в tex или pdf файле.

Если бы в нем были изображения отношений, это было бы еще лучше, но это не обязательно.


xml xsd documentation-generation
person Srđan Popić    schedule 27.09.2017    source источник
comment
Этот инструмент может это сделать, но он платный. xygenxml.com/xml_editor/xml_schema_diagram_editor.html   -  person Srđan Popić    schedule 28.09.2017

Ответы (1)


arrow_upward
1
arrow_downward

Это могло быть единственным решением, которое я нашел.

Используя этот xsl https://en.wikipedia.org/wiki/Xs3p, XSD можно преобразован в HTML. Вам нужно только скомпилировать XSD и XSL. Вот пример на Python:

import lxml.etree as ET

dom = ET.parse('MY_XML_SCHEMA.xsd')
xslt = ET.parse('xs3p.xsl')
transform = ET.XSLT(xslt)
newdom = transform(dom)
with open('MY_XML_SCHEMA.html', 'w') as html:
    html.write(ET.tostring(newdom, pretty_print=True))
person Srđan Popić    schedule 28.09.2017