\r\n title: Feature A\r\n details: Lorem ipsum dolor sit amet, consectetur adipiscing elit\r\n```\r\n\r\nCheck the feature icon type\r\n```ts\r\ntype FeatureIcon =\r\n | string\r\n | { src: string; alt?: string; width?: string; height: string }\r\n | {\r\n light: string\r\n dark: string\r\n alt?: string\r\n width?: string\r\n height: string\r\n }\r\n```\r\n\r\nI refer to the render logic, use `v-html` render the icon.\r\nDisplay well in `dev` environment, but shows errors in `prod` environment.\r\n\r\n| dev | build |\r\n| ----------- | ----------- |\r\n|  |  |\r\n\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\nhttps://stackblitz.com/github/zyyv/vitepress-unocss-issue\r\n\r\n- Display right run `pnpm dev`\r\n- Display error run `pnpm build && pnpm preview`\r\n\r\n### Expected behavior\r\n\r\nDev and build behave the same\r\n\r\n### System Info\r\n\r\n```Text\r\nlatest\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] 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.",[3023,3026,3029],{"name":3024,"color":3025},"build","377ba8",{"name":3027,"color":3028},"has-workaround","1B4515",{"name":3030,"color":3031},"stale","ededed",4045,"vuejs","vitepress","open","SSR in dev for more consistent output in dev and prod","2025-03-02T18:08:58Z","https://github.com/vuejs/vitepress/issues/4045",0.75019395,{"description":3041,"labels":3042,"number":3047,"owner":3033,"repository":3034,"state":3035,"title":3048,"updated_at":3049,"url":3050,"score":3051},"### Describe the bug\r\n\r\n当我在使用动态路由的功能的时候,开发状态下是正常运行的,如下方的配置\r\n\r\n\r\n\r\n\r\n`export default {\r\n paths() {\r\n return [\r\n { params: { pkg: '../svgui/important/' }},\r\n { params: { pkg: '../toolkit/important/' }},\r\n ]\r\n }\r\n}`\r\n\r\n我在当前目录的上级中的两个目录中分别用当前的md文件生成了两个文件,开发环境一切正常。\r\n但打包之后,对应目录的文件生成了,但是内容却是404。\r\n\r\n### Reproduction\r\n\r\n无\r\n\r\n### Expected behavior\r\n\r\n希望能改进后,开发环境和生产环境表现一致。\r\n\r\n### System Info\r\n\r\n```Text\r\nnode 18.19 \r\nwindows\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] 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.",[3043,3046],{"name":3044,"color":3045},"bug: pending triage","e99695",{"name":3030,"color":3031},4200,"动态路由打包后遇到的bug,开发环境正常","2024-10-26T17:17:22Z","https://github.com/vuejs/vitepress/issues/4200",0.7511178,{"description":3053,"labels":3054,"number":3058,"owner":3033,"repository":3034,"state":3059,"title":3060,"updated_at":3061,"url":3062,"score":3063},"### Describe the bug\n\n单击 AntDesignVue Pagination 组件某页进行切换时,会导致当前页面会滚动到 Top。\n\n### Reproduction\n\n后排查发现 \\\u003Ca rel=\"nofollow\"> 这种也会起到锚链接的作用。但在其他非 vitepress 的 SPA 页面中使用,却不会有这个影响。我不太理解。\n\n### Expected behavior\n\n消除 \\\u003Ca rel=\"nofollow\"> 本不该有的 锚链接影响。\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.5\r\n CPU: (16) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 2.63 GB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.10.0 - ~/.nvm/versions/node/v20.10.0/bin/node\r\n Yarn: 1.22.22 - /usr/local/bin/yarn\r\n npm: 10.2.3 - ~/.nvm/versions/node/v20.10.0/bin/npm\r\n pnpm: 9.2.0 - /usr/local/bin/pnpm\r\n bun: 1.1.12 - /usr/local/bin/bun\r\n Browsers:\r\n Chrome: 125.0.6422.142\r\n Safari: 17.5\r\n npmPackages:\r\n vitepress: ^1.2.3 => 1.2.3\n```\n\n\n### Additional context\n\n_No response_\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.",[3055],{"name":3056,"color":3057},"client","1AA9E5",3950,"closed","使用 AntDesignVue Pagination 组件中,发现单击某个页数切换,会导致页面会回滚到 Top","2024-06-17T04:43:00Z","https://github.com/vuejs/vitepress/issues/3950",0.72344834,{"description":3065,"labels":3066,"number":3068,"owner":3033,"repository":3034,"state":3059,"title":3069,"updated_at":3070,"url":3071,"score":3072},"### Describe the bug\n\nif I use \"/\" character end of url, sidebar and middle page not working normally.\n\n### Reproduction\n\ncheck this error\r\nhttps://stackblitz.com/edit/vite-9jamew\r\n\r\nif you see error, add to `\u003Cstackblitz test url>/en/test/` and enter. 404 page coming. \r\nbut `\u003Cstackblitz test url>/en/test` like this working.\n\n### Expected behavior\n\nneed to work normally. 404 page is wrong.\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22631\r\n CPU: (12) x64 Intel(R) Core(TM) i7-10750H CPU @ 2.60GHz\r\n Memory: 2.38 GB / 15.87 GB\r\n Binaries:\r\n Node: 18.18.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.22 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 9.8.1 - C:\\Program Files\\nodejs\\npm.CMD\r\n pnpm: 8.6.1 - ~\\AppData\\Roaming\\npm\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (122.0.2365.59)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.1.3 => 1.1.3\n```\n\n\n### Additional context\n\nnginx conf like\r\n\r\n```\r\nserver {\r\n gzip on;\r\n gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;\r\n\r\n listen 80;\r\n server_name _;\r\n index index.html;\r\n\r\n location / {\r\n # content location\r\n root /app;\r\n\r\n # exact matches -> reverse clean urls -> folders -> not found\r\n try_files $uri $uri.html $uri/ =404;\r\n\r\n # non existent pages\r\n error_page 404 /404.html;\r\n\r\n # a folder without index.html raises 403 in this setup\r\n error_page 403 /404.html;\r\n\r\n # adjust caching headers\r\n # files in the assets folder have hashes filenames\r\n location ~* ^/assets/ {\r\n expires 1y;\r\n add_header Cache-Control \"public, immutable\";\r\n }\r\n }\r\n}\r\n```\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.",[3067],{"name":3044,"color":3045},3832,"page render error","2024-05-05T04:41:46Z","https://github.com/vuejs/vitepress/issues/3832",0.7263737,{"description":3074,"labels":3075,"number":3077,"owner":3033,"repository":3034,"state":3059,"title":3078,"updated_at":3079,"url":3080,"score":3081},"> @brc-dd \r\n> \r\n> ```ts\r\n> import { defineConfig } from 'vitepress';\r\n> \r\n> export default defineConfig({\r\n> transformPageData(pageData) {\r\n> return {\r\n> frontmatter: {\r\n> ...pageData.frontmatter,\r\n> head: [\r\n> [\r\n> 'script',\r\n> { type: 'application/ld+json' },\r\n> pageData.relativePath === 'index.md'\r\n> ```\r\n\r\nWhen I using Dynamic Routes. To uniformly manage and generate pages with a consistent structure, which involves changing the `header` [#2516](https:github.com/vuejs/vitepress/discussions/2516), the suggestion is also to use `.vitepress/config.js` to use `transformPageData`\r\n\r\nI was wondering if `transformPageData` would be in Dynamic Routes configure `[pkg].paths.js`. Avoid me adding too much judgment in `.vitepress/config.js`, and managing it in only one place.\r\n\r\n```\r\n.\r\n└─ packages\r\n ├─ [pkg].md # route template\r\n └─ [pkg].paths.js # route paths loader\r\n```\r\n\r\n```js\r\n// packages/[pkg].paths.js\r\nexport default {\r\n paths() {\r\n return [\r\n { params: { pkg: 'foo' }},\r\n { params: { pkg: 'bar' }}\r\n ]\r\n },\r\n transformPageData(pageData) {\r\n // ...\r\n }\r\n}\r\n```\r\n\r\n_Originally posted by @Zhengqbbb in https://github.com/vuejs/vitepress/issues/883#issuecomment-1614242193_\r\n ",[3076],{"name":3024,"color":3025},2726,"transformPageData from dynamic paths","2023-08-11T00:04:17Z","https://github.com/vuejs/vitepress/issues/2726",0.7286872,{"description":3083,"labels":3084,"number":3085,"owner":3033,"repository":3034,"state":3059,"title":3086,"updated_at":3087,"url":3088,"score":3089},"### Describe the bug\r\n\r\nWhen using iOS Safari, if you move to the actions link on the home page and then swipe history back, clicking on the elements on the home page is interrupted once.\r\nWorks fine from the second touch.\r\n\r\n### Reproduction\r\n\r\nhome > click action button > swipe history back > click action button\r\n\r\n### Expected behavior\r\n\r\n\r\nNo response to action button on home page after history back.\r\n\r\n### System Info\r\n\r\n```Text\r\niPhone SE2 (2020)\r\niOS 17.4\r\nsafari\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] 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.",[],3658,"History back issue while using iOS Safari","2024-05-04T04:42:01Z","https://github.com/vuejs/vitepress/issues/3658",0.7389935,{"description":3091,"labels":3092,"number":3093,"owner":3033,"repository":3034,"state":3059,"title":3094,"updated_at":3095,"url":3096,"score":3097},"### Is your feature request related to a problem? Please describe.\n\nLet's say we got a folder structure like this:\r\n\r\n\r\n└─ foo\r\n ├─ 1.0.0.md\r\n ├─ 2.0.0.md\r\n └─ 3.0.0.md\r\n\r\nRight now we would have routes like:\r\n `/foo/1.0.0.html`\r\n `/foo/2.0.0.html`\r\n `/foo/3.0.0.html`\r\n\r\nI'd like to also have a route or alias like the following: `/foo/latest` which will point to the latest version (this can all be determined on build time by looking at the file, I already have a function that gives me the latest \"route\", in this case `/foo/3.0.0.html`.\r\n\r\nHow can I make this `/foo/latest` route exist and be an alias to the one I wanted?\n\n### Describe the solution you'd like\n\nAllow us to define route aliases or redirects\n\n### Describe alternatives you've considered\n\nI've tried with rewrites but that allowed me to make the latest version redirected to /latest instead. I want the reverse.\n\n### Additional context\n\nIf this is not something you think vitepress should have because it's not SSG friendly (there is no latest.html file) then I understand.\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[],2922,"Route Alias or Redirect","2023-09-16T00:04:02Z","https://github.com/vuejs/vitepress/issues/2922",0.7410452,{"description":3099,"labels":3100,"number":3101,"owner":3033,"repository":3034,"state":3059,"title":3102,"updated_at":3103,"url":3104,"score":3105},"### Is your feature request related to a problem? Please describe.\r\n\r\nMultiple sidebars do not work with multiple locales\r\n\r\nMultiple sidebars work only for the root locale\r\n\r\n```js\r\nimport sidebar_es from \"./sidebar.es\";\r\nimport sidebar_en from \"./sidebar.en\";\r\nimport sidebar_subdir_es from \"./sidebar.subdir.es\";\r\nimport sidebar_subdir_en from \"./sidebar.subdir.en\";\r\n\r\nexport default defineConfig({\r\n locales: {\r\n root: {\r\n lang: \"sp\",\r\n label: \"Spanish\",\r\n themeConfig: {\r\n nav: nav_es,\r\n sidebar: {\r\n \"/\": sidebar_es,\r\n \"/subdir/\": sidebar_subdir_es,\r\n },\r\n },\r\n },\r\n en: {\r\n lang: \"en\",\r\n label: \"English\",\r\n themeConfig: {\r\n nav: nav_en,\r\n sidebar: {\r\n \"/\": sidebar_en,\r\n \"/subdir/\": sidebar_subdir_en,\r\n },\r\n },\r\n```\r\n\r\nIn this example `/en/subdir/` path shows default `sidebar_en` sidebar\r\n\r\n### Describe the solution you'd like\r\n\r\nMultiple sidebars should work for secondary locales\r\n\r\n### Describe alternatives you've considered\r\n\r\n_No response_\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.dev).\r\n- [X] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\r\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[],3202,"i18n and multiple sidebars problem","2023-11-21T00:04:49Z","https://github.com/vuejs/vitepress/issues/3202",0.742534,{"description":3107,"labels":3108,"number":3110,"owner":3033,"repository":3034,"state":3059,"title":3111,"updated_at":3112,"url":3113,"score":3114},"### Describe the bug\r\n\r\nI have a npm package called @declarative-gridstacks/react, it exports a bunch of react components (compiled with babel-loader obviously), I import these modules use them in vitepress it words good in dev mode... But when I actually try to build the vitepress project, it doesn't build.\r\n\r\n\r\n\r\n\r\n### Reproduction\r\n\r\n```jsx\r\nimport {\r\n GridstackContainer,\r\n} from \"@declarative-gridstack/react\"; // This is in node_modules.\r\n\r\nconst Component = () => {\r\nreturn \u003CGridstackContainer />\r\n}\r\n\r\nexport default Component;\r\n```\r\n\r\n// Import this code in \r\n```vue\r\n\u003Cdiv ref=\"el\" />\r\n\r\n\u003Cscript setup>\r\nimport { createElement } from 'react'\r\nimport { createRoot } from 'react-dom/client'\r\nimport { ref, onMounted } from 'vue'\r\nimport Simple from '../components/simple/Simple.jsx'\r\n\r\nconst el = ref()\r\nonMounted(() => {\r\n const root = createRoot(el.value)\r\n root.render(createElement(Simple, {}, null))\r\n})\r\n\u003C/script>\r\n```\r\n\r\n\r\n\r\n### Expected behavior\r\n\r\nThe project should build... It works fine in dev mode...\r\n\r\n### System Info\r\n\r\n```sh\r\nSystem:\r\n OS: macOS 12.5\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 1.16 GB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.20.1 - ~/.nvm/versions/node/v16.20.1/bin/node\r\n Yarn: 1.22.19 - ~/.nvm/versions/node/v16.20.1/bin/yarn\r\n npm: 8.19.4 - ~/.nvm/versions/node/v16.20.1/bin/npm\r\n Browsers:\r\n Chrome: 115.0.5790.114\r\n Safari: 15.6\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] 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.",[3109],{"name":3044,"color":3045},2709,"Unable to build the docs project when importing a module from node_modules","2023-08-07T00:04:27Z","https://github.com/vuejs/vitepress/issues/2709",0.7434073,{"description":3116,"labels":3117,"number":3118,"owner":3033,"repository":3034,"state":3059,"title":3119,"updated_at":3120,"url":3121,"score":3122},"### Is your feature request related to a problem? Please describe.\n\nemmmm, now on the official website of vitepress.dev, after clicking search and entering some keywords, no more than 5 results are always returned. Now I need to view more results, such as 20 or 50, what should I do? Hope to get a reply, thank you\r\n\r\n\n\n### Describe the solution you'd like\n\nNow I need to view more results, such as 20 or 50, what should I do?\n\n### Describe alternatives you've considered\n\n_No response_\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] Read the [Contributing Guidelines](https://github.com/vuejs/vitepress/blob/main/.github/contributing.md).\n- [X] Check that there isn't already an issue that asks for the same feature to avoid creating a duplicate.",[],3088,"How to display results for more than 5 items using Algolia search?","2023-10-22T00:04:50Z","https://github.com/vuejs/vitepress/issues/3088",0.74576175,["Reactive",3124],{},["Set"],["ShallowReactive",3127],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fySqrdKfK5_rFNPATb8UERFBmbteZBtKpnHGkFv-kjxQ":-1},"/vuejs/vitepress/2840"]