\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.",[2865,2868,2871],{"name":2866,"color":2867},"build","377ba8",{"name":2869,"color":2870},"has-workaround","1B4515",{"name":2872,"color":2873},"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.73600453,{"description":2883,"labels":2884,"number":2888,"owner":2875,"repository":2876,"state":2889,"title":2890,"updated_at":2891,"url":2892,"score":2893},"### Describe the bug\n\nI added team component feedback error in index.md\r\n\r\n\n\n### Reproduction\n\n---\r\nlayout: home\r\n\r\nhero:\r\n name: VitePress\r\n text: Vite & Vue powered static site generator.\r\n tagline: Simple, powerful, and performant. Meet the modern SSG framework you've always wanted.\r\n actions:\r\n - theme: brand\r\n text: Get Started\r\n link: /example\r\n - theme: alt\r\n text: View on GitHub\r\n link: https://github.com/vuejs/vitepress\r\n---\r\n\r\n\u003Cscript setup>\r\nimport { VPTeamMembers } from 'vitepress/theme'\r\n\r\nconst members = [\r\n {\r\n avatar: 'https://www.github.com/yyx990803.png',\r\n name: 'Evan You',\r\n title: 'Creator',\r\n links: [\r\n { icon: 'github', link: 'https://github.com/yyx990803' },\r\n { icon: 'twitter', link: 'https://twitter.com/youyuxi' }\r\n ]\r\n },\r\n ...\r\n]\r\n\u003C/script>\r\n\r\n# Our Team\r\n\r\nSay hello to our awesome team.\r\n\r\n\u003CVPTeamMembers size=\"small\" :members=\"members\" />\r\n\n\n### Expected behavior\n\nnormal\n\n### System Info\n\n```Text\nSystem:\r\n OS: Linux 5.0 undefined\r\n CPU: (8) x64 Intel(R) Core(TM) i9-9880H CPU @ 2.30GHz\r\n Memory: 0 Bytes / 0 Bytes\r\n Shell: 1.0 - /bin/jsh\r\n Binaries:\r\n Node: 18.20.3 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 10.2.3 - /usr/local/bin/npm\r\n pnpm: 8.15.6 - /usr/local/bin/pnpm\r\n npmPackages:\r\n vitepress: latest => 1.3.4\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.",[2885],{"name":2886,"color":2887},"bug: pending triage","e99695",4238,"closed","Error occurred when using team components","2024-10-07T04:45:56Z","https://github.com/vuejs/vitepress/issues/4238",0.70794386,{"description":2895,"labels":2896,"number":2898,"owner":2875,"repository":2876,"state":2889,"title":2899,"updated_at":2900,"url":2901,"score":2902},"### Describe the bug\n\nexternalLinkIcon as true doesn't add the icon.\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vite-ysfhai?file=docs%2F.vitepress%2Fconfig.ts\n\n### Expected behavior\n\nicon should be shown\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 11 10.0.22621\r\n CPU: (4) x64 Intel(R) Core(TM) i5 CPU M 520 @ 2.40GHz\r\n Memory: 2.15 GB / 7.93 GB\r\n Binaries:\r\n Node: 20.10.0 - C:\\Program Files\\nodejs\\node.EXE\r\n npm: 10.2.3 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.121)\r\n Internet Explorer: 11.0.22621.1\r\n npmPackages:\r\n vitepress: ^1.0.0-rc.35 => 1.0.0-rc.35\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.",[2897],{"name":2886,"color":2887},3424,"externalLinkIcon isn't working","2024-01-16T00:04:36Z","https://github.com/vuejs/vitepress/issues/3424",0.71586543,{"description":2904,"labels":2905,"number":2907,"owner":2875,"repository":2876,"state":2889,"title":2908,"updated_at":2909,"url":2910,"score":2911},"### Describe the bug\n\nimage not display at previewing, but replace with base64 string, it is ok !\r\n\r\n\n\n### Reproduction\n\n1. use `layout:home` in the index page\r\n2. configure the Hero section\r\n3. run `npm run docs:build` then `npm run docs:docs:preview` \r\n4. to preview the website\n\n### Expected behavior\n\ncan display the image by file path\n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.19044\r\n CPU: (12) x64 11th Gen Intel(R) Core(TM) i5-11400F @ 2.60GHz\r\n Memory: 8.52 GB / 15.87 GB\r\n Binaries:\r\n Node: 16.13.2 - C:\\Program Files\\nodejs\\node.EXE\r\n Yarn: 1.22.19 - C:\\Program Files\\nodejs\\yarn.CMD\r\n npm: 8.1.2 - C:\\Program Files\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.19041.1266.0), Chromium (110.0.1587.57)\r\n Internet Explorer: 11.0.19041.1566\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.48 => 1.0.0-alpha.48\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.",[2906],{"name":2886,"color":2887},2013,"image not display at previewing","2023-03-09T00:04:38Z","https://github.com/vuejs/vitepress/issues/2013",0.72133565,{"description":2913,"labels":2914,"number":2915,"owner":2875,"repository":2876,"state":2889,"title":2916,"updated_at":2917,"url":2918,"score":2919},"### Describe the bug\n\ndidn't process local logo in home page when build\n\n### Reproduction\n\nadd a home page \r\n```\r\nlayout: home\r\nhero:\r\n name: xxx\r\n image:\r\n src: /images/xxx.jpeg\r\n...\r\n```\r\n\r\nnpm run build\r\n \n\n### Expected behavior\n\ncopy `/images/xxx.jpeg` to `dist/assets` when build\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.6\r\n CPU: (8) x64 Intel(R) Core(TM) i7-7700HQ CPU @ 2.80GHz\r\n Memory: 66.69 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.0 - ~/.nvm/versions/node/v16.15.0/bin/node\r\n Yarn: 3.0.2 - /usr/local/bin/yarn\r\n npm: 8.5.5 - ~/.nvm/versions/node/v16.15.0/bin/npm\r\n Browsers:\r\n Chrome: 105.0.5195.125\r\n Firefox: 88.0\r\n Safari: 16.0\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.",[],1386,"didn't process local logo in home page when build","2023-01-21T14:22:47Z","https://github.com/vuejs/vitepress/issues/1386",0.7307042,{"description":2921,"labels":2922,"number":2924,"owner":2875,"repository":2876,"state":2889,"title":2925,"updated_at":2926,"url":2927,"score":2928},"### Describe the bug\n\nWhen you build up your team page and for the team member social links you would like to set your own icon. For example email icon for email link. Regarding the docs: https://vitepress.vuejs.org/config/theme-configs.html#sociallinks you should be able to set:\r\n\r\n```\r\nlinks: [\r\n { \r\n icon: {\r\n svg: '\u003Csvg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"1em\" height=\"1em\" preserveAspectRatio=\"xMidYMid meet\" viewBox=\"0 0 24 24\" style=\"-ms-transform: rotate(360deg); -webkit-transform: rotate(360deg); transform: rotate(360deg);\">\u003Cpath fill=\"currentColor\" d=\"m20 8l-8 5l-8-5V6l8 5l8-5m0-2H4c-1.11 0-2 .89-2 2v12a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V6a2 2 0 0 0-2-2Z\"/>\u003C/svg>'\r\n },\r\n link: 'mailto:john@doe.de'\r\n },\r\n ]\r\n```\r\nbut the icon will not be rendered:\r\n\u003Cimg width=\"1419\" alt=\"Bildschirmfoto 2022-07-28 um 00 12 43\" src=\"https://user-images.githubusercontent.com/30939926/181381626-bdf02d0d-973c-4be2-87e8-f99f4c93ca18.png\">\r\n\r\n\n\n### Reproduction\n\nhttps://stackblitz.com/edit/vitepress-sociallinks-custom-svg?file=docs%2Findex.md,package.json&terminal=dev\r\n\n\n### Expected behavior\n\nWhen defining a custom icon like defined on the docs:\r\nhttps://vitepress.vuejs.org/config/theme-configs.html#sociallinks\r\n\r\ni would expect this svg to get rendered.\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.1\r\n CPU: (8) x64 Apple M1\r\n Memory: 24.19 MB / 16.00 GB\r\n Shell: 5.8 - /bin/zsh\r\n Binaries:\r\n Node: 16.13.1 - ~/.nvm/versions/node/v16.13.1/bin/node\r\n npm: 8.1.2 - ~/.nvm/versions/node/v16.13.1/bin/npm\r\n Browsers:\r\n Chrome: 103.0.5060.134\r\n Firefox: 102.0.1\r\n Safari: 15.2\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.",[2923],{"name":2886,"color":2887},1075,"VPTeamMembers -> SocialLinks -> custom svg not working","2023-01-21T14:30:04Z","https://github.com/vuejs/vitepress/issues/1075",0.7317712,{"description":2930,"labels":2931,"number":2933,"owner":2875,"repository":2876,"state":2889,"title":2934,"updated_at":2935,"url":2936,"score":2937},"### Describe the bug\n\nThe hero image referenced below shows up as expected in development. When building the project, it is not included in the finished build.\r\n\r\n```\r\nhero:\r\n name: \"C–ATTS\"\r\n text: \"Composite Attestations\"\r\n tagline: Composite attestations are a new type of attestation combining data from multiple sources to form a unified and verifiable credential.\r\n actions:\r\n - theme: brand\r\n text: Composite Attestations?\r\n link: /docs\r\n - theme: alt\r\n text: GitHub\r\n link: https://github.com/c-atts\r\n image: /images/diagram.png\r\n```\n\n### Reproduction\n\nGitHub: https://github.com/c-atts/web\r\n\r\nLive web: https://catts.run/\n\n### Expected behavior\n\nThe image should be included in the build and show up in the hero section on the index page.\n\n### System Info\n\n```Text\nSystem:\r\n OS: macOS 14.4\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 2.05 GB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.11.0 - ~/.nvm/versions/node/v20.11.0/bin/node\r\n npm: 10.2.4 - ~/.nvm/versions/node/v20.11.0/bin/npm\r\n pnpm: 8.15.4 - /opt/homebrew/bin/pnpm\r\n bun: 0.7.3 - ~/.bun/bin/bun\r\n Browsers:\r\n Brave Browser: 122.1.63.169\r\n Chrome: 123.0.6312.107\r\n Edge: 123.0.2420.81\r\n Safari: 17.4\r\n npmPackages:\r\n vitepress: ^1.1.0 => 1.1.0\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.",[2932],{"name":2886,"color":2887},3776,"Hero image don't get included in built website","2024-04-28T12:24:49Z","https://github.com/vuejs/vitepress/issues/3776",0.7324892,{"description":2939,"labels":2940,"number":2942,"owner":2875,"repository":2876,"state":2889,"title":2943,"updated_at":2944,"url":2945,"score":2946},"### Describe the bug\n\nHello, I lost my logo when deploying the website.\r\n\r\nThe following is my index.md (main page), I set my logo with `heroImage: ./img/logo.jpg`:\r\n```md\r\n---\r\nhome: true\r\nheroImage: ./img/logo.jpg\r\nheroAlt: jun.run\r\nheroText: 奔跑吧,俊!\r\ntagline: —— 前端工程师的必备知识库\r\nactionText: 开始\r\nactionLink: /js/default\r\nfeatures:\r\n - title: 简约\r\n details: 言简意赅\r\n - title: 实用\r\n details: 高频考点\r\n - title: 高效\r\n details: 图文并茂\r\nfooter: MIT Licensed | Copyright © jun.run\r\n---\r\n\r\n```\r\n\r\n\r\nWhen I run my website locally:\r\n\r\n\r\nWhen I deploy it online using Vercel:\r\n\r\n\r\nI found that logo.png is not moved to `/docs/.vitepress/dist/` when delpoying.\n\n### Reproduction\n\nclone the repo to local, and run `yarn docs:build`, or deploy directly to Vercel using `yarn docs:build`.\n\n### Expected behavior\n\n\n\n### System Info\n\n```shell\n\"vitepress\": \"^0.21.6\"\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[2941],{"name":2886,"color":2887},505,"logo lost when deployment","2023-01-21T16:20:13Z","https://github.com/vuejs/vitepress/issues/505",0.73572916,{"description":2948,"labels":2949,"number":2953,"owner":2875,"repository":2876,"state":2889,"title":2954,"updated_at":2955,"url":2956,"score":2957},"### Describe the bug\n\n使用官方文档的部署脚本成功部署到Github Pages之后,此时如果配置使用自定义域名的话,访问时样式会丢失\n\n### Reproduction\n\n1. 博客目录结构如下所示:\u003Cbr />\r\n2. 配置文件如下所示:\u003Cbr /> \n\n### Expected behavior\n\n使用 Github 自带的 https://xihuanxiaorang.github.io/docs/ 访问就没有任何问题,如果是使用自定义域名 https://docs.xiaorang.fun/ 的话,样式就会丢失\n\n### System Info\n\n```Text\nSystem:\r\n OS: Windows 10 10.0.19045\r\n CPU: (4) x64 Intel(R) Core(TM) i5-5200U CPU @ 2.20GHz\r\n Memory: 659.73 MB / 3.92 GB\r\n Binaries:\r\n Node: 20.11.0 - E:\\nodejs\\node.EXE\r\n Yarn: 1.22.21 - E:\\nodejs\\node_global\\yarn.CMD\r\n npm: 10.2.4 - E:\\nodejs\\npm.CMD\r\n pnpm: 8.14.3 - E:\\nodejs\\node_global\\pnpm.CMD\r\n Browsers:\r\n Edge: Chromium (120.0.2210.144)\r\n Internet Explorer: 11.0.19041.3636\r\n npmPackages:\r\n vitepress: 1.0.0-rc.40 => 1.0.0-rc.40\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.",[2950],{"name":2951,"color":2952},"question","5D5FAE",3513,"部署到Github Pages之后,如果使用自定义域名的话样式会丢失","2024-02-07T00:04:15Z","https://github.com/vuejs/vitepress/issues/3513",0.74168086,{"description":2959,"labels":2960,"number":2962,"owner":2875,"repository":2876,"state":2889,"title":2963,"updated_at":2964,"url":2965,"score":2966},"\u003C!--\r\nNOTE:\r\nVitePress is still WIP, and it is not compatible with VuePress.\r\nPlease do not open issue about default theme missing features or something doesn't work like VuePress.\r\n-->\r\n\r\n**Describe the bug**\r\n\r\nWhen index page has a heroImage, it works in `vitepress dev docs` mode but it's not bundled as an asset with `vitepress build docs`.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\n\r\nCreate `docs/index.md`:\r\n\r\n```md\r\n---\r\nhome: true\r\nheroImage: logo.jpg\r\nheroAlt: Logo image\r\nheroText: Test\r\ntagline:\r\nactionText: Info\r\nactionLink: /info\r\n---\r\n```\r\n\r\nadd `docs/logo.jpg` and run `vitepress build docs`.\r\n\r\n**Expected behavior**\r\n\r\n`docs/logo.jpg` is bundled as a hashed file, something like `docs/.vitepress/dist/assets/logo.xxxxx.jpg`, and referenced accordingly.\r\n\r\n**System Info**\r\n- vitepress version: 0.13.2\r\n- vite version: 2.3.3\r\n- Node version: 16.0.0\r\n- OS version: macOS 11.3.1\r\n",[2961],{"name":2886,"color":2887},301,"heroImage not added to dist on build","2023-01-21T16:04:32Z","https://github.com/vuejs/vitepress/issues/301",0.7420007,["Reactive",2968],{},["Set"],["ShallowReactive",2971],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fCfqMoLmB_lCv2pMax6RPcVMdbcZdhpG4A2ZsWGZ0V8c":-1},"/vuejs/vitepress/1826"]