search

jimporter / mike

Manage multiple versions of your MkDocs-powered documentation via Git
BSD 3-Clause "New" or "Revised" License
511 stars 45 forks source link

Deploying docs fails with `error: File is not a zip file` #215

Closed kylebarron closed 3 months ago

kylebarron commented 3 months ago

Summary

In https://github.com/developmentseed/lonboard I have a CI script that deploys mike-based documentation. Publishing docs from CI worked fine for the v0.7.1 tag but failed for the v0.8.0 tag. It fails with only the text error: File is not a zip file.

If it's an issue on my side, it would have to be in this changeset. I don't see anything that specifically jumps out at me, but error: File is not a zip file isn't so descriptive that I know where to look.

I don't usually test building the docs on each pull request, but tomorrow I can go through git bisect for each PR and test mike deploy on each commit if that's helpful. poetry run mkdocs build still works.

Configuration and Logs

Steps to Reproduce

Expected Behavior

Additional Context

jimporter commented 3 months ago

I don't usually test building the docs on each pull request, but tomorrow I can go through git bisect for each PR and test mike deploy on each commit if that's helpful. poetry run mkdocs build still works.

Bisecting would definitely help, yeah. You can also get more information about the error by calling mike --debug deploy. That'll print the full backtrace. I'm not sure where the issue would be in mike though, since mike doesn't (intentionally) use zip files anywhere. Perhaps it's another misbehaving plugin?

kvanzuijlen commented 3 months ago

Please check the version of your mkdocs-material dependency. It had to be updated because a Google download was no longer available, see details here: https://github.com/squidfunk/mkdocs-material/issues/6983

kylebarron commented 3 months ago

Please check the version of your mkdocs-material dependency. It had to be updated because a Google download was no longer available, see details here: squidfunk/mkdocs-material#6983

Ah thanks, this was the fix! Sorry for the noise!