Merge branch 'vuejs:main' into main

.gitignore

@@ -15,3 +15,4 @@ examples-temp
 node_modules
 pnpm-global
 TODOs.md
+*.timestamp-*.mjs

CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.1.3](https://github.com/vuejs/vitepress/compare/v1.1.1...v1.1.3) (2024-04-18)
+
+### Bug Fixes
+
+- **build/regression:** markdown backslash escapes not working ([d02d1e9](https://github.com/vuejs/vitepress/commit/d02d1e923aacdb1e8061a3f76af30e8a13518277)), closes [#3808](https://github.com/vuejs/vitepress/issues/3808)
+
+## [1.1.1](https://github.com/vuejs/vitepress/compare/v1.1.0...v1.1.1) (2024-04-18)
+
+### Bug Fixes
+
+- **client:** don't reload page on hash change ([#3777](https://github.com/vuejs/vitepress/issues/3777)) ([74b725a](https://github.com/vuejs/vitepress/commit/74b725a224438ef776fed25ee82274429d94ac83))
+- let vue compiler handle entity decoding ([f86ac56](https://github.com/vuejs/vitepress/commit/f86ac56b78da76f3061e6537b897bb13c1ed802d))
+- hot updating config file suppresses error logs ([#3592](https://github.com/vuejs/vitepress/issues/3592)) ([cd5adf3](https://github.com/vuejs/vitepress/commit/cd5adf3011d677263c93ce6f8066aaa7870b1dfc))
+
 # [1.1.0](https://github.com/vuejs/vitepress/compare/v1.0.2...v1.1.0) (2024-04-09)
 
 ### Bug Fixes

docs/ru/guide/deploy.md

@@ -291,3 +291,47 @@ Cache-Control: max-age=31536000,immutable
 ### Stormkit
 
 Вы можете развернуть свой проект VitePress на [Stormkit](https://www.stormkit.io), следуя следующим [инструкциям](https://stormkit.io/blog/how-to-deploy-vitepress).
+
+### Nginx
+
+Вот пример конфигурации блока сервера Nginx. Эта настройка включает сжатие gzip для общих текстовых ресурсов, правила обслуживания статических файлов вашего сайта VitePress с правильными заголовками кэширования и обработку параметра `cleanUrls: true`.
+
+```nginx
+server {
+    gzip on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+
+    listen 80;
+    server_name _;
+    index index.html;
+
+    location / {
+        # расположение контента
+        root /app;
+
+        # точные совпадения -> обратные чистые URL-адреса -> папки -> не найдены
+        try_files $uri $uri.html $uri/ =404;
+
+        # несуществующие страницы
+        error_page 404 /404.html;
+
+        # папка без index.html вызывает ошибку 403 в этой настройке
+        error_page 403 /404.html;
+
+        # настройка заголовков кэширования
+        # файлы в папке с ресурсами имеют хэши имён файлов
+        location ~* ^/assets/ {
+            expires 1y;
+            add_header Cache-Control "public, immutable";
+        }
+    }
+}
+```
+
+Эта конфигурация предполагает, что ваш собранный сайт VitePress находится в директории `/app`. При необходимости измените директиву `root`, если файлы вашего сайта расположены в другом месте.
+
+::: warning Не используйте index.html по умолчанию
+Разрешение try_files не должно использовать index.html, как это делается в других приложениях Vue. Это может привести к недопустимому состоянию страницы.
+:::
+
+Дополнительную информацию можно найти в официальной документации [Nginx](https://nginx.org/ru/docs/), а также в следующих обсуждениях: [#2837](https://github.com/vuejs/vitepress/discussions/2837), [#3235](https://github.com/vuejs/vitepress/issues/3235), а также в [блоге Mehdi Merah](https://blog.mehdi.cc/articles/vitepress-cleanurls-on-nginx-environment#readings).

docs/zh/guide/markdown.md

@@ -44,7 +44,7 @@ VitePress 带有内置的 Markdown 扩展。
 ```md
 [Home](/) <!-- 将用户导航至根目录下的 index.html -->
 [foo](/foo/) <!-- 将用户导航至目录 foo 下的 index.html -->
-[foo heading](./#heading) <!-- 将用户锚定到 foo 索引文件中的一个标题上 -->
+[foo heading](./#heading) <!-- 将用户锚定到目录 foo 下的index文件中的一个标题上 -->
 [bar - three](../bar/three) <!-- 可以省略扩展名 -->
 [bar - three](../bar/three.md) <!-- 可以添加 .md -->
 [bar - four](../bar/four.html) <!-- 或者可以添加 .html -->

package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitepress",
-  "version": "1.1.0",
+  "version": "1.1.3",
   "description": "Vite & Vue powered static site generator",
   "keywords": [
     "vite",
@@ -108,15 +108,15 @@
     "@shikijs/transformers": "^1.3.0",
     "@types/markdown-it": "^14.0.1",
     "@vitejs/plugin-vue": "^5.0.4",
-    "@vue/devtools-api": "^7.0.25",
+    "@vue/devtools-api": "^7.0.27",
     "@vueuse/core": "^10.9.0",
     "@vueuse/integrations": "^10.9.0",
     "focus-trap": "^7.5.4",
     "mark.js": "8.11.1",
     "minisearch": "^6.3.0",
     "shiki": "^1.3.0",
-    "vite": "^5.2.8",
-    "vue": "^3.4.22"
+    "vite": "^5.2.9",
+    "vue": "^3.4.23"
   },
   "devDependencies": {
     "@clack/prompts": "^0.7.0",
@@ -147,7 +147,7 @@
     "@types/node": "^20.12.7",
     "@types/postcss-prefix-selector": "^1.16.3",
     "@types/prompts": "^2.4.9",
-    "@vue/shared": "^3.4.22",
+    "@vue/shared": "^3.4.23",
     "chokidar": "^3.6.0",
     "conventional-changelog-cli": "^4.1.0",
     "cross-spawn": "^7.0.3",
@@ -210,7 +210,7 @@
       "optional": true
     }
   },
-  "packageManager": "pnpm@8.15.7",
+  "packageManager": "pnpm@9.0.2",
   "pnpm": {
     "peerDependencyRules": {
       "ignoreMissing": [

src/client/theme-default/components/VPNavBarSearchButton.vue

@@ -71,6 +71,11 @@ const translate = createSearchTranslate(defaultTranslations)
   outline: 5px auto -webkit-focus-ring-color;
 }
 
+.DocSearch-Button-Key--pressed {
+  transform: none;
+  box-shadow: none;
+}
+
 .DocSearch-Button:focus:not(:focus-visible) {
   outline: none !important;
 }

src/node/markdown/markdown.ts

@@ -14,8 +14,8 @@ import { sfcPlugin, type SfcPluginOptions } from '@mdit-vue/plugin-sfc'
 import { titlePlugin } from '@mdit-vue/plugin-title'
 import { tocPlugin, type TocPluginOptions } from '@mdit-vue/plugin-toc'
 import { slugify } from '@mdit-vue/shared'
-import MarkdownIt from 'markdown-it'
 import type { Options } from 'markdown-it'
+import MarkdownIt from 'markdown-it'
 import anchorPlugin from 'markdown-it-anchor'
 import attrsPlugin from 'markdown-it-attrs'
 // @ts-expect-error: types of markdown-it-emoji are not up-to-date
@@ -29,14 +29,15 @@ import type {
 } from 'shiki'
 import type { Logger } from 'vite'
 import { containerPlugin, type ContainerOptions } from './plugins/containers'
+import { gitHubAlertsPlugin } from './plugins/githubAlerts'
 import { highlight } from './plugins/highlight'
 import { highlightLinePlugin } from './plugins/highlightLines'
 import { imagePlugin, type Options as ImageOptions } from './plugins/image'
 import { lineNumberPlugin } from './plugins/lineNumbers'
 import { linkPlugin } from './plugins/link'
 import { preWrapperPlugin } from './plugins/preWrapper'
+import { restoreEntities } from './plugins/restoreEntities'
 import { snippetPlugin } from './plugins/snippet'
-import { gitHubAlertsPlugin } from './plugins/githubAlerts'
 
 export type { Header } from '../shared'
 
@@ -205,6 +206,7 @@ export const createMarkdownRenderer = async (
   })
 
   md.linkify.set({ fuzzyLink: false })
+  md.use(restoreEntities)
 
   if (options.preConfig) {
     options.preConfig(md)

src/node/markdown/plugins/restoreEntities.ts

@@ -0,0 +1,11 @@
+import type MarkdownIt from 'markdown-it'
+
+export function restoreEntities(md: MarkdownIt): void {
+  md.core.ruler.disable('text_join')
+  md.renderer.rules.text_special = (tokens, idx) => {
+    if (tokens[idx].info === 'entity') {
+      return tokens[idx].markup // leave as is so Vue can handle it
+    }
+    return md.utils.escapeHtml(tokens[idx].content)
+  }
+}