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: failing docs #728

Merged
merged 4 commits into from
Jan 21, 2025
Merged

fix: failing docs #728

merged 4 commits into from
Jan 21, 2025

Conversation

MAfarrag
Copy link
Contributor

@MAfarrag MAfarrag commented Jan 20, 2025

Fix Documentation build (fix #727 )

  • the docs, and docs_release workflows are failing since version 0.5.2.
  • in this merge i build the docs locally and pushed it to the develop version after removing the mkdocs-jupyter dependency as it was the reason of the workflow failure.
  • I removed a template directory that was specified in the mkdocs.yml and does not exist in the docs directory which was also a reason why the docs build was not passing.

I added comments on the places where the changes are made.

failing tests locally in Winodws

  • I added Exception on all the shutil.rmtree that tries to delete previuos test files as sometimes it fails because of PermissionError, the deletion does not affect tests themselves.

Dev

  • Separated the dependencies related to mkdocs to a separate dependency group docs so that in the docs and the docs_release CI workflows we install this group of dependencies only and not everything.

markdown_extensions:
- pymdownx.highlight
- pymdownx.superfences
- admonition
- toc:
permalink: true
- pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg
emoji_index: !!python/name:material.extensions.emoji.twemoji
Copy link
Contributor Author

Choose a reason for hiding this comment

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

because of a deprication warning

@@ -41,18 +41,15 @@ plugins:
selection:
inherited_members: false

custom_templates: templates
Copy link
Contributor Author

Choose a reason for hiding this comment

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

template directory does not exist

- autorefs
- table-reader

Copy link
Contributor Author

Choose a reason for hiding this comment

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

table-reader gives error when it comes before the macros plugins

@@ -22,11 +22,11 @@ theme:
- navigation.top
plugins:
- search
- mkdocs-jupyter
Copy link
Contributor Author

Choose a reason for hiding this comment

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

mkdocs-jupyter gives an error of

[ModuleNotFoundError: No module named 'notebook.services' error](https://github.com/Deltares/HYDROLIB-core/pull/728/commits/04c398b3a121d5f7fec2e2fb1854e6763e625be5)

@MAfarrag
Copy link
Contributor Author

Hey @priscavdsluis @veenstrajelmer can you check this merge? Thanks

@MAfarrag MAfarrag added the type: bug Something isn't working label Jan 21, 2025
@MAfarrag MAfarrag merged commit 534bbe1 into main Jan 21, 2025
15 checks passed
@MAfarrag MAfarrag deleted the fix/documentation-build-in-ci branch January 21, 2025 12:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type: bug Something isn't working
Projects
None yet
Development

Successfully merging this pull request may close these issues.

github pages are failing
2 participants