Sync #d4527e

.gitignore

@@ -15,7 +15,6 @@
 .Trashes
 .VolumeIcon.icns
 .com.apple.timemachine.donotpresent
-.idea
 
 # Directories potentially created on remote AFP share
 .AppleDB
@@ -99,6 +98,7 @@ dist/
 # vitepress build output
 .vitepress/dist
 .vitepress/cache
+.vitepress/.temp
 
 # Serverless directories
 .serverless/
@@ -112,5 +112,5 @@ src/examples/data.json
 src/tutorial/data.json
 draft.md
 
-# IDEs
+# folders created by IDE
 .idea

.npmrc

@@ -0,0 +1 @@
+package-manager-strict=false

.prettierignore

@@ -0,0 +1 @@
+*.vue

.vitepress/config.ts

@@ -1,10 +1,15 @@
+import fs from 'fs'
+import path from 'path'
+import { defineConfigWithTheme, type HeadConfig, type Plugin } from 'vitepress'
 import type { Config as ThemeConfig } from '@vue/theme'
+import llmstxt from 'vitepress-plugin-llms'
 import baseConfig from '@vue/theme/config'
 import { defineConfigWithTheme } from 'vitepress'
 import fs from 'fs'
 import { headerPlugin } from './headerMdPlugin'
 import path from 'path'
 // import { textAdPlugin } from './textAdMdPlugin'
