search

bitfehler / xs3p

Modernized fork of the xs3p XSD documentation tool - using bootstrap, markdown and HTML5.
Other
44 stars 41 forks source link

Nested documentation nodes #6

Open MaximilianKresse opened 7 years ago

MaximilianKresse commented 7 years ago

The problem:

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            targetNamespace="http://www.setasign.com/Konquadrat/Dashboard"
            xmlns="http://www.setasign.com/Konquadrat/Dashboard"
            elementFormDefault="qualified">

    <xsd:element name="dashboard" type="dashboard"/>

    <xsd:complexType name="dashboard">
        <xsd:sequence>
            <xsd:choice minOccurs="0" maxOccurs="unbounded">
                <xsd:element name="diagramWidget" type="rectWidget"/>
            </xsd:choice>
        </xsd:sequence>
    </xsd:complexType>

    <xsd:complexType name="diagramWidget">
        <xsd:annotation>
            <!-- Works fine! -->
            <xsd:documentation>...</xsd:documentation>
        </xsd:annotation>
        <xsd:all>
            <xsd:element name="x" type="xsd:integer" minOccurs="0">
                <xsd:annotation>
                    <!-- Works fine! -->
                    <xsd:documentation>...</xsd:documentation>
                </xsd:annotation>
            </xsd:element>
            <xsd:element name="colors" minOccurs="0">
                <xsd:annotation>
                    <!-- Works fine! -->
                    <xsd:documentation>...</xsd:documentation>
                </xsd:annotation>
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element name="color" type="xsd:normalizedString" maxOccurs="unbounded">
                            <xsd:annotation>
                                <!-- DOESN'T WORK! -->
                                <xsd:documentation>...</xsd:documentation>
                            </xsd:annotation>
                        </xsd:element>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
        </xsd:all>
    </xsd:complexType>
</xsd:schema>

The documentation block in diagramWidget//colors//color will not be found by the template hiddendoc. And so the modal window for this will not be generated. The (i) button will be shown for this node but nothing happens if you click on it.

This behavior can be observed for all nested documentation blocks.