Merge pull request #1169 from vuejs-translations/sync

Sync(autopr) #e4641141 — upstream merge & translate

Author: veaba

.github/scripts/auto-pr/prompts/translation.md

@@ -164,25 +164,29 @@
 
 > 自然语言翻译为中文，URL 更新为新地址但不翻译。
 
-### 示例 6：链接列表 (翻译链接文本，保留 URL)
+### 示例 6：链接列表 (翻译链接文本，转为中文版本的 URL)
+
+**英文版本的 `vite.dev` 和中文版本 `cn.vite.dev` 的映射**：
+
+- `https://vite.dev` => `https://cn.vite.dev`
 
 ```json
 {
-  "current": "- [Vite 生产环境指南](https://cn.vitejs.dev/guide/build.html)\n- [Vite 部署指南](https://cn.vitejs.dev/guide/static-deploy.html)",
+  "current": "- [Vite 生产环境指南](https://cn.vite.dev/guide/build.html)\n- [Vite 部署指南](https://cn.vite.dev/guide/static-deploy.html)",
   "incoming": "- [Vite production build guide](https://vite.dev/guide/build.html)\n- [Vite deployment guide](https://vite.dev/guide/static-deploy.html)",
-  "review": "- [Vite 生产环境构建指南](https://vite.dev/guide/build.html)\n- [Vite 部署指南](https://vite.dev/guide/static-deploy.html)"
+  "review": "- [Vite 生产环境构建指南](https://vite.dev/guide/build.html)\n- [Vite 部署指南](https://cn.vite.dev/guide/static-deploy.html)"
 }
 ```
 
-> 链接文本是自然语言，必须翻译。URL 更新为新地址。
+> 链接文本是自然语言，必须翻译。URL 更新为新的中文地址。
 
-### 示例 7：代码注释 (翻译注释内容)
+### 示例 7：代码注释 (翻译注释内容，并转为中文版本的 URL)
 
 ```json
 {
-  "current": "// 确保只在服务端渲染时调用\n  // https://cn.vitejs.dev/guide/ssr.html#conditional-logic",
+  "current": "// 确保只在服务端渲染时调用\n  // https://cn.vite.dev/guide/ssr.html#conditional-logic",
   "incoming": "// make sure to only call it during SSR\n  // https://vite.dev/guide/ssr.html#conditional-logic",
-  "review": "// 确保只在服务端渲染时调用\n  // https://vite.dev/guide/ssr.html#conditional-logic"
+  "review": "// 确保只在服务端渲染时调用\n  // https://cn.vite.dev/guide/ssr.html#conditional-logic"
 }
 ```
 

.github/scripts/auto-pr/src/create-pr-and-review.js

