-
-
Notifications
You must be signed in to change notification settings - Fork 1.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Versioning #109
Comments
Well there is another workaround. Move your old docs to a subdomain. Then you can write config like this: import { defineConfig } from 'vitepress'
export default defineConfig({
themeConfig: {
nav: [
{
text: 'v3 (stable)',
items: [
{
text: 'v2 (legacy)',
link: 'https://v2.vuejs.org/'
}
]
}
]
}
}) It will be rendered like this: |
hi again @brc-dd - do you have recommended practices on moving old versions to subdomain? if you do, have you seen anyone do this on github pages? we're thinking of moving another docs site to vitepress, but this is the one remaining blocker |
+1 this would really be essential. I'm trying to think of how to build this in VitePress, but I'm not sure at the moment. |
I’m pretty sure this is just done with multiple sidebars. Just move your versioned docs to a subfolder with the version in them. You can then add a link to the nav where a user selects the version, and on change, the correct sidebar will show. |
I've utilized multiple sidebars, a nav switcher etc. to create a versioning example that should suffice for most projects until proper versioning support is added. You can view it here: Im unsure how to make it a library, or whether it's even worth being a library |
I would not consider this a workaround primarily because it assumes you have a domain. For users that use GitHub Pages without a custom domain, it is not possible. A workaround, in my opinion, is something that can be done purely within the constraints of VitePress. The approaches that @drwpow and @IMB11 provided I would consider workarounds. |
I actually ended up turned my example into a proper plugin/library: https://www.npmjs.com/package/vitepress-versioning-plugin |
Is your feature request related to a problem? Please describe.
Related to documentation versioning
Describe the solution you'd like
A way to version a set of markdown documents
Describe alternatives you've considered
Similar to VuePress Plugin or Docusaurus2
The text was updated successfully, but these errors were encountered: