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.

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

fix for configuration file documentation images #134

Merged
merged 2 commits into from
Sep 10, 2024

Conversation

TeaganKing
Copy link
Collaborator

This addresses #133 to ensure that images are rendering correctly in the configuration file documentation page. This works locally.

  • Have you followed the guidelines in our Contributor's Guide (including the pre-commit check)?
  • Have you checked to ensure there aren't other open Pull Requests for the same update/change?
  • Does your submission pass tests?
  • Have you lint your code locally prior to submission?
  • Have you successfully tested your changes locally?

Note there was a slight modification from @mnlevy1981 's suggestion in order for this to work properly during testing.
[_static/images/config_1.png](view-source:https://ncar.github.io/images/config_1.png) --> _static/images/config_1.png

@TeaganKing TeaganKing self-assigned this Sep 10, 2024
@TeaganKing TeaganKing added bug Something isn't working documentation Improvements or additions to documentation labels Sep 10, 2024
docs/conf.py Outdated
Comment on lines 38 to 47
# Copy images into ${CUPID}/docs/_static/images/
for file in [
"config_1.png",
"config_2.png",
"config_3.png",
"config_4.png",
"config_5.png",
]:
os.system(f"cp ../images/{file} ../docs/_static/images/")

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking a little closer, docs/_static/images/ is under version control in this repository... can we just do a single

$ git mv images/* docs/_static/images/

Instead of having this copy in conf.py? Given the current structure of _static/ it might even make sense to move them to docs/_static/images/config/ and then update config.md to point to the new location.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good idea! I just made that change. Things still build as expected locally.

Copy link
Collaborator

@mnlevy1981 mnlevy1981 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great!

@mnlevy1981 mnlevy1981 merged commit c8c336f into NCAR:main Sep 10, 2024
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Images for config file were showing up during testing but are not showing up in documentation
2 participants