[docs] Chinese translation #1274

Jinjiang · 2018-04-29T17:11:47Z

~~WIP (3 pages left).~~
~~Will be finished this week.~~
Finished. /ping @Justineo
Thanks.

yyx990803 · 2018-05-04T19:36:15Z

docs/zh/guide/asset-url.md

@@ -0,0 +1,51 @@
+# 处理资产路径


我觉得还是用 “资源” 比较好，static assets -> 静态资源

yyx990803 · 2018-05-04T19:37:10Z

docs/zh/guide/linting.md

@@ -0,0 +1,45 @@
+# 校验


我觉得加上英文 Linting 比较好，不然一眼都不知道是讲什么的...

yyx990803 · 2018-05-04T19:37:29Z

docs/zh/guide/scoped-css.md

@@ -0,0 +1,75 @@
+# 有作用域的 CSS


这个就直接 Scoped CSS 吧...

yyx990803 · 2018-05-04T19:38:04Z

docs/zh/migrating.md

+}
+```
+
+## 服务端渲染的外置


外置 -> 依赖排除

ulivz

Only some small things.

ulivz · 2018-05-04T05:15:54Z

docs/zh/README.md

+
+:::tip 版本注明
+这份文档是为 Vue Loader v15 及以上版本撰写的。如果你正在从 v14 或更早的版本往这里迁移，请查阅[迁移指南](../migrating.md)。如果你正在使用老版本，其对应的就文档[在此](https://vue-loader-v14.vuejs.org)。
+:::


其对应的文档在此

这个应该是「旧」误写成了「就」吧

我也发现了，因为上一句已经说过了“老”，所以这里可以不用再重复一次。

认同，我去掉了

ulivz · 2018-05-05T04:46:50Z

docs/zh/guide/asset-url.md

@@ -0,0 +1,51 @@
+# 处理资产路径
+
+当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资产 URL URL 转换为 **webpack 模块请求**。


这里的URL重复了

ulivz · 2018-05-05T17:21:06Z

docs/zh/guide/asset-url.md

@@ -0,0 +1,51 @@
+# 处理资源路径
+
+当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资源 URL URL 转换为 **webpack 模块请求**。


重复的 URL

ulivz · 2018-05-05T17:21:18Z

docs/zh/guide/asset-url.md

+
+当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资源 URL URL 转换为 **webpack 模块请求**。
+
+例如，下面的模板代码片段


例如，下面的模板代码片段：（少了一个冒号）

我确认了一下，英文版本身没有冒号。我两边都加一下好了

ulivz · 2018-05-05T17:22:28Z

docs/zh/guide/asset-url.md

+## 相关的 Loader
+
+因为像 `.png` 这样的文件不是一个 JavaScript 模块，你需要配置 webpack 使用 [file-loader](https://github.com/webpack/file-loader) 或者 [url-loader](https://github.com/webpack/url-loader) 去合理的处理它们。通过 Vue CLI 创建的项目已经把这些预配置好了。
+


合理地处理它们（的 => 地）

ulivz · 2018-05-05T17:55:20Z

docs/zh/guide/pre-processors.md

+}
+```
+
+额外的如果想 `import 'style.scss'`，我们也可以在 Vue 组件中使用 SCSS：


现在，除了能够 import 'style.scss' 之外，我们还可以在 VUE 组件中使用 SCSS：

ulivz · 2018-05-05T18:03:19Z

docs/zh/migrating.md

+
+拿 `<style lang="less">` 举例：在 v14 或更低版本中，它会尝试使用 `less-loader` 加载这个块，并在其后面隐式地链上 `css-loader` 和 `vue-style-loader`，这一切都使用内联的 loader 字符串。
+
+这 v15 中，`<style lang="less">` 会完成把它当作一个真实的 `*.less` 文件来加载。因此，为了这样处理它，你需要在你的主 webpack 配置中显式地提供一条规则：


