I have just released DocumenterVitepress 0.2 which is breaking, so your docs workflows will break unless you have compat set to 0.1. Many people don’t have compat settings in their docs/Project.toml (myself included) so that’s something one should add for the future.

Please check the README for updated build/deploy instructions, a short description of the breaking changes is in the changelog.

The reason for the breaking release is that the deploy process for DocumenterVitepress was fundamentally broken. Many DocumenterVitepress sites have recently been serving 404s on the stable suburl.

That’s because Documenter’s deploydocs creates symlinks on gh-pages , for example, stable as an alias for v1.2.3 , but vitepress sites may break if they live under a different sub-url than what they were originally rendered for. So 0.2 will render a separate site for each base and there’s a new DocumenterVitepress.deploydocs function to handle that multi-site folder structure.

8 Likes