+import { groupIconMdPlugin, groupIconVitePlugin } from 'vitepress-plugin-group-icons'
 
 const nav: ThemeConfig['nav'] = [
   {
@@ -45,6 +50,7 @@ const nav: ThemeConfig['nav'] = [
         text: '資源',
         items: [
           { text: '合作伙伴', link: '/partners/' },
+          { text: 'Developers', link: '/developers/' },
           { text: '主題', link: '/ecosystem/themes' },
           { text: 'UI 組件', link: 'https://ui-libs.vercel.app/' },
           {
@@ -125,9 +131,13 @@ const nav: ThemeConfig['nav'] = [
     link: '/sponsor/'
   },
   {
-    text: '合作伙伴',
-    link: '/partners/',
-    activeMatch: `^/partners/`
+    text: 'Experts',
+    badge: { text: 'NEW' },
+    activeMatch: `^/(partners|developers)/`,
+    items: [
+      { text: 'Partners', link: '/partners/' },
+      { text: 'Developers', link: '/developers/', badge: { text: 'NEW' } }
+    ]
   }
 ]
 
@@ -176,15 +186,15 @@ export const sidebar: ThemeConfig['sidebar'] = {
           link: '/guide/essentials/event-handling'
         },
         { text: '表單輸入綁定', link: '/guide/essentials/forms' },
-        {
-          text: '生命週期',
-          link: '/guide/essentials/lifecycle'
-        },
         { text: '偵聽器', link: '/guide/essentials/watchers' },
         { text: '模板引用', link: '/guide/essentials/template-refs' },
         {
           text: '組件基礎',
           link: '/guide/essentials/component-basics'
+        },
+        {
+          text: 'Lifecycle Hooks',
+          link: '/guide/essentials/lifecycle'
         }
       ]
     },
@@ -368,6 +378,10 @@ export const sidebar: ThemeConfig['sidebar'] = {
         {
           text: '依賴注入',
           link: '/api/composition-api-dependency-injection'
+        },
+        {
+          text: 'Helpers',
+          link: '/api/composition-api-helpers'
         }
       ]
     },
@@ -417,6 +431,7 @@ export const sidebar: ThemeConfig['sidebar'] = {
     {
       text: '進階 API',
       items: [
+        { text: 'Custom Elements', link: '/api/custom-elements' },
         { text: '渲染函數', link: '/api/render-function' },
         { text: '服務端渲染', link: '/api/ssr' },
         { text: 'TypeScript 工具類型', link: '/api/utility-types' },
@@ -486,10 +501,6 @@ export const sidebar: ThemeConfig['sidebar'] = {
           text: '帶過渡動畫的列表',
           link: '/examples/#list-transition'
         },
-        {
-          text: 'TodoMVC',
-          link: '/examples/#todomvc'
-        }
       ]
     },
     {
@@ -556,44 +567,29 @@ export const sidebar: ThemeConfig['sidebar'] = {
   ]
 }
 
-const i18n: ThemeConfig['i18n'] = {
-  search: '搜索',
-  menu: '菜單',
-  toc: '本頁目錄',
-  returnToTop: '返回頂部',
-  appearance: '外觀',
-  previous: '前一篇',
-  next: '下一篇',
-  pageNotFound: '頁面未找到',
-  deadLink: {
-    before: '你打開了一個不存在的鏈接：',
-    after: '。'
-  },
-  deadLinkReport: {
-    before: '不介意的話請提交到',
-    link: '這裡',
-    after: '，我們會跟進修復。'
-  },
-  footerLicense: {
-    before: '',
-    after: ''
-  },
-  ariaAnnouncer: {
-    before: '',
-    after: '已經加載完畢'
-  },
-  ariaDarkMode: '切換深色模式',
-  ariaSkipToContent: '直接跳到內容',
-  ariaToC: '當前頁面的目錄',
-  ariaMainNav: '主導航',
-  ariaMobileNav: '移動版導航',
-  ariaSidebarNav: '側邊欄導航'
+// Placeholder of the i18n config for @vuejs-translations.
+// const i18n: ThemeConfig['i18n'] = {
+// }
+
+function inlineScript(file: string): HeadConfig {
+  return [
+    'script',
+    {},
+    fs.readFileSync(
+      path.resolve(__dirname, `./inlined-scripts/${file}`),
+      'utf-8'
+    )
+  ]
 }
 
 export default defineConfigWithTheme<ThemeConfig>({
   extends: baseConfig,
 
-  lang: 'zh-CN',
+  sitemap: {
+    hostname: 'https://zh-hk.vuejs.org'
+  },
+
+  lang: 'zh-HK',
   title: 'Vue.js',
   description: 'Vue.js - 漸進式的 JavaScript 框架',
   srcDir: 'src',
@@ -624,17 +620,11 @@ export default defineConfigWithTheme<ThemeConfig>({
       'link',
       {
         rel: 'preconnect',
-        href: 'https://sponsors.vuejs.org'
+        href: 'https://automation.vuejs.org'
       }
     ],
-    [
-      'script',
-      {},
-      fs.readFileSync(
-        path.resolve(__dirname, './inlined-scripts/restorePreference.js'),
-        'utf-8'
-      )
-    ],
+    inlineScript('restorePreference.js'),
+    inlineScript('uwu.js'),
     [
       'script',
       {
@@ -650,7 +640,8 @@ export default defineConfigWithTheme<ThemeConfig>({
         src: 'https://vueschool.io/banner.js?affiliate=vuejs&type=top',
         async: 'true'
       }
-    ]
+    ],
+    inlineScript('perfops.js')
   ],
 
   themeConfig: {
@@ -666,7 +657,7 @@ export default defineConfigWithTheme<ThemeConfig>({
       },
       {
         link: 'https://cn.vuejs.org',
-        text: '简体中文',
+        text: '簡體中文',
         repo: 'https://github.com/vuejs-translations/docs-zh-cn'
       },
       {
@@ -712,13 +703,23 @@ export default defineConfigWithTheme<ThemeConfig>({
       {
         link: 'https://ru.vuejs.org',
         text: 'Русский',
-        repo: 'https://github.com/translation-gang/docs-ru'
+        repo: 'https://github.com/vuejs-translations/docs-ru'
       },
       {
         link: 'https://cs.vuejs.org',
         text: 'Čeština',
         repo: 'https://github.com/vuejs-translations/docs-cs'
       },
+      {
+        link: 'https://zh-hk.vuejs.org',
+        text: '繁體中文',
+        repo: 'https://github.com/vuejs-translations/docs-zh-hk'
+      },
+      {
+        link: 'https://pl.vuejs.org',
+        text: 'Polski',
+        repo: 'https://github.com/vuejs-translations/docs-pl',
+      },
       {
         link: '/translations/',
         text: '幫助我們翻譯！',
@@ -803,6 +804,7 @@ export default defineConfigWithTheme<ThemeConfig>({
     theme: 'github-dark',
     config(md) {
       md.use(headerPlugin)
+        .use(groupIconMdPlugin)
       // .use(textAdPlugin)
     }
   },
@@ -827,11 +829,40 @@ export default defineConfigWithTheme<ThemeConfig>({
       }
     },
     build: {
-      minify: 'terser',
       chunkSizeWarningLimit: Infinity
     },
     json: {
       stringify: true
-    }
+    },
+    plugins: [
+      llmstxt({
+        ignoreFiles: [
+          'about/team/**/*',
+          'about/team.md',
+          'about/privacy.md',
+          'about/coc.md',
+          'developers/**/*',
+          'ecosystem/themes.md',
+          'examples/**/*',
+          'partners/**/*',
+          'sponsor/**/*',
+          'index.md'
+        ],
+        customLLMsTxtTemplate: `\
+# Vue.js
+
+Vue.js - The Progressive JavaScript Framework
+
+## Table of Contents
+
+{toc}`
+      }) as Plugin,
+      groupIconVitePlugin({
+        customIcon: {
+          cypress: 'vscode-icons:file-type-cypress',
+          'testing library': 'logos:testing-library'
+        }
+      }) as Plugin
+    ]
   }
 })

.vitepress/inlined-scripts/perfops.js

@@ -0,0 +1,9 @@
+;((d) => {
+  window.rum = { key: 'a9efvfeu' }
+  var script = d.createElement('script')
+  script.src = '/rom3.min.js'
+  script.type = 'text/javascript'
+  script.defer = true
+  script.async = true
+  d.getElementsByTagName('head')[0].appendChild(script)
+})(document)

.vitepress/inlined-scripts/restorePreference.js

@@ -8,6 +8,6 @@
   restore('vue-docs-prefer-composition', 'prefer-composition', true)
   restore('vue-docs-prefer-sfc', 'prefer-sfc', true)
 
-  window.__VUE_BANNER_ID__ = 'vueconfus2024'
+  window.__VUE_BANNER_ID__ = 'viteconf2025'
   restore(`vue-docs-banner-${__VUE_BANNER_ID__}`, 'banner-dismissed')
 })()

.vitepress/inlined-scripts/uwu.js

@@ -0,0 +1,3 @@
+if (location.search.includes('?uwu')) {
+  document.documentElement.classList.add('uwu')
+}