如图,我在代码里修改标题为Demo3333 浏览器发起了热重载请求,但是页面不会自动更新\n\n### Validations\n\n- [x] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [x] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [x] Read the [docs](https://vitepress.dev).\n- [x] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2852],{"name":2853,"color":2854},"bug: pending triage","e99695",4690,"vuejs","vitepress","closed","热更新失效","2025-04-15T06:05:35Z","https://github.com/vuejs/vitepress/issues/4690",0.71048325,{"description":2864,"labels":2865,"number":2869,"owner":2856,"repository":2857,"state":2858,"title":2870,"updated_at":2871,"url":2872,"score":2873},"### Describe the bug\n\nAfter configuring base, the links generated using createContentLoader have a base prefix, while other links do not have a base (eq. [navigation-links](https://vitepress.dev/reference/default-theme-nav#navigation-links)). There is a difference between the two format of links.\r\n\r\nCaused by #2714\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-tcog3a?file=docs%2F.vitepress%2FTest.vue\n\n### Expected behavior\n\nVarious links should maintain a consistent format\n\n### System Info\n\n```sh\nvitepress ^1.0.0-rc.1\n```\n\n\n### Additional context\n\nThe default theme for base processing is done in the component, eq. VPLink VPImage\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2866],{"name":2867,"color":2868},"contribution welcome","11E4B8",2862,"The link generated by using CreateContentLoader is inconsistent with the default link format","2023-09-05T00:04:10Z","https://github.com/vuejs/vitepress/issues/2862",0.7213136,{"description":2875,"labels":2876,"number":2878,"owner":2856,"repository":2857,"state":2858,"title":2879,"updated_at":2880,"url":2881,"score":2882},"### Describe the bug\n\nmy defineConfig:\r\n\r\nwhen i build and release to website, i get a 404 when use local search:\r\n\r\n\r\n\r\n404 on `run docs:preview` too, only ok `run docs:dev`\n\n### Reproduction\n\nvitepress version v1.0.0-alpha.73\r\n\r\nWindows 11 \n\n### Expected behavior\n\n..\n\n### System Info\n\n```shell\n..\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2877],{"name":2853,"color":2854},2276,"I use rewrites URL, local search get 404 on build version","2023-05-05T00:04:13Z","https://github.com/vuejs/vitepress/issues/2276",0.72235763,{"description":2884,"labels":2885,"number":2887,"owner":2856,"repository":2857,"state":2858,"title":2888,"updated_at":2889,"url":2890,"score":2891},"### Describe the bug\r\n\r\n\r\n\r\nI set `base` to `'/vitepress-docs/'` in `config.js`, and I deployed it to Github Pages successfully.\r\n\r\n[Github Pages](https://guhl0427.github.io/vitepress-docs/)\r\n\r\nWith the same config, I deployed it to Vercel or Netlify failed.\r\n\r\n[Vercel](https://vitepress-docs-swart.vercel.app/)\r\n[Netlify](https://guhlblog.netlify.app/)\r\n\r\nThen I had tried set `base` to `'/'`, it deployed successfully in Vercel or Netlify, but failed in Github Pages.\r\n\r\n### Reproduction\r\n\r\n\r\nWhen I set `base` to `'/vitepress-docs/'` in `config.js`\r\n\r\nResults of deployment:\r\n+ [Github Pages(success)](https://guhl0427.github.io/vitepress-docs/)\r\n+ [Vercel(failed)](https://vitepress-docs-swart.vercel.app/)\r\n+ [Netlify(failed)](https://guhlblog.netlify.app/)\r\n\r\nWhen I set `base` to `'/'` in `config.js`\r\n\r\nResults of deployment:\r\n+ Github Pages(failed)\r\n+ Vercel(success)\r\n+ Netlify(success)\r\n\r\n### Expected behavior\r\n\r\nI want to deploy to Github Pages, Vercel, Netlify with the same `config.js` at the same time.\r\n\r\nMaybe I need do some extra configuration When I deploy to Vercel or Netlify.\r\n\r\n\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: Windows 10 10.0.18363\r\n CPU: (6) x64 Intel(R) Core(TM) i5-9400 CPU @ 2.90GHz\r\n Memory: 5.25 GB / 15.88 GB\r\n Binaries:\r\n Node: 14.20.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 6.14.17 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Chrome: 104.0.5112.80\r\n Edge: Spartan (44.18362.449.0)\r\n Internet Explorer: 11.0.18362.1\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n_No response_\r\n\r\n### Validations\r\n\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2886],{"name":2853,"color":2854},1146,"I want to deploy to Github Pages, Vercel, Netlify at the same time, but something went wrong.","2023-01-21T14:28:47Z","https://github.com/vuejs/vitepress/issues/1146",0.7227862,{"description":2893,"labels":2894,"number":2898,"owner":2856,"repository":2857,"state":2858,"title":2899,"updated_at":2900,"url":2901,"score":2902},"### Describe the bug\n\nWhile trying to run document some components built on top of Quasar components, I was unable to run `vitepress build docs` for my project and throwing error\r\n\r\n> ✓ building client + server bundles...\r\n✖ rendering pages...\r\nbuild error:\r\nTypeError: Cannot convert undefined or null to object\r\n at Function.assign (\u003Canonymous>)\r\n at installQuasar (......dist\\quasar.cjs.prod.js:6:15454)\r\n at Object.install (......\\quasar\\dist\\quasar.cjs.prod.js:6:491344)\r\n at Object.use (......\\dist\\runtime-core.cjs.prod.js:3350:28)\r\n at Object.enhanceApp (....../docs/.vitepress/.temp/app.js:5580:9)\r\n at createApp (....../docs/.vitepress/.temp/app.js:5881:17)\r\n at render (....../docs/.vitepress/.temp/app.js:5921:33)\r\n at renderPage (....../vitepress/dist/node/serve-c489c02c.js:41209:25)\r\n at ....../node_modules/vitepress/dist/node/serve-c489c02c.js:41742:21\r\n at Array.map (\u003Canonymous>)\r\n\n\n### Reproduction\n\n**config.ts**\r\n\r\n```typescript\r\nimport { defineConfig } from 'vitepress'\r\nimport vueJsx from '@vitejs/plugin-vue-jsx'\r\nimport * as path from \"path\";\r\n\r\nexport default defineConfig(\r\n {\r\n lang: 'en-US',\r\n title: 'MyLib',\r\n lastUpdated: true,\r\n titleTemplate: false,\r\n themeConfig: {\r\n siteTitle: 'MyLib',\r\n docFooter: {\r\n prev: 'Prev',\r\n next: 'Next'\r\n },\r\n },\r\n vite: {\r\n plugins: [\r\n vueJsx(),\r\n ],\r\n resolve: {\r\n alias: [\r\n {find: \"@\", replacement: path.resolve(__dirname, '../../src') },\r\n {find: \"components\", replacement: path.resolve(__dirname, '../components') }\r\n ],\r\n dedupe: ['vue', 'quasar', 'Quasar', 'pubsub-js'],\r\n },\r\n build: {\r\n rollupOptions: {\r\n external: ['vue', /quasar\\/.+/]\r\n }\r\n },\r\n }\r\n }\r\n)\r\n````\r\n\r\n**index.ts**\r\n\r\n```typescript\r\nimport DefaultTheme from 'vitepress/theme'\r\nimport { App, onMounted } from 'vue'\r\nimport { dispatchEventStorage } from '../utils/tools'\r\nimport MyLib from 'my-lib '\r\n\r\nimport Container from \"../components/Container.vue\";\r\nimport {Quasar } from \"quasar\";\r\nimport {quasarConfig} from \"@\";\r\n\r\nexport default {\r\n ...DefaultTheme,\r\n enhanceApp ({ app }: { app: App }) {\r\n app.use(Quasar, {\r\n components: {\r\n ...quasarConfig.components,\r\n },\r\n directives: {\r\n ...quasarConfig.directives,\r\n },\r\n plugins: {\r\n ...quasarConfig.plugins,\r\n },\r\n });\r\n app.use(MyLib);\r\n app.component('Container', Container)\r\n },\r\n\r\n setup () {\r\n onMounted(() => {\r\n dispatchEventStorage()\r\n })\r\n }\r\n}\r\n```\n\n### Expected behavior\n\nAs `vitepress dev docs` works fine and serving the documentation with the required component example, running 'vitepress build docs' is not running fine in rendering pages step.\n\n### System Info\n\n```shell\nwindows: 11,\r\nnode: v16.19.1\r\nnpm: 8.19.3\r\nquasar: 2.10.2\r\nvue: 3.2.47\r\nvite: 4.3.1\r\nvitepress: 1.0.0-alpha.73\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2895],{"name":2896,"color":2897},"need more info","bdbefc",2298,"Quasar and Vitepress: Cannot convert undefined or null to object","2023-05-05T00:04:11Z","https://github.com/vuejs/vitepress/issues/2298",0.7250406,{"description":2904,"labels":2905,"number":2912,"owner":2856,"repository":2857,"state":2858,"title":2913,"updated_at":2914,"url":2915,"score":2916},"Hi guys, I hope you are well. I have forked to check spanish #translation. It is working for some files I have tested. I would like to contribute. Thanks.",[2906,2909],{"name":2907,"color":2908},"docs","0075ca",{"name":2910,"color":2911},"translations","6366D3",3850,"docs: add spanish translation","2024-06-14T04:41:50Z","https://github.com/vuejs/vitepress/issues/3850",0.72707397,{"description":2918,"labels":2919,"number":2921,"owner":2856,"repository":2857,"state":2858,"title":2922,"updated_at":2923,"url":2924,"score":2925},"### Describe the bug\r\n\r\nVitePress builds, and instantly removes the dist folder again.\r\n\r\n### Reproduction\r\n\r\nClone my [GitHub repository](https://github.com/Ahwxorg/Linkbase/), run yarn to install the dependencies and run `yarn vitepress build`.\r\n\r\n### Expected behavior\r\n\r\nVitePress successfully builds the dist/ folder.\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 13.5.2\r\n CPU: (10) arm64 Apple M2 Pro\r\n Memory: 125.69 MB / 16.00 GB\r\n Shell: 3.6.1 - /opt/homebrew/bin/fish\r\n Binaries:\r\n Node: 20.7.0 - /opt/homebrew/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 10.1.0 - /opt/homebrew/bin/npm\r\n Browsers:\r\n Safari: 16.6\r\n```\r\n\r\n\r\nAlthough I use GitHub Actions as well (see [the failed run here](https://github.com/Ahwxorg/Linkbase/actions/runs/6273423931/job/17036870482))\r\n\r\n\r\n### Additional context\r\n\r\nBuild log is the following:\r\n\r\n```sh\r\nvitepress v1.0.0-rc.20\r\n\r\n✓ building client + server bundles...\r\n✓ rendering pages...\r\nbuild complete in 1.89s.\r\n✨ Done in 2.06s.\r\n```\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2920],{"name":2853,"color":2854},3040,"[Bug] VitePress won't build","2023-10-10T00:04:18Z","https://github.com/vuejs/vitepress/issues/3040",0.7291683,{"description":2927,"labels":2928,"number":2932,"owner":2856,"repository":2857,"state":2858,"title":2933,"updated_at":2934,"url":2935,"score":2936},"### Describe the bug\r\n\r\nI'm getting some errors when running `pnpm build`, I guess it's because I should somehow wrap this component causing the error in `\u003CClientOnly />`, but how should I find the exact cause from the error log? It does not provide any useful details (see below screenshot)\r\n\r\n---\r\n\r\nAnother question, as I guess my error is because of this:\r\nShould I wrap `watch()` inside `onMounted()`? or in another word, can I do it? I didn't find any corresponding example in Vue documentation... \r\nSorry if this is a dumb question, as I'm a react guy :(\r\n```vue\r\n\u003Cscript setup lang=\"ts\">\r\nimport { useLocalStorage } from '@vueuse/core';\r\nimport { watch } from 'vue';\r\n\r\nconst nfcapiEnvRef = useLocalStorage('vp-nfcapi-env', 'staging', {\r\n deep: false,\r\n listenToStorageChanges: true,\r\n writeDefaults: true\r\n});\r\n\r\nwatch(nfcapiEnvRef, (value, oldValue) => {\r\n const htmlDataSet = document.documentElement.dataset;\r\n oldValue && (htmlDataSet.nfcapiEnv = oldValue.toLowerCase());\r\n htmlDataSet.nfcapiEnv = value.toLowerCase();\r\n}, { immediate: true });\r\n\u003C/script>\r\n```\r\n\r\n---\r\n\r\nScreenshot of the error:\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nThis is not a bug, but a question\r\n\r\n### Expected behavior\r\n\r\nN/A\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (16) x64 11th Gen Intel(R) Core(TM) i9-11900K @ 3.50GHz\r\n Memory: 30.87 GB / 63.84 GB\r\n Binaries:\r\n Node: 18.16.0 - C:\\NodeJS\\node.EXE\r\n Yarn: 1.22.19 - C:\\NodeJS\\yarn.CMD\r\n npm: 9.8.0 - C:\\NodeJS\\npm.CMD\r\n pnpm: 8.6.7 - C:\\NodeJS\\pnpm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (114.0.1823.82)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-beta.5 => 1.0.0-beta.5\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nN/A\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2929],{"name":2930,"color":2931},"question","5D5FAE",2627,"How should I trace build error?","2023-07-24T00:04:51Z","https://github.com/vuejs/vitepress/issues/2627",0.7329934,{"description":2938,"labels":2939,"number":2941,"owner":2856,"repository":2857,"state":2858,"title":2942,"updated_at":2943,"url":2944,"score":2945},"### Describe the bug\r\n\r\nconst getCode = async () => {\r\nconst url=ref(`test.vue`)\r\n const res = await import(/* @vite-ignore */ `${url}?raw`);\r\n return res.default;\r\n};\r\nconst code= getCode ();\r\nconsole.log('code=>',code);\r\n\r\n\r\n使用import动态导入vue文件,获取文件的内容事,报错。\r\n执行命令pnpm run docs:dev 不会报错。\r\n当执行pnpm run docs:build 报错。报错如下\r\nTypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension \".vue\" for \\examples\\src\\views\\crud\\baseDefault.vue\r\nNode.js v16.19.0\r\nNode.js v18.18.2\r\nNode.js v20.10.0\r\nNode.js v21.5.0\r\n都测试过依然存在此问题。问题存在vitepress项目,而vite项目测试打包是么问题的。\r\n\r\n### Reproduction\r\n\r\n执行命令:pnpm run docs:build\r\n\r\n### Expected behavior\r\n\r\n执行 pnpm run docs:build能正常打包。即使能绕过报错也可以。\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: Windows 11 10.0.22621\r\n CPU: (8) x64 Intel(R) Core(TM) i7-4720HQ CPU @ 2.60GHz\r\n Memory: 4.40 GB / 15.89 GB\r\n Binaries:\r\n Node: 18.18.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 9.8.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.15.1 - C:\\Program Files\\nodejs\\pnpm.CMD\r\n Browsers:\r\n Chrome: bookmarks.html\r\ninitial_preferences\r\n Edge: Chromium (126.0.2592.68)\r\n Internet Explorer: 11.0.22621.3527\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n\r\n\r\n\r\n### Validations\r\n\r\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2940],{"name":2853,"color":2854},4002,"vitepress使用import动态导入xx.vue文件时报错,TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension \".vue\" ","2024-07-07T04:41:46Z","https://github.com/vuejs/vitepress/issues/4002",0.7427061,{"description":2947,"labels":2948,"number":2950,"owner":2856,"repository":2857,"state":2858,"title":2951,"updated_at":2952,"url":2953,"score":2954},"### Describe the bug\n\nWhen I enable the `ignoreDeadLinks` option in `/docs/.vitepress/config.js`, `yarn docs:build` still fails with the reason being `One or more pages contain dead links.`\n\n### Reproduction\n\nCreate a new vitepress project.\r\nIn `/docs/.vitepress/config.js`:\r\n```js\r\nexport default {\r\n ignoreDeadLinks: true,\r\n title: \"test\",\r\n description: \"test stuff\"\r\n}\r\n```\r\n\r\nIn `/docs/api/index.md`:\r\n```md\r\n[test](./test)\r\n```\n\n### Expected behavior\n\nIt is expected that the build process will succeed, because it should ignoreDeadLinks instead of failing because of them.\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 Intel(R) Core(TM) i7-8700K CPU @ 3.70GHz \r\n Memory: 6.63 GB / 15.93 GB\r\n Binaries:\r\n Node: 18.5.0 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 8.15.0 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (103.0.1264.71) \r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.4 => 1.0.0-alpha.4\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2949],{"name":2853,"color":2854},1084,"ignoreDeadLinks doesn't work","2023-01-21T14:30:01Z","https://github.com/vuejs/vitepress/issues/1084",0.7443832,["Reactive",2956],{},["Set"],["ShallowReactive",2959],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fjTirTASViMC7gaEUOPURGIPfdbPCBDxjNwmD0lHSzt4":-1},"/vuejs/vitepress/2826"]