From df29116c47b3792df5a5dfb518e70cbe5b20e765 Mon Sep 17 00:00:00 2001 From: Xavi Lee Date: Sat, 2 Mar 2024 10:47:00 +0800 Subject: [PATCH] sync with https://github.com/vuejs/vitepress/commit/532389270bbf76859a14a368bd05eeb919729352 --- docs/zh/guide/asset-handling.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/zh/guide/asset-handling.md b/docs/zh/guide/asset-handling.md index fa6478ca..69259a6a 100644 --- a/docs/zh/guide/asset-handling.md +++ b/docs/zh/guide/asset-handling.md @@ -2,7 +2,7 @@ ## 引用静态资源 {#referencing-static-assets} -所有的 Markdown 文件都会被编译成 Vue 组件，并由 [Vite](https://vitejs.dev/guide/assets.html) 处理。可以**并且应该**使用相对路径来引用资源： +所有的 Markdown 文件都会被编译成 Vue 组件，并由 [Vite](https://cn.vitejs.dev/guide/assets.html) 处理。可以**并且应该**使用相对路径来引用资源： ```md ![An image](./image.png) @@ -12,6 +12,10 @@ 常见的图像，媒体和字体文件会被自动检测并视作资源。 +::: tip 通过链接引用的文件不会视作资源 +在 Markdown 内，通过链接引用的 PDF 或者其他文档不会被自动视作资源。要使这些文件可用，你必须手动将其放在项目的 [`public`](#the-public-directory) 目录内。 +::: + 所有引用的资源，包括那些使用绝对路径的，都会在生产构建过程中被复制到输出目录，并使用哈希文件名。从未使用过的资源将不会被复制。小于 4kb 的图像资源将会采用 base64 内联——这可以通过 [`vite`](../reference/site-config#vite) 配置选项进行配置。 所有**静态**路径引用，包括绝对路径，都应基于你的工作目录的结构。