Skip to content
Jinjiang edited this page May 26, 2020 · 21 revisions

术语翻译约定

英文 建议翻译
property 不翻译
attribute 不翻译
getter 不翻译
setter 不翻译
prop 不翻译
ref 不翻译
feature/functionality 功能
directive 指令
mixin 混入
listen/listener 监听/监听器
observe/observer 侦听/侦听器
watch/watcher 侦听/侦听器
normalize (HTML code, ...) 规范化
standardize 标准化
emit/fire/trigger (an event) 触发
emit (a value) 抛出
queue (v.) 把……加入队列
workaround (n.) 变通办法
workaround (v.) 绕过
convention 约定
parse 解析
stringify 字符串化
side effect 副作用
declarative 声明式
imperative 命令式
handler 处理函数
you 你 (而不用“您”)
computed 计算属性
computed property 计算属性
guard 守卫
hook 钩子
selector 选择器
truthy, falsy, truthiness 不翻译,保留精准的英文,但要加 MDN 的解释作为译注
mutate/mutation 变更
immutable 不可变
mutable 可变

被保留的英文

  • attribute
  • property
  • prop
  • getter
  • setter
  • ref

被保留的英文单复数问题

中文翻译中夹带的英文一律以单数形式呈现。如:

  • props -> prop
  • children -> child

译注写法

  1. 在原文需要加译者注的位置添加角标:
... <sup>[[1]](#footnote-1)</sup> ... <sup>[[2]](#footnote-2)</sup> ...
  1. 在文章最末尾加入译者注的内容,格式如下:
<small>
__译者注__
<a id="footnote-1"></a>[1] ...
<a id="footnote-2"></a>[2] ...
<a id="footnote-3"></a>[3] ...
</small>

标点符号

  • 逗号、句号、分号、冒号、叹号、问号,统一使用全角字符:,。;:!?
  • 破折号使用:——
  • 引号统一使用“”和‘’
  • 括号统一使用半角括号 ()
  • 非注释部分的代码除外,保留英文标点符号。

内联代码或代码关键字

  • 务必用反引号,即英文输入法下按键盘上 Tab 键上方的那个键输出的那个字符,括起来。
  • 包括代码注释中出现代码或代码关键字时,也要括起来。

空格的使用

  • 英文单词和英文单词之间要有一个空格
  • 中文和英文单词之间要有一个空格
  • 英文单词和标点符号之间没有空格
  • 注意有加粗斜体链接等特殊情况时空格的准确运用
    遵守 **JavaScript 编码规范**非常重要
    遵守 [JavaScript 编码规范](#foo)非常重要
    更多信息详见*中文 MDN* 的介绍页面。
    更多信息详见[中文 MDN](#bar) 的介绍页面。
    

关于加粗和斜体格式的约定

根据 GitHub Flavored Markdown Spec,用成对的星号或下划线都可以用来代表加粗或斜体,但是使用下划线的时候存在更多的特殊条件限制,例如:

5*6*78<p>5<em>6</em>78</p>

https://github.github.com/gfm/#example-346

5_6_78<p>5_6_78</p>

https://github.github.com/gfm/#example-351

via: https://github.com/vuejs/cn.vuejs.org/pull/727#issuecomment-385399073

经过讨论,考虑到 GFM 的规范以及中文的特殊情况,决定

  1. 中文翻译统一使用星号来标注加粗和斜体,而不是使用下划线,同时尊重英文版自身的用法。
  2. 仍然不能正确渲染的地方,允许适当调整包含或不包含加粗或斜体部分两侧的标点符号。如 https://github.com/vuejs/composition-api-rfc/pull/30/files
  3. 仍然不能正确渲染的地方,使用 <strong><em> 标记。