up to 1.0.0-alpha.75

3 years ago · b4f61d4b08
parent 28491dc101
commit b4f61d4b08
3 changed files with 38 additions and 8 deletions
--- a/docs/zh/guide/markdown.md
+++ b/docs/zh/guide/markdown.md
@ -693,7 +693,13 @@ export default config

 ## 包含 markdown 文件 {#markdown-file-inclusion}

-你可以像这样在一个 markdown 文件中包含另一个 markdown 文件：
+你可以在一个 markdown 文件中包含另一个 markdown 文件：
+
+::: tip 提示
+您还可以在 markdown 路径前加上 `@` 前缀，它将充当源根目录。默认情况下它是 VitePress 项目根目录，除非配置了 `srcDir`。
+:::
+
+例如，你可以使用以下方式包含一个相对路径的 markdown 文件：

 **输入**

--- a/docs/zh/reference/default-theme-edit-link.md
+++ b/docs/zh/reference/default-theme-edit-link.md
@ -16,17 +16,17 @@ export default {

 `pattern` 选项定义链接的 URL 结构，并且 `:path` 将被替换为页面路径。

-你还可以放置一个接受“relativePath(相对路径)”作为参数并返回 URL 字符串的纯函数。
+你还可以放置一个接受 [`PageData`](./runtime-api#usedata) 作为参数并返回 URL 字符串的纯函数。

 ```js
 export default {
 	themeConfig: {
 		editLink: {
-			pattern: ({ relativePath }) => {
-				if (relativePath.startsWith('packages/')) {
-					return `https://github.com/acme/monorepo/edit/main/${relativePath}`
+			pattern: ({ filePath }) => {
+				if (filePath.startsWith('packages/')) {
+					return `https://github.com/acme/monorepo/edit/main/${filePath}`
 				} else {
-					return `https://github.com/acme/monorepo/edit/main/docs/${relativePath}`
+					return `https://github.com/acme/monorepo/edit/main/docs/${filePath}`
 				}
 			},
 		},
--- a/docs/zh/reference/site-config.md
+++ b/docs/zh/reference/site-config.md
@ -164,8 +164,32 @@ Additional elements to render in the `<head>` tag in the page HTML. The user-add
 ```ts
 export default {
 	head: [
-		['link', { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }],
-		// would render: <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+		[
+			'link',
+			{ rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' },
+			// would render:
+			//
+			// <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+		],
+
+		[
+			'script',
+			{ id: 'register-sw' },
+			`;(() => {
+        if ('serviceWorker' in navigator) {
+          navigator.serviceWorker.register('/sw.js')
+        }
+      })()`,
+			// would render:
+			//
+			// <script id="register-sw">
+			// ;(() => {
+			//   if ('serviceWorker' in navigator) {
+			//     navigator.serviceWorker.register('/sw.js')
+			//   }
+			// })()
+			// </script>
+		],
 	],
 }
 ```