@@ -37,12 +37,14 @@ export function buildPrBody({
   ignoreGlobs = "",
   detectChangedFiles = "",
 }) {
-  let body = `## Upstream Sync\n\n- Upstream: \`${upstreamRepo}\` @ \`${upstreamHash}\`\n- Merge result: \`${mergeResult}\`\n`;
+  let body = `## Upstream Sync\n\n`;
 
   if (syncBaseHash && upstreamHash) {
-    body += `\n- [View upstream changes](https://github.com/${upstreamRepo}/compare/${syncBaseHash}...${upstreamHash})\n`;
+    body += `- Upstream: https://github.com/${upstreamRepo}/compare/${syncBaseHash}...${upstreamHash}`;
   }
 
+  body += `\n- Merge result: \`${mergeResult}\`\n`;
+
   body += `\n\n## Changes\n`;
 
   if (conflictFiles) {

.node-version

@@ -0,0 +1 @@
+22

.vitepress/config.ts

@@ -18,12 +18,13 @@ import {
 const nav: ThemeConfig['nav'] = [
   {
     text: '文档',
-    activeMatch: `^/(guide|style-guide|cookbook|examples)/`,
+    activeMatch: `^/(guide|tutorial|examples|api|glossary|error-reference)/`,
     items: [
+      { text: '快速上手', link: '/guide/quick-start' },
       { text: '深度指南', link: '/guide/introduction' },
       { text: '互动教程', link: '/tutorial/' },
       { text: '示例', link: '/examples/' },
-      { text: '快速上手', link: '/guide/quick-start' },
+      { text: 'API', link: '/api/' },
       // { text: '风格指南', link: '/style-guide/' },
       { text: '术语表', link: '/glossary/' },
       { text: '错误码参照表', link: '/error-reference/' },
@@ -37,11 +38,6 @@ const nav: ThemeConfig['nav'] = [
       }
     ]
   },
-  {
-    text: 'API',
-    activeMatch: `^/api/`,
-    link: '/api/'
-  },
   {
     text: '演练场',
     link: 'https://play.vuejs.org'
@@ -53,7 +49,6 @@ const nav: ThemeConfig['nav'] = [
       {
         text: '资源',
         items: [
-          { text: '合作伙伴', link: '/partners/' },
           { text: '主题', link: '/ecosystem/themes' },
           { text: 'UI 组件', link: 'https://ui-libs.vercel.app/' },
           {
@@ -134,13 +129,12 @@ const nav: ThemeConfig['nav'] = [
     ]
   },
   {
-    text: '赞助',
-    link: '/sponsor/'
-  },
-  {
-    text: '合作伙伴',
-    activeMatch: `^/partners/`,
-    link: '/partners/'
+    text: '支持',
+    activeMatch: `^/(sponsor|partners)/`,
+    items: [
+      { text: 'Sponsor', link: '/sponsor/' },
+      { text: 'Partners', link: '/partners/' }
+    ]
   }
 ]
 
@@ -702,6 +696,11 @@ export default defineConfigWithTheme<ThemeConfig>({
         text: 'Français',
         repo: 'https://github.com/vuejs-translations/docs-fr'
       },
+      {
+        link: 'https://de.vuejs.org',
+        text: 'Deutsch',
+        repo: 'https://github.com/vuejs-translations/docs-de'
+      },
       {
         link: 'https://ko.vuejs.org',
         text: '한국어',

.vitepress/theme/components/CardList.vue

@@ -4,7 +4,7 @@ import { computed, onMounted, ref, shallowRef } from 'vue'
 const props = withDefaults(
   defineProps<{
     items: Array<any>
-    filter?: (item: any) => boolean
+    filter?: (item: any) => boolean | undefined
     cardComponent: any
     showLinkToAll?: boolean
     shuffleItems?: boolean

.vitepress/theme/components/Home.vue

@@ -89,20 +89,22 @@ onMounted(load)
 
   <section id="highlights" class="vt-box-container">
     <div class="vt-box">
-      <h2>易学易用</h2>
+      <h2>灵活多变</h2>
       <p>
-        基于标准 HTML、CSS 和 JavaScript 构建，提供容易上手的 API
-        和一流的文档。
+        丰富的、可渐进式集成的生态系统，可以根据应用规模在库和框架间切换自如。
       </p>
     </div>
     <div class="vt-box">
       <h2>性能出色</h2>
-      <p>经过编译器优化、完全响应式的渲染系统，几乎不需要手动优化。</p>
+      <p>
+        经过编译器优化、完全响应式的渲染系统，几乎不需要手动优化。
+      </p>
     </div>
     <div class="vt-box">
-      <h2>灵活多变</h2>
+      <h2>易学易用</h2>
       <p>
-        丰富的、可渐进式集成的生态系统，可以根据应用规模在库和框架间切换自如。
+        基于标准 HTML、CSS 和 JavaScript 构建，提供容易上手的 API
+        和一流的文档。
       </p>
     </div>
   </section>
@@ -336,6 +338,10 @@ html:not(.dark) .accent,
   background-color: transparent;
 }
 
+#highlights .vt-box h2::first-letter{
+  color: var(--vt-c-green);
+}
+
 #spsrs {
   max-width: 900px;
   margin: 0px auto;

.vitepress/theme/components/NewsLetter.vue

@@ -45,7 +45,7 @@ import { VTLink } from '@vue/theme'
           href="https://news.vuejs.org/"
           no-icon
           >news.vuejs.org</VTLink> 阅读之前的期刊并收听我们的播客。你也可以在
-        <VTLink class="link" href="https://twitter.com/vuejs" no-icon>Twitter</VTLink> 关注我们，或加入我们的
+        <VTLink class="link" href="https://x.com/vuejs" no-icon>Twitter</VTLink> 关注我们，或加入我们的
         <VTLink class="link" href="https://discord.com/invite/vue" no-icon>Discord</VTLink> 家园。
       </p>
     </div>

.vitepress/theme/components/PreferenceTooltip.vue

@@ -13,7 +13,7 @@ const { page } = useData()
 type Source = 'url-query' | 'url-header' | 'default'
 let source: Source | false =
   inBrowser && localStorage.getItem(preferCompositionKey) === null
-    ? 'default'
+    ? 'default' as Source
     : false
 
 if (inBrowser) {
@@ -104,7 +104,7 @@ function dismiss() {
           一些页面根据所选的 API 风格将包含不同的内容。可以通过此开关在它们之间切换。
         </p>
       </template>
-      <template v-if="source && source.startsWith('url')">
+      <template v-else-if="source && source.startsWith('url')">
         <p>
           正在显示
           {{ preferComposition ? '组合式' : '选项式' }} API 的内容，这是因为

.vitepress/theme/components/SiteMap.vue

@@ -62,6 +62,8 @@ const items = nav
 
 #sitemap .vt-link {
   font-size: 0.9em;
-  color: var(--vt-c-text-2);
+  /* increased contrast for better legibility (WCAG 1.4.3) */
+  color: var(--vt-c-text-1);
+  opacity: 0.75;
 }
 </style>

.vitepress/theme/components/VueSchoolLink.vue

@@ -23,7 +23,6 @@ export default {
   margin: 28px 0;
   background-color: var(--vt-c-bg-soft);
   padding: 1em 1.25em;
-  border-radius: 2px;
   position: relative;
   display: flex;
   border-radius: 8px;