Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Requirements for Metanorma to process documentation for XSD in adoc #5

Open
Intelligent2013 opened this issue Feb 27, 2021 · 2 comments
Labels
enhancement New feature or request

Comments

@Intelligent2013
Copy link
Contributor

Intelligent2013 commented Feb 27, 2021

In order to generate documentation for XSD, XML object parser in Metanorma should support:

  • process xml namespaces
    • setup namespaces
    • specify namespaces in element names, like xsd:element
  • specify XPath expressions, it is necessary for these features:
    • iterate all nested elements xsd:element independent of depth, for example xsd:schema//xsd:element allows to select xsd:element in structure like xsd:schema/xsd:complexType/xsd:sequence/xsd:element;
    • access to ancestor element, for example ancestor::xsd:complexType/@name allows to know the type which uses this element/attribute;
    • find nodes by condition, for example //*[@type = $typename] - find nodes with attribute type equals to value from variable typename,
  • support {%include ... %} feature with parameters like this: {% include_relative typeref.adoc ref=type %} - pass named parameter ref with value type into module typeref.adoc (example you can see here: https://raw.githubusercontent.com/unitsml/schemas/xsd_liquid/adoc/index.adoc)
@Intelligent2013 Intelligent2013 added the enhancement New feature or request label Feb 27, 2021
@Intelligent2013 Intelligent2013 changed the title DRAFT: requirements for Metanorma to process documentation for XSD Requirements for Metanorma to process documentation for XSD in adoc Mar 1, 2021
@opoudjis
Copy link

opoudjis commented Mar 8, 2021

My only reaction to all of this: I shouldn't be the one doing this, this should be a lutaml plugin or equivalent. (A lutaml preprocessor?) I nominate @w00lf. But then, I would...

@ronaldtse
Copy link
Contributor

This is to be implemented in metanorma/metanorma#203.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

3 participants