Skip to content

Help to Sphinx#2145

Open
cpaulgilman wants to merge 26 commits intodevelopfrom
help-to-sphinx
Open

Help to Sphinx#2145
cpaulgilman wants to merge 26 commits intodevelopfrom
help-to-sphinx

Conversation

@cpaulgilman
Copy link
Collaborator

Description

This is a major reworking of SAM's Help system to migrate from proprietary Help & Manual to open source Sphinx documentation.

For high-level build instructions for Windows, see https://github.com/NatLabRockies/SAM/wiki/Windows-Build-Instructions#9-build-help-optional (also on Mac and Linux build instructions).

For detailed build instructions and information, see https://github.com/NatLabRockies/SAM/blob/help-to-sphinx/README.md.

Fixes #2110

Corresponding branches and PRs:

Build from Develop branches of SSC, WEX, LK and SAM-private.

Unit Test Impact:

None.

Checklist

  • requires help revision and I added that label
  • adds, removes, modifies, or deletes variables in existing compute modules
  • adds a new compute module
  • changes defaults
  • [ X ] I've tagged this PR to a milestone

* Use native web browser to display Help
* Use `wxHtmlWindow` to display version information regardless of platform
* Move old files from `doc` folder to `SAM-documentation` repo. These are developer notes on old issues before we had the SAM Documentation repo.
* Add new .rst source files for Sphinx-generated Help to `doc` folder.
* Delete old HTML help files generated by Help & Manual from `runtime` folder.
Help ID is path to HTML file with no extension <folder>/<filename>. For example Help ID "battery-storage/battery_dispatch_fom" points to battery_dispatch_fom.html in "/help/html/battery-storage" folder.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Dead links in help to fix for 2025 fall release

1 participant