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.

Sign up for GitHub

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

Jump to bottom

Production of HTML and PDF (rendered) catalogs - maintenance #630

Closed
3 tasks
wendellpiez opened this issue Feb 26, 2020 · 3 comments
Closed
3 tasks

Production of HTML and PDF (rendered) catalogs - maintenance #630

wendellpiez opened this issue Feb 26, 2020 · 3 comments
Assignees
@wendellpiez
Labels
enhancement User Story

Comments

@wendellpiez
Copy link
Contributor

User Story:

In usnistgov/oscal-xslt#9 we produced basic rendering capability for HTML and PDF versions of OSCAL catalogs.

However, since then models have also changed somewhat especially respecting back matter, resulting in poor rendering of some sections.

XSLTs need to be updated accordingly.

Goals:

Updated rendering logic will not be perfect, but it will be better. To accomplish this:

Dependencies:

  • The working branch where these XSLTs are being developed should be rebased to all the current models.
  • The catalog model should be stable when this is addressed.

Acceptance Criteria

  • All OSCAL website and readme documentation affected by the changes in this issue have been updated. Changes to the OSCAL website can be made in the docs/content directory of your branch.
  • A Pull Request (PR) is submitted that fully addresses the goals of this User Story. This issue is referenced in the PR.
  • The CI-CD build process runs without any reported errors on the PR. This can be confirmed by reviewing that all checks have passed in the PR.
@wendellpiez wendellpiez mentioned this issue Sep 7, 2023
Open
5 tasks
@wendellpiez wendellpiez mentioned this issue Mar 13, 2020
Closed
4 tasks
wendellpiez added a commit to wendellpiez/oscal-tools that referenced this issue Mar 13, 2020
@wendellpiez
Updating to support current resource model addresses usnistgov/OSCAL#630
cac8ba0
@wendellpiez wendellpiez mentioned this issue Mar 13, 2020
Merged
@wendellpiez wendellpiez self-assigned this Mar 19, 2020
@wendellpiez
Copy link
Contributor Author

Update March 19

Adding this to Sprint 28 since it has advanced this week. (Prompted by work producing the SP800-53 rev 5 OSCAL.)

In fact this is nearly ready to go -- see usnistgov/oscal-tools#4 and related PR.

@david-waltermire david-waltermire added this to the Tools and Utilities milestone Mar 27, 2020
@wendellpiez
Copy link
Contributor Author

@david-waltermire-nist Let's look at what is in my branch currently and discuss the problem of supporting Apache FOP?

Our most pressing issue is that while FOP can be integrated with an XSLT 2.0/3.0 transformation easily enough (calling Saxon inside various runtimes such as XProc or the IDE) -- this is not supported by FOP as packaged by their script. This means users cannot just download and run.

@wendellpiez wendellpiez mentioned this issue Sep 7, 2023
Open
3 tasks
david-waltermire pushed a commit to usnistgov/oscal-tools that referenced this issue Apr 2, 2020
@wendellpiez
Initial XSLT for producing OSCAL catalogs in HTML and PDF (#5)
b8a8b89 
* Porting XSLT and CSS from OSCAL repo

* Touchups to resource list

* Updating to support current resource model addresses usnistgov/OSCAL#630

* Refinements on citation linking

* Small adjustment to display CSS

* Adding utility XSLT for (utility) catalog flattening (e.g., for spreadsheet import)

* Small enhancement to flattener; update to readme

* Further refinement to flattener (parameter resolution)

* Small refinements

* Repairing template match class; default title handling

* More guidance

* More work on readme

* Extending readme docs

* Added readme at top
@david-waltermire
Copy link
Contributor

This has been addressed by usnistgov/oscal-tools#5.

@aj-stein-nist aj-stein-nist removed this from the Tools and Utilities milestone Jul 27, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@wendellpiez wendellpiez

Labels
enhancement User Story
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@wendellpiez @david-waltermire @aj-stein-nist