search

PowerShell / platyPS

Write PowerShell External Help in Markdown
MIT License
765 stars 149 forks source link

Where can I find schema for `*-help.xml`? #590

Closed metablaster closed 1 year ago

metablaster commented 1 year ago

Summary of the new feature / enhancement

In VSCode I use XML extension from Red Hat which allows to validate xml file if bound to an actual schema (.xsd or .dtd) file.

I've searched and googled for hours trying to find the schema file for *-help.xml which the PlatyPS generates. I would like to validate generated *-help.xml files but without schema file that's impossible.

Where can I find it?

EDIT:

I have found only this schema, but *-Help.xml don't seem to follow it PSMaml

It appears that there is some other magic behind how PlatyPS generates help files, but that I don't know.

Proposed technical implementation details (optional)

Provide a public link to XSD schema file so that users can validate their generated files.

sdwheeler commented 1 year ago

The schema files are stored in $PSHOME/Schemas/PSMaml. The MAML format is made up of multiple schemas.