```\r\n\r\nIt doesn't seem to be correct:\r\n\r\n\r\n\r\nHow to make it look correct, just like on the homepage?:\r\n\r\n\r\n\r\n",[2884],{"name":2871,"color":2872},4273,"How to use default Vue components elsewhere","2024-12-03T17:27:39Z","https://github.com/vuejs/vitepress/issues/4273",0.7351904,{"description":2891,"labels":2892,"number":2897,"owner":2874,"repository":2875,"state":2876,"title":2898,"updated_at":2899,"url":2900,"score":2901},"### Is your feature request related to a problem? Please describe.\n\nIn the monorepo development mode, sometimes the rendering in docs depends on the code in another repository, so when the code in another repository changes, it is expected to trigger a hot reload of docs\n\n### Describe the solution you'd like\n\nSupport configuration to watch specified folders to trigger hot reload\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.",[2893,2896],{"name":2894,"color":2895},"need more info","bdbefc",{"name":2871,"color":2872},4221,"Support hot reload by watching files not under docs","2024-12-03T17:27:50Z","https://github.com/vuejs/vitepress/issues/4221",0.73802924,{"description":2903,"labels":2904,"number":2906,"owner":2874,"repository":2875,"state":2876,"title":2907,"updated_at":2908,"url":2909,"score":2910},"### Is your feature request related to a problem? Please describe.\n\nMy project spans several repositories under a single GitHub user. I'm building a vitepress project (which is in its own repository) for documentation and API reference for all my repositories because they are all related to each other. I like to include Markdown and code snippets from each of the repositories. \r\n\r\nI've tried this for including files from my vitepress repository, like this\r\n\r\n```markdown\r\n\u003C!--@include: ./setup.md-->\r\n```\r\n\r\nand it works nicely, but \r\n\r\n```markdown\r\n\u003C!--@include: https://github.com/CVEProject/cvelistV5/blob/main/README.md#reporting-issues -->\r\n```\r\n\r\ndoes not work. \r\n\r\nIt would be very helpful to be able to include arbitrary markdown and code into my vitepress project. Is there a way to do this?\n\n### Describe the solution you'd like\n\nIt would be very helpful to be able to include arbitrary markdown and code into my vitepress project. \r\n\r\nSections from a Markdown file:\r\n```markdown\r\n\u003C!--@include: https://github.com/CVEProject/cvelistV5/blob/main/README.md#reporting-issues -->\r\n```\r\n\r\nLines from a JSON (or any source code) file:\r\n```markdown\r\n\u003C!--@include: https://github.com/CVEProject/cvelistV5/blob/main/cves/1999/0xxx/CVE-1999-0001.json{123,131} -->\r\n```\r\n\r\nIs there a way to do this?\n\n### Describe alternatives you've considered\n\nOne possible alternative to doing it in vitepress' markdown extension is to write a Vue component that reads in the file and displays that, but having it as a feature of vitepress so others can use it would be more useful to the vitepress community.\n\n### Additional context\n\nI think this feature would be useful for writing Guides and API References, but also other documentation (e.g., a full tutorial for using Vue and vitepress in a Docker container, in a section for how to set up the development environment) where it would be even more important so that the doc is always up-to-date with its dependent projects.\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.",[2905],{"name":2871,"color":2872},3349,"@include markdown and code files from an arbitrary public URL","2025-03-02T18:10:08Z","https://github.com/vuejs/vitepress/issues/3349",0.7399598,{"description":2912,"labels":2913,"number":2915,"owner":2874,"repository":2875,"state":2916,"title":2917,"updated_at":2918,"url":2919,"score":2920},"### Is your feature request related to a problem? Please describe.\n\nNo\n\n### Describe the solution you'd like\n\nAdd Crowdin or Weblate support\n\n### Describe alternatives you've considered\n\nDocusaurus里官方有Crowdin的案例\r\nVitepress在做国际化的时候是否会加入Crowdin或者Weblate的案例?\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] 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.",[2914],{"name":2871,"color":2872},1243,"closed","Crowdin or Weblate support?","2023-08-11T00:04:20Z","https://github.com/vuejs/vitepress/issues/1243",0.60289234,{"description":2922,"labels":2923,"number":2928,"owner":2874,"repository":2875,"state":2916,"title":2929,"updated_at":2930,"url":2931,"score":2932},"### Describe the bug\r\n\r\nSimilar to https://github.com/vuejs/vitepress/issues/849\r\n\r\nVitepress imports `body-scroll-lock` and `@vueuse/core` from the app, rather than from vitepress (which declares the dependency).\r\n\r\nThis is a problem then modules are resolved with pnpm or Yarn which do not allow for resolution of hoisted node_modules. This has historically been not affected Vite because it would ignore the importing context when resolving dependencies (which is fixed in https://github.com/vitejs/vite/pull/9763)\r\n\r\n### Reproduction\r\n\r\nUse https://github.com/vitejs/vite/pull/9763 for Vite when using Vitepress\r\n\r\n### Expected behavior\r\n\r\nVitepress should instead import and/or resolve `body-scroll-lock` and `@vueuse/core` from Vitepress itself rather than the host app (which probably does not declare dependencies on `body-scroll-lock` and `@vueuse/core`.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 13.3\r\n CPU: (10) arm64 Apple M1 Max\r\n Memory: 18.95 GB / 64.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.6.0 - ~/Library/Caches/fnm_multishells/12267_1680539322066/bin/node\r\n npm: 8.13.2 - /opt/uber/bin/npm\r\n Browsers:\r\n Chrome: 111.0.5563.146\r\n Safari: 16.4\r\n npmPackages:\r\n vitepress: ^1.0.0-alpha.61 => 1.0.0-alpha.61\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.dev).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[2924,2927],{"name":2925,"color":2926},"bug: pending triage","e99695",{"name":2871,"color":2872},2187,"Vitepress relies on node_modules hoisting for body-scroll-lock and @vueuse/core","2023-08-14T00:04:20Z","https://github.com/vuejs/vitepress/issues/2187",0.70688903,{"description":2934,"labels":2935,"number":2937,"owner":2874,"repository":2875,"state":2916,"title":2938,"updated_at":2939,"url":2940,"score":2941},"### Describe the bug\r\n\r\nHere is my website:\r\ngithub: https://github.com/Lark-Base-Team/js-sdk-docs\r\nAccessing https://lark-base-team.github.io/js-sdk-docs/zh/start\r\ndoes not display the icons.\r\n\r\nBelow is my configuration file:\r\n```\r\nexport default defineConfig({\r\n lastUpdated: true,\r\n cleanUrls: true,\r\n base: '/js-sdk-docs/',\r\n themeConfig: {\r\n logo: 'logo.svg',\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n },\r\n head: [\r\n ['link', { rel: 'icon', href: 'logo.svg' }],\r\n ],\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n // sitemap: {\r\n // hostname: 'https://basejsapi.com',\r\n // },\r\n lang: 'zh',\r\n locales: {\r\n zh: {\r\n label: '中文',\r\n lang: 'zh',\r\n dir: '/zh',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/zh/api/guide', activeMatch: 'zh/api' },\r\n ],\r\n sidebar: getZhSideBar(),\r\n },\r\n },\r\n en: {\r\n label: 'English',\r\n lang: 'en',\r\n dir: '/en',\r\n title: 'Base JS SDK',\r\n description: 'Base JS SDK Docs',\r\n themeConfig: {\r\n search: {\r\n provider: 'local'\r\n },\r\n nav: [\r\n { text: 'API', link: '/en/api/guide.md' },\r\n ],\r\n sidebar: getEnSideBar(),\r\n },\r\n }\r\n },\r\n})\r\n\r\n```\r\n\r\n### Reproduction\r\n\r\nvitepress: 1.0.0-rc.10\r\n\r\n### Expected behavior\r\n\r\nshow icon like this\r\n\r\n\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 13.6\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 210.73 MB / 32.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 18.14.2 - ~/.nvm/versions/node/v18.14.2/bin/node\r\n Yarn: 1.22.19 - /opt/homebrew/bin/yarn\r\n npm: 9.5.0 - ~/.nvm/versions/node/v18.14.2/bin/npm\r\n pnpm: 8.7.4 - ~/.nvm/versions/node/v18.14.2/bin/pnpm\r\n Browsers:\r\n Chrome: 117.0.5938.149\r\n Safari: 16.6\r\n npmPackages:\r\n vitepress: 1.0.0-rc.10 => 1.0.0-rc.10\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.",[2936],{"name":2925,"color":2926},3059,"After I added the relevant internationalization configuration, the icons in the public directory cannot be loaded on pages in certain languages.","2023-10-20T00:04:32Z","https://github.com/vuejs/vitepress/issues/3059",0.7084934,{"description":2943,"labels":2944,"number":2948,"owner":2874,"repository":2875,"state":2916,"title":2949,"updated_at":2950,"url":2951,"score":2952},"### Is your feature request related to a problem? Please describe.\r\n\r\nref: https://github.com/vuejs/vitepress/issues/883#issuecomment-1614242193 https://github.com/vuejs/vitepress/discussions/2516\r\n\r\nWhen I using Dynamic Routes. To uniformly manage and generate pages with a consistent structure, which involves changing the `header` `title` [#2516](https://github.com/vuejs/vitepress/discussions/2516), the suggestion is also to use `.vitepress/config.js` to use `transformPageData`\r\n\r\n```js\r\n// .vitepress/config.js\r\n{\r\n // ...\r\n transformPageData: (pageData, { siteConfig }) => {\r\n if (page-foo) {\r\n // change header, title and resolve page data\r\n } else if (page-bar) {\r\n // ...\r\n }\r\n}\r\n```\r\n\r\n### Describe the solution you'd like\r\n\r\nI think if `transformPageData` would be in Dynamic Routes configure `[pkg].paths.js`. Avoid me adding too many logic in `.vitepress/config.js`, and just managing it in only one place. clear and good management\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### 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.",[2945],{"name":2946,"color":2947},"build","377ba8",2637,"[Dynamic Routes]: Add `transformPageData` configure","2025-03-04T04:43:50Z","https://github.com/vuejs/vitepress/issues/2637",0.70900375,{"description":2954,"labels":2955,"number":2956,"owner":2874,"repository":2875,"state":2916,"title":2957,"updated_at":2958,"url":2959,"score":2960},"### Describe the bug\r\n\r\nThanks for building vitepress!\r\n\r\nI have a vitepress website and I found that a custom vue component with [multiple root nodes](https://v3-migration.vuejs.org/new/fragments.html) will fail to render in production mode.\r\n\r\n### Reproduction\r\n\r\nhttps://github.com/ast-grep/ast-grep.github.io/tree/repro-vite\r\n\r\n```\r\ngit clone --branch repro-vite git@github.com:ast-grep/ast-grep.github.io.git\r\npnpm install\r\npnpm build\r\npnpm serve\r\n```\r\n\r\nThen visit localhost:4173\r\n\r\n### Expected behavior\r\n\r\nThe `Supported Languages` section, of which the [code is here](https://github.com/ast-grep/ast-grep.github.io/blob/repro-vite/website/src/homepage/Languages.vue), should render.\r\n\r\n\u003Cimg width=\"1115\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/2faa0688-df54-47a6-9e47-cc3e5f8f85ac\">\r\n\r\n\r\n### System Info\r\n\r\n```Text\r\nSystem:\r\n OS: macOS 12.6\r\n CPU: (8) arm64 Apple M1\r\n Memory: 81.77 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.20.1 - ~/Library/Caches/fnm_multishells/62761_1699555887568/bin/node\r\n Yarn: 1.22.19 - ~/Library/pnpm/yarn\r\n npm: 8.19.4 - ~/Library/Caches/fnm_multishells/62761_1699555887568/bin/npm\r\n pnpm: 8.6.3 - ~/Library/pnpm/pnpm\r\n Browsers:\r\n Chrome: 119.0.6045.123\r\n Safari: 15.6.1\r\n```\r\n\r\n\r\n### Additional context\r\n\r\nThe languages.vue has two root elements in the template.\r\n\r\nSource\r\n\u003Cimg width=\"405\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/e92eb6f2-1d61-4b3a-b65d-fa71502a675c\">\r\n\r\n\r\nActual rendering include zero language images: \r\n\u003Cimg width=\"753\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/8f7b4a16-06da-4587-83aa-5ded94ad0ab6\">\r\nWith HTML:\r\n\u003Cimg width=\"424\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/7a4fe317-db1b-429e-a1d1-4be2fa63f6bf\">\r\n\r\n----\r\n\r\nHowever, it looks like the static HTML built on server side is correct.\r\n\r\nRendering if JS is disabled\r\n\u003Cimg width=\"876\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/ab2ffe30-d9bd-4e0d-b2bb-d82e36540297\">\r\nActual HTML without JS\r\n\u003Cimg width=\"391\" alt=\"image\" src=\"https://github.com/vuejs/vitepress/assets/2883231/1af71121-dbae-4115-882e-ef348b931ca9\">\r\n\r\n---\r\nAlso, if I [avoid the multiple root nodes](https://github.com/ast-grep/ast-grep.github.io/blob/main/website/src/homepage/Languages.vue#L2), the [page looks like fine](https://ast-grep.github.io/).\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.",[],3199,"Multiple root nodes custom Vue element will fail to render in vitepress","2023-11-19T00:04:54Z","https://github.com/vuejs/vitepress/issues/3199",0.72130585,{"description":2962,"labels":2963,"number":2967,"owner":2874,"repository":2875,"state":2916,"title":2968,"updated_at":2969,"url":2970,"score":2971},"Hello VitePress Team,\r\n\r\nI am encountering two issues with my VitePress project and seeking guidance.\r\n\r\n1. **Sidebar Title Formatting Not Effective**: \r\n I have been trying to customize the sidebar title formatting in my VitePress site, but it seems not to be working as expected. Despite using the recommended plugins, including `toc`, the sidebar either doesn't reflect the specified title formats or disappears completely. Attached is a screenshot of my current interface for reference:\r\n \r\n\r\n Here is the code snippet I am using (I've ensured all necessary libraries are installed):\r\n \r\n\r\n Could you please clarify if there's anything I am missing or doing incorrectly? Any guidance on how to properly format the sidebar titles would be greatly appreciated.\r\n\r\n2. **Navigation Placement on the Left**:\r\n I am trying to achieve a layout similar to VuePress where the navigation is on the left side. Although I have disabled the sidebar and set `aside: \"left\"`, the final layout seems to have excessive white space on the left. How should I configure it to get the desired layout? Here is a screenshot showing the current layout:\r\n \r\n\r\nThank you for your assistance. Looking forward to your suggestions and solutions.\r\n",[2964],{"name":2965,"color":2966},"question","5D5FAE",3422,"侧边栏配置","2024-01-16T00:04:37Z","https://github.com/vuejs/vitepress/issues/3422",0.72554874,["Reactive",2973],{},["Set"],["ShallowReactive",2976],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fjlzfEvYqwLiDyWAerQkooBMW58hOYfvku22v4Ny0ptk":-1},"/vuejs/vitepress/1221"]