ERROR - Config value 'plugins': The "minify" plugin is not installed

[kuhlaid]

Context

No response

Bug description

I forked the latest version mkdocs-material-9.5.33 and tried to get it pushed to GitHub Pages. After creating a workflow action in GitHub as outlined in https://squidfunk.github.io/mkdocs-material/publishing-your-site/ the action failed with ERROR - Config value 'plugins': The "minify" plugin is not installed. I have not altered the code nor performed any other actions outside of GitHub.

Related links

• Reporting a bug

Reproduction

NA

Steps to reproduce

1. Fork the latest version mkdocs-material-9.5.33
2. Create a workflow action in GitHub as outlined in https://squidfunk.github.io/mkdocs-material/publishing-your-site/
3. Action fails with ERROR - Config value 'plugins': The "minify" plugin is not installed.

Browser

Edge

Before submitting

• I have read and followed the bug reporting guidelines.
• I have attached links to the documentation, and possibly related issues and discussions.
• I assure that I have removed all customizations before submitting this bug report.
• I have attached a .zip file with a minimal reproduction using the built-in info plugin.

[squidfunk]

Moving to discussions, as this is clearly a support request.

[kuhlaid]

This seems like a bug in the configuration. I do not see any mention of minify in the list of built-in plugins under https://squidfunk.github.io/mkdocs-material/plugins/?h=plugin so where is the minify plugin coming from if it is not built-in?

[kamilkrzyskow]

Hello @kuhlaid,
the workflow in the publishing guide installs the theme, builds mkdocs together with the deployment:

- run: pip install mkdocs-material 
- run: mkdocs gh-deploy --force

ERROR - Config value 'plugins': The "minify" plugin is not installed

This is caused due to your mkdocs.yml file containing the minify plugin, but you didn't install it separately.

You can do so by installing the extra recommended packages:
Replace this pip install mkdocs-material with pip install mkdocs-material[recommended].

Another approach is also to add one more step in the workflow before mkdocs is built:
Add a run: pip install mkdocs-minify-plugin step.

BTW I'm curious how there is the minify plugin in your mkdocs.yml file and you don't know where it came from? Where did you get the mkdocs.yml file from?

EDIT: There is also the other plugin:

• https://github.com/monosans/mkdocs-minify-html-plugin
  but it has a different API than the more common mkdocs-minify-plugin

Note

GitHub is bugged recently and I get no notifications for discussions converted from Issues 🤔, I found this by chance

[kamilkrzyskow]

@kuhlaid
Have you resolved the issue?

[kuhlaid]

Like I said, I did not create nor change any of the code. I simply forked the repo 'as is' and tried to get GitHub pages to build the site.

[kamilkrzyskow]

Like I said, I did not create nor change any of the code

Not true, you did create a custom workflow file based on the publishing guide, and this expects you to follow the previous Installation and Creating your site instructions, to create an example bare MkDocs project mkdocs new . with the Material theme enabled. The minify plugin isn't enabled there, so it's not added to the publishing guide.

The repository in itself uses a custom repository-specific mkdocs.yml file, which enables the minify plugin and requires different processes enabled that are present in the documentation.yml workflow file, like I mentioned in my comment above.
In general there is a lot of custom stuff added to the workflow, so better don't use it as is, just take out the installation of additional dependencies and include it in your custom workflow based on the publishing guide.

• mkdocs-material/mkdocs.yml

  Lines 99 to 100 in d95e0e6

  	- minify:
  	minify_html: true

• mkdocs-material/.github/workflows/documentation.yml

  Lines 71 to 74 in d95e0e6

  	- name: Install Python dependencies
  	run: |
  	pip install mkdocs-material
  	pip install .[recommended,git,imaging]

[kamilkrzyskow]

You could also follow along with the https://squidfunk.github.io/mkdocs-material/tutorials/ as there are templates you should be able to use as-is, while following along with the tutorial.