Add reference section - Githubissues

otabuzzman / chartacaeli-web

A web frontend to the Charta Caeli star chart creation tool.

MIT License

0 stars 0 forks source link

Add reference section #3

Open otabuzzman opened 5 years ago

otabuzzman commented 5 years ago

Cues on XSD2DOC in SO #237938.

xs3p example

cd /usr/src ; git clone https://github.com/bitfehler/xs3p.git
cd chartacaeli ; xsltproc \
  --stringparam sortByComponent false \
  --stringparam title "The Charta Caeli chart specification" \
  --nonet --output chart-specification.html ../xs3p/xs3p.xsl chartacaeli.xsd

otabuzzman commented 5 years ago

xs3p recognizes documentation provided in XSD.
xs3p restricted to one xs:pattern element (known issue).

otabuzzman commented 4 years ago

Documentation modals for attributes don't work in case of attributes defined for typed elements (specialization). Examples are ChartAzimuthal@projection, ChartPseudoCylindrical@projection, AnnotationStraight@radiant, and AnnotationStraight/Frame@anchor.

HTML source inspection shows that xs3p creates id but no HTML for modal dialog.

otabuzzman commented 4 years ago

xs3p renders @source to "Linked documentation ...". XPath function unparsed-text supposed to render file content. Function is part of XSLT 2.0, thus needs Saxon instead of xsltproc.