\n\n\u003Cimg width=\"308\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/0e1beb6b-d06b-436c-b106-c924fead87ab\" />\n\n\u003Cimg width=\"931\" alt=\"Image\" src=\"https://github.com/user-attachments/assets/aef6f71a-fa28-4b7c-b512-e6386e18159a\" />\n\n### Describe the solution you'd like\n\nIn my [pull request](https://github.com/vuejs/vitepress/pull/4630), I've introduced custom components that can be overridden in the `enhanceApp` function. In these custom components, I can add custom logic for rendering text, such as using the Vue compile function. \n\nAdditionally, I added a flag to skip the title update, allowing for custom logic implementation. \n\nPlease also see my PR: [https://github.com/vuejs/vitepress/pull/4630](https://github.com/vuejs/vitepress/pull/4630).\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.",[],4637,"Sidenav Components / Skip title update","2025-03-20T12:17:14Z","https://github.com/vuejs/vitepress/issues/4637",0.7559689,{"description":2885,"labels":2886,"number":2888,"owner":2869,"repository":2870,"state":2871,"title":2889,"updated_at":2890,"url":2891,"score":2892},"### Is your feature request related to a problem? Please describe.\r\n\r\nvitepress is currently not capable enough for developing component libraries. While it is fast, it lacks something. We may be able to incorporate support for component capabilities similar to `dumi` to help developers quickly develop Vue component libraries docs.\r\n\r\n```html\r\n\u003Cdemo src=\"../demo.vue\" title=\"Demo block\" desc=\"use demo\" />\r\n```\r\n\r\nAlternatively, use the `desc` defined in the `container` to write Markdown syntax.\r\n\r\n```md\r\n::: demo src=\"../demo.vue\" title=\"Demo block\"\r\n\r\nThis is a `description` that can be written using Markdown.\r\n\r\n:::\r\n```\r\n\r\n### Describe the solution you'd like\r\n\r\nTo address this, I have created the [markdown-it-vitepress-demo](https://github.com/hairyf/markdown-it-vitepress-demo) plugin. I'm not sure if it can be helpful.\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- https://github.com/vuejs/vitepress/issues/987\r\n- https://github.com/vuejs/vitepress/issues/1349\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.",[2887],{"name":2866,"color":2867},2432,"feat(demo): built-in markdown plugin provides support for showcasing demo capabilities.","2024-07-17T14:37:26Z","https://github.com/vuejs/vitepress/issues/2432",0.757896,{"description":2894,"labels":2895,"number":1658,"owner":2869,"repository":2870,"state":2896,"title":2897,"updated_at":2898,"url":2899,"score":2900},"**Is your feature request related to a problem? Please describe.**\r\nThe title of the docs cannot be customized, I have an idea that you can throw APIs about setting the title in `config.js` or some other ways, e.g. I want to set the title to \"xxx - xxx\" instead of \"xxx | xxx\", although I can use `document.title` to modify, but the default is still \"xxx | xxx\" when rendering. Moreover, when there is a `md` file as the home page of the document, the document title will be `h1` title as the title of the home page, e.g. document `h1` is `Installation`, and then the title will be set `Installation | xxx`.\r\n\r\n**Describe the solution you'd like**\r\nThrow an API in `config.js` file, set the title of the home page and other pages according to the `route` through template characters. \r\nFor example, when the route is `/`, the title can be set `${ site.title} - ${ site.description} `, when the route is `/xxx`, the title can be set `${ page.title} - ${ site.title} - ${ site.description }`. Maybe you can also refer to the following configuration structure:\r\n```js\r\n// .vitepress/config.js\r\n...\r\ndocsTitle:{\r\n // Match route “/”\r\n \"/\" : \"${ site.title} - ${ site.description}\",\r\n // Match route “/about” , if a specific route is set \r\n \"/about\" : \"About me\",\r\n // Match route “/xxx” , “ * ” means Wildcard\r\n \"/*\" : \"${ page.title} - ${ site.title} - ${ site.description }\"\r\n}\r\n...\r\n```\r\n \r\n**Describe alternatives you've considered**\r\nCurrently I am using `document.title` to change the docs title (on vuepress 1.5.0) .\r\n",[],"closed","Is it possible to throw API to customize the docs title?","2023-01-21T16:25:40Z","https://github.com/vuejs/vitepress/issues/23",0.71094877,{"description":2902,"labels":2903,"number":2907,"owner":2869,"repository":2870,"state":2896,"title":2908,"updated_at":2909,"url":2910,"score":2911},"\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 the page title is `21E08`. And after build, It will goes as `210000000`. It was treated as scientific notation number \r\n\r\n**To Reproduce** \r\n\r\nSet page frontmatter like next\r\n\r\n```yaml\r\n---\r\ntitle: 21E08\r\nsubtitle: \"xxxxx\"\r\ndate: 2021-03-05\r\ncategory: \"xxx\"\r\n---\r\n```\r\n\r\n**Expected behavior** \r\n\r\nExpect the title will be treated as string not the number\r\n\r\n**System Info** \r\n- vitepress v0.11.3\r\n- vite v2.0.0-beta.30\r\n- Node version: v15.4.0\r\n- OS version: Big Sur 11.0.1 (20B29)\r\n\r\n",[2904],{"name":2905,"color":2906},"bug: pending triage","e99695",255,"Markdown Page Title Parse Error","2023-01-21T16:22:29Z","https://github.com/vuejs/vitepress/issues/255",0.7187182,{"description":2913,"labels":2914,"number":2918,"owner":2869,"repository":2870,"state":2896,"title":2919,"updated_at":2920,"url":2921,"score":2922},"### Is your feature request related to a problem? Please describe.\r\n\r\nVueJS community is moving from JS to TS now. Hence, we have to provide both TS & JS code.\r\n\r\nI already started using VitePress alpha in my OSS project but for another project, I prefer providing TS & JS code via code groups like VuePress.\r\n\r\n### Describe the solution you'd like\r\n\r\nProvide code blocks via markdown (using component is bit ugly for markdown only content). We can inspire from Nuxt content 2 for new syntax\r\n\r\n\u003Cpre>\r\n:::code group\r\n\r\n:::group{ts}\r\n\r\n```ts\r\nconst a: number = 1\r\n```\r\n\r\n:::\r\n\r\n:::group{js}\r\n\r\n```js\r\nconst a = 1\r\n```\r\n\r\n:::\r\n\r\n:::\r\n\u003C/pre>\r\n\r\n### Describe alternatives you've considered\r\n\r\nNone\r\n\r\n### Additional context\r\n\r\nhttps://content.nuxtjs.org/guide/writing/mdc\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] 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.",[2915],{"name":2916,"color":2917},"theme","0754FB",728,"Support code groups and allow adding title to code blocks","2023-01-21T14:17:14Z","https://github.com/vuejs/vitepress/issues/728",0.7287271,{"description":2924,"labels":2925,"number":2926,"owner":2869,"repository":2870,"state":2896,"title":2927,"updated_at":2928,"url":2929,"score":2930},"Spawn from a discussion in https://github.com/vuejs/vitepress/pull/152\r\n\r\nAbout siteDataByRoute, if $title and $description are localized, I think $site should also be localized pointing to siteDataByRoute instead of siteData. I think that users accessing $site from the markdown, should really be looking for $siteDataByRoute.\r\n\r\nIn enhanceApp siteData actually means siteDataByRoute: https://github.com/vuejs/vitepress/blob/master/src/client/app/index.ts#L118\r\n\r\n```ts\r\nexport default {\r\n Layout,\r\n NotFound: () => 'custom 404',\r\n enhanceApp({ app, router, siteData }) {\r\n // `siteData`` is a `ref`` of current site-level metadata. \u003C- this is really siteDataByRoute\r\n }\r\n}\r\n```\r\nSo it makes sense for $site to follow suit. \r\n\r\nWe will be breaking compat slightly here with vuepress, but I think this is a good change that will help avoid i18n issues and it will be really confusing that siteData from enhanceApp is not the same as $siteData in vitepress.\r\n\r\nIf we do this change, we could expose unlocalized siteData with another name. Maybe $unlocalizedSite?",[],159,"$site referencing to siteDataByRoute","2023-01-21T16:24:11Z","https://github.com/vuejs/vitepress/issues/159",0.7462725,{"description":2932,"labels":2933,"number":2935,"owner":2869,"repository":2870,"state":2896,"title":2936,"updated_at":2937,"url":2938,"score":2939},"### Describe the bug\r\n\r\nOn setting frontmatter like below, the page title is still changed to `Home | foo`. It works fine if `home: true` is removed.\r\n\r\n```md\r\n---\r\nhome: true\r\n# ...\r\ntitle: ' '\r\n---\r\n```\r\n\r\nExpected title to be `foo` instead. (`foo` is set as `title` in `.vitepress/config.ts`, using `DefaultTheme`.)\r\n\r\n### Validations\r\n\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\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.",[2934],{"name":2905,"color":2906},492,"`title: x` is not respected if `home: true`","2023-01-21T16:20:14Z","https://github.com/vuejs/vitepress/issues/492",0.748602,{"description":2941,"labels":2942,"number":2943,"owner":2869,"repository":2870,"state":2896,"title":2944,"updated_at":2945,"url":2946,"score":2947},"\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\nCopying the configuration of vuepress to vitepress, the sidebar is not displayed as a result.\r\n\r\n**To Reproduce**\r\nSteps to reproduce the behavior:\r\nClone Repo: [https://github.com/misitebao/template-vitepress.git](https://github.com/misitebao/template-vitepress.git)\r\nRun: npm i && npm run dosc:dev\r\n\r\n**Expected behavior**\r\nDisplay the sidebar normally\r\n\r\n**System Info**\r\n- vitepress version: v0.12.2\r\n- vite version: \r\n- Node version: v14.8.0\r\n- OS version: Win10\r\n\r\n**Additional context**\r\nI want to implement a template template as the basis for subsequent vitepress projects\r\n",[],260,"Copying the configuration of vuepress to vitepress, the sidebar is not displayed as a result.","2023-01-21T16:22:24Z","https://github.com/vuejs/vitepress/issues/260",0.7491966,{"description":2949,"labels":2950,"number":2954,"owner":2869,"repository":2870,"state":2896,"title":2955,"updated_at":2956,"url":2957,"score":2958},"\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\nThe theme is set as follows\r\n\r\n``` js\r\n{\r\n ...,\r\n title: 'Vite vui',\r\n base: '/vite-vui-docs/',\r\n themeConfig: {\r\n repo: 'bhabgs/vite-vui',\r\n search: true, // here\r\n sidebar: {\r\n '/': [\r\n {\r\n text: 'vui',\r\n children: [\r\n { text: '介绍', link: '/' },\r\n { text: '日志', link: '/components/log' },\r\n { text: 'Button', link: '/components/button/' },\r\n { text: 'Layout', link: '/components/layout/' },\r\n { text: 'contextmenu', link: '/components/contextmenu/' },\r\n ],\r\n },\r\n {\r\n text: 'vuu',\r\n children: [\r\n { text: '介绍', link: '/vuu/' },\r\n { text: '日志', link: '/vuu/log' },\r\n { text: '某个功能', link: '/vuu/any' },\r\n ],\r\n },\r\n ],\r\n },\r\n author: 'bhabgs',\r\n nav: [\r\n { text: '首页', link: '/' },\r\n { text: '分类', link: '/tags' },\r\n ],\r\n },\r\n dest: 'public',\r\n}\r\n```\r\n\r\n**To Reproduce**\r\n[to view](https://github.com/bhabgs/vite-vui/tree/master/docs)\r\n\r\n\r\n**Expected behavior**\r\nshow search box.\r\n\r\n\r\n\r\n**System Info**\r\n- vitepress version: 0。12.2\r\n- vite version: 2.0.3\r\n- Node version: 14*\r\n- OS version: 11.2.2\r\n\r\n\r\n",[2951],{"name":2952,"color":2953},"invalid","ffffff",272,"Invalid search for topic Settings !!!","2023-01-21T16:04:09Z","https://github.com/vuejs/vitepress/issues/272",0.75195533,["Reactive",2960],{},["Set"],["ShallowReactive",2963],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$fhjX6m9A5iCNYrvxy6sPeCYLQPUH-qc-2kiTAQPIU-jA":-1},"/vuejs/vitepress/158"]