mkdocs-material: Meta and other plugins no longer appear to be built-in
Context
New error
Docs built fine last week, now the meta plugin doesn’t appear to be built in any longer.
The docs say:
The built-in meta plugin allows to set front matter per folder, which is especially handy to ensure that all pages in a folder use specific templates or tags. Add the following lines to mkdocs.yml:
Bug description
Error when using the meta plugin:
ERROR - Config value 'plugins': The "meta" plugin is not installed
Aborted with 1 Configuration Errors!
Related links
- Reporting a bug
- The docs say:
The built-in meta plugin allows to set front matter per folder, which is especially handy to ensure that all pages in a folder use specific templates or tags. Add the following lines to mkdocs.yml:
Reproduction
Install the latest insiders build.
In mkdocs.insiders.yml
INHERIT: mkdocs.yml
plugins:
meta:
Steps to reproduce
Install the latest insiders build.
In mkdocs.insiders.yml
INHERIT: mkdocs.yml
plugins:
meta:
Browser
Chrome
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.
About this issue
- Original URL
- State: closed
- Created a year ago
- Comments: 19 (9 by maintainers)
@nandoflorestan are you subscribed as a sponsor and using Insiders? The
metaplugin is currently reserved to sponsors, is built-in, and doesn’t need to be installed (it’s installed alongside Material for MkDocs), but only if you’re using Insiders.The heart icon denotes that a feature is reserved to sponsors:
I’d be happy to, but I’m not sure what it was. 🙂
I’m closing this issue as non-reproducible (for now). If you manage to create a reproduction that allows to observe what you’re reporting, we’ll reopen it. Make sure that you did not install Insiders in a different location than before. As I showed in https://github.com/squidfunk/mkdocs-material/issues/5695#issuecomment-1626898951, installing Insiders in a clean virtual environment works as expected. Possible help in debugging:
In the past, I tripped over the same problem when I forgot to activate the virtual environment before installing. If the error persists, execute the following and check if the correct version is installed:
Make sure that you selected Material for MkDocs as a theme. In your OP, you’re using configuration inheritance. It may be possible that the following is not set, which is essential for the built-in plugins to work:
Try to use the fully qualified name of the plugin:
@ossinova correct, you currently need to install 9.2.0b0 😊