new XProc for docs generation; cleanup and renaming

[wendellpiez]

Committer Notes

Includes new XProcs and scripts for running them.

Revisions to the core docs XProc expose more (intermediate) ports. Also, we have new or modified XProc and scripts for:

• generating a Hugo-read set of pages and exposing on ports
• writing the same set of pages to a path
• producing a standalone site with complete HTML+CSS

The PR addresses #42, with the exception of the requirement for total CSS configurability.

The capability to create and skin a standalone site is provided.

All Submissions:

• Have you followed the guidelines in our Contributing document?
• Have you checked to ensure there aren't other open Pull Requests for the same update/change?
• Have you squashed any non-relevant commits and commit messages? [instructions]
• Do all automated CI/CD checks pass?

Changes to Core Features:

• Have you added an explanation of what your changes do and why you'd like us to include them?
• Have you written new tests for your core changes, as applicable?
• Have you included examples of how to use your new feature(s)?
• Have you updated all website and readme documentation affected by the changes you made? Changes to the website can be made in the website/content directory of your branch.

[wendellpiez]

This branch includes a number of improvements to the docs generation pipeline, for maintainability.

Although interfaces (especially names and arguments of scripts) should not have changed, due diligence is always warranted.

[galtm]

Something doesn't look right.

1. "except Given" looks like the first sentence is missing its ending.
2. Is the sentence starting with "Given" supposed to be here?
3. Is the first sentence supposed to compare this pipeline to METASCHEMA-DOCS-DIVS-write.xpl (the one above) or METASCHEMA-DOCS-TESTSITE-write.xpl (the one below, which refers back to this one)?

[david-waltermire]

Provided some non-blocking comments.

[nikitawootten-nist]

As discussed, could you:

1. Add the scripts to the metaschema-xslt command
2. Adjust the help output to use the BASE_COMMAND environment variable (look at the existing scripts in the metaschema-xslt command for reference
3. Push up existing changes related to previous reviewer's comments