这 v15 中 => 在 v15 中，

ulivz · 2018-05-05T18:06:25Z

docs/zh/migrating.md

+
+下列选项已经被改名了：
+
+- `transformToRequire` (现象改名为 `transformAssetUrls`)


现象改名为 => 现在改名为

ulivz · 2018-05-05T18:08:56Z

docs/zh/options.md

+- 默认值：当 webpack 配置中包含 `target: 'node'` 且 `vue-template-compiler` 版本号大于等于 2.4.0 时为 `true`。
+
+  开启 Vue 2.4 服务端渲染的编译优化之后，渲染函数将会把返回的 vdom 树的一部分编译为字符串，以提升服务端渲染的性能。在一些情况下，你可能想要明确的将其关掉，因为该渲染函数只能用于服务端渲染，而不能用于客户端渲染或测试环境。
+


明确的 => 明确地

ulivz · 2018-05-05T18:12:39Z

docs/zh/spec.md

+- [Emacs](https://github.com/AdamNiederer/vue-mode)
+- [Brackets](https://github.com/pandao/brackets-vue)
+- [JetBrains IDEs](https://plugins.jetbrains.com/plugin/8057) (WebStorm, PhpStorm, etc)
+


WebStorm, PhpStorm, etc => WebStorm, PhpStorm 等

Jinjiang · 2018-05-09T02:05:18Z

Guys, is it approvable now? 🙂

Justineo · 2018-05-09T02:45:30Z

docs/.vuepress/config.js

+    '/': {
+      lang: 'en-US',
+      title: 'Vue Loader',
+      description: 'Webpack loader for single-file Vue components'


Webpack → webpack 要统一处理一下么？

和 Chris 讨论过这个问题了 vuejs/v2.vuejs.org#1568
中文翻译的部分我们可以保留 webpack，其余的以英文版为准吧
或者中文翻译也用回 Webpack 我的角度都可以接受

其实不光 webpack，还有 npm 也是小写的。在中文里其实没啥歧义，那我们就在中文版里面保留最精确的拼法吧。

Justineo · 2018-05-10T02:50:39Z

docs/zh/README.md

@@ -0,0 +1,41 @@
+# 介绍
+
+:::tip 版本注明


版本说明？

Justineo · 2018-05-10T02:52:40Z

docs/zh/README.md

+
+## Vue Loader 是什么？
+
+Vue Loader 是一个 [webpack](https://webpack.js.org/) 的 loader，它允许你以一种名为[单文件组件 (SFCs)](./spec.md)的格式撰写 Vue 组件：


「撰写」一般指的是文档吧？这里建议用「编写」

“撰写”相对书面一些，我已经在很多地方使用了撰写这个词 (loader 的文档中搜到了 7 次，其它文档可能更多)。如果不是特别必要的话，我就保留“撰写”了😅

Justineo · 2018-05-10T02:54:01Z

docs/zh/README.md

+- 允许在一个 `.vue` 文件中使用自定义块，并对其运用自定义的 loader 链；
+- 使用 webpack loader 将 `<style>` 和 `<template>` 中引用的资源当作模块依赖来处理；
+- 为每个组件模拟出 scoped CSS；
+- 在开发过程中可以保持状态的热重载。


在开发过程中使用热重载来保持状态。

Justineo · 2018-05-10T02:54:15Z

docs/zh/README.md

+- 为每个组件模拟出 scoped CSS；
+- 在开发过程中可以保持状态的热重载。
+
+简而言之，webpack 和 Vue Loader 的结合为你提供了一个撰写 Vue.js 应用的、现代的、灵活的和极致强大的前端工作流。


编写/开发

提供了一个现代、灵活且极其强大的前端工作流，来帮助编写 Vue.js 应用。

Justineo · 2018-05-10T06:34:05Z

docs/zh/migrating.md

+
+### PostCSS
+
+Vue Loader v15 不再默认应用 PostCSS 变换。想要使用 PostCSS，请像为普通 CSS 文件一样的方式配置 `postcss-loader`。


请像配置普通 CSS 文件那样配置 postcss-loader

Justineo · 2018-05-10T06:36:28Z

docs/zh/options.md

+- 类型：`Object`
+- 默认值：`{}`
+
+  为渲染函数的生成码配置从 ES2015+ 到 ES5 的转译选项。这里的[转译器](https://github.com/vuejs/vue-template-es2015-compiler)是一份 [Buble](https://github.com/Rich-Harris/buble) 的 fork，因此你可以在[这里](https://buble.surge.sh/guide/#using-the-javascript-api)咨询可用的选项。


生成码 → 生成代码？

咨询 → 查阅

generated code -> 生成码
source code -> 源代码
同撰写，也已经用在很多地方了，如果不是特别必要的话我倾向于保留

Justineo · 2018-05-10T06:37:23Z

docs/zh/options.md

+
+  为渲染函数的生成码配置从 ES2015+ 到 ES5 的转译选项。这里的[转译器](https://github.com/vuejs/vue-template-es2015-compiler)是一份 [Buble](https://github.com/Rich-Harris/buble) 的 fork，因此你可以在[这里](https://buble.surge.sh/guide/#using-the-javascript-api)咨询可用的选项。
+
+  模板渲染函数编译支持一个特殊的变换 `stripWith` (默认启用)，它删除生成的渲染函数中的 `with` 用法，使它们兼容严格模式。


它会删除？

Justineo · 2018-05-10T06:40:21Z

docs/zh/spec.md

+
+### Src 导入
+
+如果你喜欢分隔你的 `.vue` 文件到多个文件中，你可以通过 `src` 属性导入外部文件：


喜欢把 .vue 文件分隔到多个文件中

Justineo · 2018-05-10T06:41:11Z

docs/zh/spec.md

+
+## 注释
+
+在语言块中使用该语言块对应的注释语法 (HTML、CSS、JavaScript、Jade 等)。顶层注释使用 HTML 注释语法：`<!-- comment contents here -->`


最后应该有个 。

Justineo · 2018-05-15T04:19:57Z

@yyx990803 Approve 一下吧，不然 merge 不了。

Justineo · 2018-05-15T13:58:22Z

原来是因为我没 write access 才不能合 - -，你们合吧 @Jinjiang

yyx990803 · 2018-05-15T14:40:15Z

@Justineo 现在应该有了

Jinjiang added 18 commits April 27, 2018 12:58

[docs][zh] init

ca77b66

[docs][zh] updated config

b6a067c

[docs][zh] translated README.md

14f1336

[docs][zh] translated spec.md

6dcaf02

[docs][zh] translated options.md

e2c5a5d

[docs][zh] translated asset-url.md

8b1cc80

[docs][zh] translated css-modules.md

1f5eef9

[docs][zh] translated custom-blocks.md

150ee0a

[docs][zh] translated extract-cs.md

db78dbe

[docs][zh] translated functional.md

7ab0b4d

[docs][zh] translated hot-reload.md

a8ae03e

[docs][zh] translated linting.md

ecbd57e

[docs][zh] translated scoped-css.md

53174de

[docs][zh] translated testing.md

1d54dda

[docs][zh] translated pre-processors.md

3905ea2

[docs][zh] translated guide/README.md

887a205

[docs][zh] translated migrating.md

5d20ead

Update spec.md

10f9ef2

yyx990803 requested changes May 4, 2018

View reviewed changes

Jinjiang added 2 commits May 5, 2018 15:20

[docs][zh] fixed scoped & assets

8c4daf7

[docs][zh] small tweaks

234c3b0

ulivz reviewed May 5, 2018

View reviewed changes

[docs][zh] small tweaks

bf32823

Jinjiang mentioned this pull request May 6, 2018

[docs][zh-cn][v14] small tweaks #1288

Merged

Update spec.md

1544a66

Justineo reviewed May 10, 2018

View reviewed changes

Jinjiang added 3 commits May 11, 2018 21:26

[docs][zh] update

40d7e2f

[docs][zh] update

bc30c08

Update linting.md

b556598

yyx990803 approved these changes May 15, 2018

View reviewed changes

Justineo merged commit 698a79d into vuejs:master May 15, 2018

Jinjiang deleted the zh-cn branch May 15, 2018 15:07

		@@ -0,0 +1,51 @@
		# 处理资产路径

		当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资产 URL URL 转换为 webpack 模块请求。

		@@ -0,0 +1,51 @@
		# 处理资源路径

		当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资源 URL URL 转换为 webpack 模块请求。


		当 Vue Loader 编译单文件组件中的 `<template>` 块时，它也会将所有遇到的资源 URL URL 转换为 webpack 模块请求。

		例如，下面的模板代码片段

		## 相关的 Loader

		因为像 `.png` 这样的文件不是一个 JavaScript 模块，你需要配置 webpack 使用 [file-loader](https://github.com/webpack/file-loader) 或者 [url-loader](https://github.com/webpack/url-loader) 去合理的处理它们。通过 Vue CLI 创建的项目已经把这些预配置好了。


		拿 `<style lang="less">` 举例：在 v14 或更低版本中，它会尝试使用 `less-loader` 加载这个块，并在其后面隐式地链上 `css-loader` 和 `vue-style-loader`，这一切都使用内联的 loader 字符串。

		这 v15 中，`<style lang="less">` 会完成把它当作一个真实的 `*.less` 文件来加载。因此，为了这样处理它，你需要在你的主 webpack 配置中显式地提供一条规则：


		下列选项已经被改名了：

		- `transformToRequire` (现象改名为 `transformAssetUrls`)

		- 默认值：当 webpack 配置中包含 `target: 'node'` 且 `vue-template-compiler` 版本号大于等于 2.4.0 时为 `true`。

		开启 Vue 2.4 服务端渲染的编译优化之后，渲染函数将会把返回的 vdom 树的一部分编译为字符串，以提升服务端渲染的性能。在一些情况下，你可能想要明确的将其关掉，因为该渲染函数只能用于服务端渲染，而不能用于客户端渲染或测试环境。


		## Vue Loader 是什么？

		Vue Loader 是一个 [webpack](https://webpack.js.org/) 的 loader，它允许你以一种名为[单文件组件 (SFCs)](./spec.md)的格式撰写 Vue 组件：


		### PostCSS

		Vue Loader v15 不再默认应用 PostCSS 变换。想要使用 PostCSS，请像为普通 CSS 文件一样的方式配置 `postcss-loader`。


		为渲染函数的生成码配置从 ES2015+ 到 ES5 的转译选项。这里的[转译器](https://github.com/vuejs/vue-template-es2015-compiler)是一份 [Buble](https://github.com/Rich-Harris/buble) 的 fork，因此你可以在[这里](https://buble.surge.sh/guide/#using-the-javascript-api)咨询可用的选项。

		模板渲染函数编译支持一个特殊的变换 `stripWith` (默认启用)，它删除生成的渲染函数中的 `with` 用法，使它们兼容严格模式。


		### Src 导入

		如果你喜欢分隔你的 `.vue` 文件到多个文件中，你可以通过 `src` 属性导入外部文件：


		## 注释

		在语言块中使用该语言块对应的注释语法 (HTML、CSS、JavaScript、Jade 等)。顶层注释使用 HTML 注释语法：`<!-- comment contents here -->`

[docs] Chinese translation #1274

[docs] Chinese translation #1274

Uh oh!

Conversation

Jinjiang commented Apr 29, 2018 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ulivz left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Jinjiang commented May 9, 2018

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Jinjiang commented Apr 29, 2018 •

edited

Loading