Final Review (Guide) #487

yyx990803 · 2022-08-05T13:47:52Z

调整一些明显的理解错误
一些地方严格按照英文语序会非常拗口，我会在维持原意的前提下调整到符合中文的语序习惯。
给首次出现的重要概念加上英文备注
在校对过程中对一些段落做了影响原意的改动或是添加 - 这些已经在英文原版中同步。
一些出现多次的用语改动：
- property: 之前统一不翻译，改为
  - 指代 JavaScript 对象或是组件实例上的 property 时，翻译为”属性“
  - 指代 DOM property，强调和 attribute 的区分时，不翻译
- render: 很多地方被翻译为“呈现”，统一翻译为“渲染”
- props: 很多地方用了单数，改为除非语境下特指单一的 prop，否则统一用复数 props。
- mixin：统一不翻译
- 举个例子: 太过口语化，统一改为“举例来说”
- slot outlet: 原译为“插口”，统一改为“出口”
- 可重用：统一改为“可复用”

netlify · 2022-08-05T13:47:56Z

✅ Deploy Preview for vue-docs-zh-cn ready!

Name	Link
🔨 Latest commit	`669ce14`
🔍 Latest deploy log	https://app.netlify.com/sites/vue-docs-zh-cn/deploys/62ed259ceb1fea0009dde7f1
😎 Deploy Preview	https://deploy-preview-487--vue-docs-zh-cn.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

Jinjiang · 2022-08-05T18:20:05Z

src/api/reactivity-advanced.md

@@ -181,7 +181,7 @@

 - **详细信息**

-  和 `readonly()` 不同，这里没有深层级的转换：只有根层级的 property 变为了只读。property 的值都会被原样存储和暴露，这也意味着值为 ref 的 property **不会**被自动解包了。
+  和 `readonly()` 不同，这里没有深层级的转换：只有根层级的属性变为了只读。属性的值都会被原样存储和暴露，这也意味着值为 ref 的属性 **不会**被自动解包了。


这里 属性 **不会**被自动 不需要空格了

Jinjiang · 2022-08-05T18:23:05Z

src/guide/best-practices/production-deployment.md


 ## 使用构建工具 {#with-build-tools}

-通过 `create-vue` 搭建的项目（基于 Vite）或者 Vue CLI（基于 webpack）都会为生产环境发布作预配置。
+通过 `create-vue`（基于 Vite）或是 Vue CLI（基于 webpack）搭建的项目都已经预先做好了针对生产环境的配置。


这里的括号应该是半角的，且外侧有空格

Jinjiang · 2022-08-05T18:23:30Z

src/guide/best-practices/production-deployment.md

@@ -18,16 +18,16 @@
 - 如果需要使用全局变量版本（通过 `Vue` 全局变量访问）：请使用 `vue.global.prod.js`。


这里的括号应该是半角的，且外侧有空格 (顺便发现的)

Jinjiang · 2022-08-05T18:26:06Z

src/guide/built-ins/transition.md

