search

backstage / mkdocs-techdocs-core

The core MkDocs plugin used by Backstage's TechDocs as a wrapper around multiple MkDocs plugins and Python Markdown extensions
Apache License 2.0
87 stars 64 forks source link

Incompatible with latest mkdocs-material #42

Closed Evgenus closed 2 years ago

Evgenus commented 3 years ago 
Because no versions of mkdocs-techdocs-core match >0.1.2,<0.2.0 and mkdocs-techdocs-core (0.1.2) depends on mkdocs-material (5.3.2), mkdocs-techdocs-core (>=0.1.2,<0.2.0) requires mkdocs-material (5.3.2).
So, because the-book depends on both mkdocs-material (^7.2.6) and mkdocs-techdocs-core (^0.1.2), version solving failed.
kim5566 commented 2 years ago

Similar issue here. The outdated mkdocs-material causing problems in our app.

andrewthauer commented 2 years ago

Afaik, this is currently intentional. Themkdocs-material theme was updated around v5.4.x to render the HTML in a way that is currently not compatible with the techdocs Reader component. So this is why it's currently pinned to the version it is since it's known to work with the reader component.

chainyo commented 2 years ago

Hi the pinned version of mkdocs-material is 3 major updates late. Do you plan upgrading it soon ?