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

Mkdocs updates to allow community PRs to pass the build.yml check/workflow #690

Merged
merged 21 commits into from
Nov 22, 2023

Conversation

qwahzi
Copy link
Collaborator

@qwahzi qwahzi commented Nov 20, 2023

This PR updates mkdocs to the latest standard version, resolves deprecated mkdocs config options (materialx.emoji.twemoji and social.cards_color), & allows the build workflow to run/pass for community PRs

The next/final step to allowing community PRs to pass the build checks (specifically the publish jobs) will probably be to update the Dockerfile & publish workflows to use a standard mkdocs image as well

Update Dockerfile to use mkdocs-material
Update build.yml for mkdocs
Update requirements.txt with mkdocs & dependencies
Update publish-docker-pr.yml for mkdocs
Update publish-docker-master.yml with mkdocs
Fixing mkdocs build --strict issues:

INFO    -  DeprecationWarning: 'materialx.emoji.twemoji' is deprecated.
           Material emoji logic has been officially moved into mkdocs-material
           version 9.4. Please use Material's 'material.extensions.emoji.twemoji'
           as mkdocs_material_extensions is deprecated and will no longer be
           supported moving forward. This is the last release.

             File "/home/default/.local/lib/python3.10/site-packages/materialx/emoji.py", line 106, in twemoji
               return _patch_index(options)
             File "/home/default/.local/lib/python3.10/site-packages/materialx/emoji.py", line 59, in _deprecated_func
               warnings.warn(
WARNING -  Material emoji logic has been officially moved into mkdocs-material
           version 9.4. Please use Material's 'material.extensions.emoji.twemoji'
           as mkdocs_material_extensions is deprecated and will no longer be
           supported moving forward. This is the last release.
WARNING -  Config value 'plugins': Plugin 'material/social' option 'cards_color': Deprecated, use 'cards_layout_options.background_color' and 'cards_layout_options.color' with 'default' layout
Update requirements.txt with material[imaging]
Testing mkdocs workflow change
Update Dockerfile mkdocs
Update Dockerfile w/ pip upgrade
Update Dockerfile pip commands
@qwahzi qwahzi changed the title Mkdocs updates Mkdocs updates to allow community PRs to pass the build.yml check/workflow Nov 20, 2023
@qwahzi qwahzi marked this pull request as ready for review November 20, 2023 16:38
Remove extra pip install on deploy-staging.yml to mirror the publish workflows
Remove extra pip install on deploy.yml to mirror publish workflows
Update Dockerfile to squidfunk/mkdocs-material
Update publish-docker-master.yml with squidfunk/mkdocs-material:latest
…th squidfunk/mkdocs-material:latest

Update publish-docker-pr.yml with Update publish-docker-master.yml with squidfunk/mkdocs-material:latest
Remove old theme info from readme.md
.github/workflows/publish-docker-master.yml Outdated Show resolved Hide resolved
.github/workflows/publish-docker-pr.yml Outdated Show resolved Hide resolved
@thsfs thsfs merged commit 0abbcfb into main Nov 22, 2023
2 checks passed
@thsfs thsfs deleted the mkdocs-update branch November 22, 2023 18:53
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.

2 participants