Merge branch 'main' into main

Author: 3vorp

.github/workflows/stale.yml

@@ -1,12 +1,14 @@
 name: Close stale issues and PRs
 on:
+  schedule:
+    - cron: '0 12 1,15 * *'
   workflow_dispatch:
 
 jobs:
   stale:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/stale@v9
+      - uses: actions/stale@v10
         with:
           days-before-stale: 30
           days-before-close: -1

__tests__/e2e/data-loading/data.test.ts

@@ -52,9 +52,7 @@ describe('static data file support in vite 3', () => {
       await page.waitForFunction(
         () =>
           document.querySelector('pre#basic')?.textContent ===
-          JSON.stringify([{ a: false }, { b: true }], null, 2),
-        undefined,
-        { timeout: 3000 }
+          JSON.stringify([{ a: false }, { b: true }], null, 2)
       )
     } finally {
       await fs.writeFile(a, JSON.stringify({ a: true }, null, 2) + '\n')
@@ -67,9 +65,7 @@ describe('static data file support in vite 3', () => {
       await page.waitForFunction(
         () =>
           document.querySelector('pre#basic')?.textContent ===
-          JSON.stringify([{ a: true }], null, 2),
-        undefined,
-        { timeout: 3000 }
+          JSON.stringify([{ a: true }], null, 2)
       )
       err = false
     } finally {
@@ -83,9 +79,7 @@ describe('static data file support in vite 3', () => {
       await page.waitForFunction(
         () =>
           document.querySelector('pre#basic')?.textContent ===
-          JSON.stringify([{ a: true }, { b: false }], null, 2),
-        undefined,
-        { timeout: 3000 }
+          JSON.stringify([{ a: true }, { b: false }], null, 2)
       )
     } finally {
       await fs.writeFile(b, JSON.stringify({ b: true }, null, 2) + '\n')

docs/config.ts

@@ -42,6 +42,10 @@ function nav(): DefaultTheme.NavItem[] {
     {
       text: pkg.version,
       items: [
+        {
+          text: '1.6.4',
+          link: 'https://vuejs.github.io/vitepress/v1/'
+        },
         {
           text: 'Changelog',
           link: 'https://github.com/vuejs/vitepress/blob/main/CHANGELOG.md'

docs/en/guide/deploy.md

@@ -294,6 +294,10 @@ You can deploy your VitePress website on [Kinsta](https://kinsta.com/static-site
 
 You can deploy your VitePress project to [Stormkit](https://www.stormkit.io) by following these [instructions](https://stormkit.io/blog/how-to-deploy-vitepress).
 
+### CloudRay
+
+You can deploy your VitePress project with [CloudRay](https://cloudray.io/) by following these [instructions](https://cloudray.io/articles/how-to-deploy-vitepress-site).
+
 ### Nginx
 
 Here is a example of an Nginx server block configuration. This setup includes gzip compression for common text-based assets, rules for serving your VitePress site's static files with proper caching headers as well as handling `cleanUrls: true`.

docs/en/guide/markdown.md

@@ -365,7 +365,7 @@ export default {
 
 A [list of valid languages](https://shiki.style/languages) is available on Shiki's repository.
 
-You may also customize syntax highlight theme in app config. Please see [`markdown` options](../reference/site-config#markdown) for more details.
+You may also customize syntax highlight theme, configure language aliases, and set custom language labels in app config. Please see [`markdown` options](../reference/site-config#markdown) for more details.
 
 ## Line Highlighting in Code Blocks
 

docs/en/reference/default-theme-config.md

@@ -89,7 +89,7 @@ type NavItem = NavItemWithLink | NavItemWithChildren
 
 interface NavItemWithLink {
   text: string
-  link: string
+  link: string | ((payload: PageData) => string)
   activeMatch?: string
   target?: string
   rel?: string

docs/en/reference/default-theme-nav.md

@@ -55,7 +55,7 @@ export default {
 
 The `text` will be the text displayed in nav, and the `link` is where the text will send you. Always start links with `/` and omit the `.md` suffix when linking to pages.
 
-Nav links can also be dropdown menus. To do this, set the `items` key on the given link option.
+Nav links can also be dropdown menus. To do this, set the `items` key on the given link option. The `link` can also be a function that accepts [`PageData`](./runtime-api#usedata) as the argument and returns the path. 
 
 ```js
 export default {

docs/es/config.ts

@@ -73,6 +73,10 @@ function nav(): DefaultTheme.NavItem[] {
     {
       text: pkg.version,
       items: [
+        {
+          text: '1.6.4',
+          link: 'https://vuejs.github.io/vitepress/v1/es/'
+        },
         {
           text: 'Registro de cambios',
           link: 'https://github.com/vuejs/vitepress/blob/main/CHANGELOG.md'

docs/es/reference/default-theme-config.md

@@ -89,7 +89,7 @@ type NavItem = NavItemWithLink | NavItemWithChildren
 
 interface NavItemWithLink {
   text: string
-  link: string
+  link: string | ((payload: PageData) => string)
   activeMatch?: string
   target?: string
   rel?: string

docs/es/reference/default-theme-nav.md

@@ -55,6 +55,8 @@ export default {
 
 `text` es el texto que se muestra en la navegación, y el `link` es el link al que será navegando cuando se hace click en el texto. Para el enlace, establezca la ruta al archivo sin el prefijo `.md` y siempre comenzar por `/`.
 
+El `link` también puede ser una función que acepte [`PageData`](./runtime-api#usedata) como argumento y devuelva la ruta.
+
 Links de navegación también pueden ser menus _dropdown_. Para hacer eso, establezca la clave de `items` en la opción del link.
 
 ```js