@@ -499,7 +499,7 @@ export default {

 ## 出现时过渡 {#transition-on-appear}

-如果你想在某个节点初次渲染时应用一个过渡效果，你可以添加 `appear` attribute：
+如果你想在某个节点初次渲染时应用一个过渡效果，你可以添加 `appear` prop:


结尾的冒号应该是全角的

Jinjiang · 2022-08-05T18:30:57Z

src/guide/essentials/lifecycle.md

@@ -31,7 +31,7 @@ export default {

 </div>

-还有其他一些钩子，会在实例生命周期的不同阶段被调用，最常用的是 <span class="composition-api">[`onMounted`](/api/composition-api-lifecycle.html#onmounted)，[`onUpdated`](/api/composition-api-lifecycle.html#onupdated) 和 [`onUnmounted`](/api/composition-api-lifecycle.html#onunmounted)。所有生命周期钩子的完整参考及其用法可以在[这里](/api/composition-api-lifecycle.html)看到。</span><span class="options-api">[`mounted`](/api/options-lifecycle.html#mounted)，[`updated`](/api/options-lifecycle.html#updated) 和 [`unmounted`](/api/options-lifecycle.html#unmounted)。</span>
+还有其他一些钩子，会在实例生命周期的不同阶段被调用，最常用的是 <span class="composition-api">[`onMounted`](/api/composition-api-lifecycle.html#onmounted)，[`onUpdated`](/api/composition-api-lifecycle.html#onupdated) 和 [`onUnmounted`](/api/composition-api-lifecycle.html#onunmounted)。所有生命周期钩子的完整参考及其用法请参考[API 索引](/api/composition-api-lifecycle.html)。</span><span class="options-api">[`mounted`](/api/options-lifecycle.html#mounted)，[`updated`](/api/options-lifecycle.html#updated) 和 [`unmounted`](/api/options-lifecycle.html#unmounted)。</span>


请参考[API 索引](...) 链接之前需要一个空格

Jinjiang · 2022-08-05T18:35:57Z

src/guide/scaling-up/routing.md

+
+然而，在[单页面应用](https://developer.mozilla.org/en-US/docs/Glossary/SPA)中，客户端的 JavaScript 可以拦截页面的跳转请求，动态获取新的数据，然后在无需重新加载的情况下更新当前页面。这样通常可以带来更顺滑的用户体验，尤其是在更偏向“应用”的场景下，因为这类场景下用户通常会在很长的一段时间中做出多次交互。
+
+在这类单页应用中，“路由”是在客户端执行的。一个客户端路由器的职责就是利用诸如 [History API](https://developer.mozilla.org/en-US/docs/Web/API/History) 或是 [`hashchange` 事件](https://developer.mozilla.org/en-US/docs/Web/API/Window/hashchange_event) 这样的浏览器 API 来管理应用当前应该渲染的视图。


事件 之后不需要空格

src/guide/typescript/overview.md

Jinjiang · 2022-08-05T18:51:14Z

src/guide/typescript/composition-api.md

@@ -357,4 +357,4 @@ const openModal = () => {
 </script>
 ```

-注意，如果你想在 TypeScript 文件而不是在 Vue SFC 中使用这种技巧，需要开启 Volar 的[托管模式](./overview.html#takeover-mode)。
+注意，如果你想在 TypeScript 文件而不是在 Vue SFC 中使用这种技巧，需要开启 Volar 的[Takeover 模式](./overview.html#takeover-mode)。


同问 takeover 的翻译问题，另外前面少了一个空格

xfq · 2022-08-06T01:39:21Z

src/about/faq.md


- [单文件组件](/guide/scaling-up/sfc)提供了一个模块化的开发模型，允许应用程序的不同部分被隔离开发。
+- [单文件组件](/guide/scaling-up/sfc)提供了一个模块化的开发模型，让应用程序的不同部分能够被隔离开发。


这里的「应用程序」是否应该根据中文术语约定简写为「应用」呢？

欢迎 PR 贡献

xfq · 2022-08-06T01:58:14Z

src/guide/built-ins/transition.md


 除了这两个组件，我们也可以通过其他技术手段来应用动画，比如切换 CSS class 或用状态绑定样式来驱动动画。这些其他的方法会在[动画技巧](/guide/extras/animation.html)章节中展开。

 ## `<Transition>` 组件 {#the-transition-component}

 `<Transition>` 是一个内置组件，这意味着它在任意别的组件中都可以被使用，无需注册。它可以将进入和离开动画应用到通过默认插槽传递给它的元素或组件上。进入或离开可以由以下的条件之一触发：

- 由 `v-if` 所带来的条件渲染
- 由 `v-show` 所带来的条件显示
+- 由 `v-if` 所触发的却换


这里应为「切换」？

欢迎 PR 贡献

yyx990803 added 30 commits August 5, 2022 21:44

review: home & intro

5d0e263

review: application, template syntax

d8e4450

property -> 属性

06d6f81

review: reactivity

721e72d

review: faq

859b9fe

review: computed

5b77463

review: class and style

07361db

review: conditional rendering

2b4d157

review: list rendering

08e83ce

review: event handling

fa43854

reivew: form bindings

16caf85

review: lifecycle

c491225

review: watchers

b8fe5b4

review: template refs

d897a7b

review: component basics

e733094

review: component registration

5ef3275

review: component props

ca7513a

review: component events

739e607

review: fallthrough attributes

c30e5c2

举个例子 -> 举例来说

bc0a4fd

review: component slots

36832db

review: provide/inject

331457c

review: async components

f08ff8c

review: menu text

36dda18

review: composables

f753143

review: custom directives

060ee7f

review: plugins

3f91928

undo translation of code sample

a9cfd4a

review: built-in components

2f7063c

review: sfc

52bd41e

yyx990803 added 18 commits August 5, 2022 21:47

review: routing

91c0a48

review: state management

5302701

review: testing

797cfec

review: ssr

cfcf7bd

review: production deployment

20889c4

review: performance

9341516

review: security

7a1ad0e

review: typescript

fd68acf

review: ways of using vue

16db58e

review: add english equivalents to important concepts

9b60cec

expand ssr hydration mismatch section

f5a80d8

review: composition api faq

8cf839f

review: reactivity in depth

8da7fec

review: rendering mechanism

7d5fd40

review: render function

59ea13d

review: web components

22c2901

review: animation

09caf5f

review: reactivity transform

f474578

yyx990803 added 4 commits August 5, 2022 21:56

resolve conflict

0eb78a2

small tweak

1f255f9

review: faq

1659984

review: releases

669ce14

yyx990803 merged commit 0a3e8c3 into main Aug 5, 2022

yyx990803 deleted the review branch August 5, 2022 15:20

Jinjiang reviewed Aug 5, 2022

View reviewed changes

xfq reviewed Aug 6, 2022

View reviewed changes

itsyuxuan mentioned this pull request Aug 7, 2022

Tweak wording in view of translation conventions | 中文术语约定 #490

Merged

wxsms mentioned this pull request Aug 17, 2022

Sync #c9e1ad4 #509

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Final Review (Guide) #487

Final Review (Guide) #487

yyx990803 commented Aug 5, 2022 •

edited

Loading

netlify bot commented Aug 5, 2022 •

edited

Loading

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

Jinjiang Aug 5, 2022

xfq Aug 6, 2022

Jinjiang Aug 7, 2022

xfq Aug 6, 2022

Jinjiang Aug 7, 2022

		@@ -18,16 +18,16 @@
		- 如果需要使用全局变量版本（通过 `Vue` 全局变量访问）：请使用 `vue.global.prod.js`。


		然而，在[单页面应用](https://developer.mozilla.org/en-US/docs/Glossary/SPA)中，客户端的 JavaScript 可以拦截页面的跳转请求，动态获取新的数据，然后在无需重新加载的情况下更新当前页面。这样通常可以带来更顺滑的用户体验，尤其是在更偏向“应用”的场景下，因为这类场景下用户通常会在很长的一段时间中做出多次交互。

		在这类单页应用中，“路由”是在客户端执行的。一个客户端路由器的职责就是利用诸如 [History API](https://developer.mozilla.org/en-US/docs/Web/API/History) 或是 [`hashchange` 事件](https://developer.mozilla.org/en-US/docs/Web/API/Window/hashchange_event) 这样的浏览器 API 来管理应用当前应该渲染的视图。


		- [单文件组件](/guide/scaling-up/sfc)提供了一个模块化的开发模型，允许应用程序的不同部分被隔离开发。
		- [单文件组件](/guide/scaling-up/sfc)提供了一个模块化的开发模型，让应用程序的不同部分能够被隔离开发。

Final Review (Guide) #487

Final Review (Guide) #487

Conversation

yyx990803 commented Aug 5, 2022 • edited Loading

netlify bot commented Aug 5, 2022 • edited Loading

✅ Deploy Preview for vue-docs-zh-cn ready!

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

yyx990803 commented Aug 5, 2022 •

edited

Loading

netlify bot commented Aug 5, 2022 •

edited

Loading