Skip to content

Commit 8b1cc80

Browse files
committed
[docs][zh] translated asset-url.md
1 parent e2c5a5d commit 8b1cc80

File tree

4 files changed

+22
-22
lines changed

4 files changed

+22
-22
lines changed

docs/zh/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Vue Loader 还提供了很多酷炫的特性:
3434

3535
- 允许为 Vue 组件的每个部分使用其它的 webpack loader,例如在 `<style>` 的部分使用 Sass 和在 `<template>` 的部分使用 Pug;
3636
- 允许在一个 `.vue` 文件中使用自定义块,并对其运用自定义的 loader 链;
37-
- 使用 webpack loader 将 `<style>``<template>` 中引用的资源当作模块依赖来处理
37+
- 使用 webpack loader 将 `<style>``<template>` 中引用的资产当作模块依赖来处理
3838
- 为每个组件模拟出带作用域的 CSS;
3939
- 在开发过程中可以保持状态的热重载。
4040

docs/zh/guide/asset-url.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,51 @@
1-
# Asset URL Handling
1+
# 处理资产路径
22

3-
When Vue Loader compiles the `<template>` blocks in SFCs, it also converts any encountered asset URLs into **webpack module requests**.
3+
Vue Loader 编译单文件组件中的 `<template>` 块时,它也会将所有遇到的资产 URL URL 转换为 **webpack 模块请求**
44

5-
For example, the following template snippet
5+
例如,下面的模板代码片段
66

77
``` vue
88
<img src="../image.png">
99
```
1010

11-
will be compiled into:
11+
将会被编译成为:
1212

1313
``` js
1414
createElement('img', {
1515
attrs: {
16-
src: require('../image.png') // this is now a module request
16+
src: require('../image.png') // 现在这不是一个模块请求
1717
}
1818
})
1919
```
2020

21-
By default the following tag/attribute combinations are transformed, and can be configured using the [transformAssetUrls](../options.md#transformasseturls) option.
21+
默认下列标签/特性的组合会被转换,且这些组合时可以使用 [transformAssetUrls](../options.md#transformasseturls) 选项进行配置的。
2222

23-
In addition, if you have configured to use [css-loader](https://github.com/webpack-contrib/css-loader) for the `<style>` blocks, asset URLs in your CSS will also be processed in a similar fashion.
23+
额外的,如果你配置了为 `<style>` 块使用 [css-loader](https://github.com/webpack-contrib/css-loader),则你的 CSS 中的资产 URL 也会被同等处理。
2424

25-
## Transform Rules
25+
## 转换规则
2626

27-
Asset URL transforms adhere to the following rules:
27+
资产 URL 转换会遵循如下规则:
2828

29-
- If the URL is an absolute path (e.g. `/images/foo.png`), it will be preserved as-is.
29+
- 如果路径是绝对路径 (例如 `/images/foo.png`),会原样保留。
3030

31-
- If the URL starts with `.`, it's interpreted as a relative module request and resolved based on the folder structure on your file system.
31+
- 如果路径以 `.` 开头,将会被看作相对的模块依赖,并按照你的本地文件系统上的目录结构进行解析。
3232

33-
- If the URL starts with `~`, anything after it is interpreted as a module request. This means you can even reference assets inside node modules:
33+
- 如果路径以 `~` 开头,其后的部分将会被看作模块依赖。这意味着你可以用该特性来引用一个 node 依赖中的资源:
3434

3535
``` html
3636
<img src="~some-npm-package/foo.png">
3737
```
3838

39-
- If the URL starts with `@`, it's also interpreted as a module request. This is useful if your webpack config has an alias for `@`, which by default points to `/src` in any project created by `vue-cli`.
39+
- 如果路径以 `@` 开头,也会被看作模块依赖。如果你的 webpack 配置中给 `@` 配置了 alias,这就很有用了。所有 `vue-cli` 创建的项目都默认配置了将 `@` 指向 `/src`
4040

41-
## Related Loaders
41+
## 相关的 Loader
4242

43-
Because extensions like `.png` are not JavaScript modules, you will need to configure webpack to use [file-loader](https://github.com/webpack/file-loader) or [url-loader](https://github.com/webpack/url-loader) to properly handle them. Projects created with Vue CLI has this pre-configured.
43+
因为像 `.png` 这样的文件不是一个 JavaScript 模块,你需要配置 webpack 使用 [file-loader](https://github.com/webpack/file-loader) 或者 [url-loader](https://github.com/webpack/url-loader) 去合理的处理它们。通过 Vue CLI 创建的项目已经把这些预配置好了。
4444

45-
## Why
45+
## 为什么
4646

47-
The benefits of asset URL transforms are:
47+
转换资产 URL 的好处是:
4848

49-
1. `file-loader` allows you to designate where to copy and place the asset file, and how to name it using version hashes for better caching. Moreover, this also means **you can just place images next to your `*.vue` files and use relative paths based on the folder structure instead of worrying about deployment URLs**. With proper config, webpack will auto-rewrite the file paths into correct URLs in the bundled output.
49+
1. `file-loader` 可以指定要复制和放置资源文件的位置,以及如何使用版本哈希命名以获得更好的缓存。此外,这意味着 **你可以就近管理图片文件,可以使用相对路径而不用担心布署时URL问题**。使用正确的配置,webpack 将会在打包输出中自动重写文件路径为正确的URL。
5050

51-
2. `url-loader` allows you to conditionally inline a file as base-64 data URL if they are smaller than a given threshold. This can reduce the amount of HTTP requests for trivial files. If the file is larger than the threshold, it automatically falls back to `file-loader`.
51+
2. `url-loader` 允许你有条件将文件转换为内联的 base-64 URL (当文件小于给定的阈值),这会减少小文件的 HTTP 请求。如果文件大于该阈值,会自动的交给 `file-loader` 处理。

docs/zh/options.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ sidebar: auto
1818
}
1919
```
2020

21-
在模板编译过程中,编译器可以将某些特性转换为 `require` 调用,例如 `src` 中的 URL。因此这些目标资源可以被 webpack 处理。例如 `<img src="./foo.png">` 会找到你文件系统中的 `./foo.png` 并将其作为一个依赖包含在你的包里。
21+
在模板编译过程中,编译器可以将某些特性转换为 `require` 调用,例如 `src` 中的 URL。因此这些目标资产可以被 webpack 处理。例如 `<img src="./foo.png">` 会找到你文件系统中的 `./foo.png` 并将其作为一个依赖包含在你的包里。
2222

2323
## compiler
2424

docs/zh/spec.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ export default {
9494
需要注意的是 `src` 导入遵循和 webpack 模块请求相同的路径解析规则,这意味着:
9595

9696
- 相对路径需要以 `./` 开始
97-
- 你可以从 NPM 依赖中导入资源
97+
- 你可以从 NPM 依赖中导入资产
9898

9999
``` vue
100100
<!-- import a file from the installed "todomvc-app-css" npm package -->

0 commit comments

Comments
 (0)