专栏首页前端之旅译文排版规范

译文排版规范

前言: 这是之前还在论坛当版主的时候,给自己定下的汉化规矩: 1.按照固定格式来排版; 2.能力有限不是机翻和偷工减料的借口; 3.尽量得到原作者的转载授权 虽然不再参与汉化工作了,但是有一些好的习惯值得继续保持。


统一中文文案、排版的相关用法,降低沟通成本,增强译文的规范性和气质,使其更加易读。

空格

「有研究显示,打字的时候不喜欢在中文和英文之间加空格的人,感情路都走得很辛苦,有七成的比例会在 34 岁的时候跟自己不爱的人结婚,而其余三成的人最后只能把遗产留给自己的猫。毕竟爱情跟书写都需要适时地留白。与大家共勉之。」——vinta/paranoid-auto-spacing

中英文之间需要增加空格

正确:

在 LeanCloud 上,数据存储是围绕 AVObject 进行的。

错误:

在LeanCloud上,数据存储是围绕AVObject进行的。

在 LeanCloud上,数据存储是围绕AVObject 进行的。

完整的正确用法:

在 LeanCloud 上,数据存储是围绕 AVObject 进行的。每个 AVObject 都包含了与 JSON 兼容的 key-value 对应的数据。数据是 schema-free 的,你不需要在每个 AVObject 上提前指定存在哪些键,只要直接设定对应的 key-value 即可。

例外:「豆瓣FM」等产品名词,按照官方所定义的格式书写。

中文与数字之间需要增加空格

正确:

今天出去买菜花了 5000 元。

错误:

今天出去买菜花了 5000元。

今天出去买菜花了5000元。

数字与单位之间需要增加空格

正确:

我家的光纤入户宽带有 10 Gbps,SSD 一共有 20 TB。

错误:

我家的光纤入户宽带有 10Gbps,SSD 一共有 10TB。

例外:度/百分比与数字之间不需要增加空格:

正确:

今天是 233° 的高温。

新 MacBook Pro 有 15% 的 CPU 性能提升。

错误:

今天是 233 ° 的高温。

新 MacBook Pro 有 15 % 的 CPU 性能提升。

全角标点与其他字符之间不加空格

正确:

刚刚买了一部 iPhone,好开心!

错误:

刚刚买了一部 iPhone ,好开心!

标点符号

不重复使用标点符号

正确:

德国队竟然战胜了巴西队!

她竟然对你说「喵」?!

错误:

德国队竟然战胜了巴西队!!

德国队竟然战胜了巴西队!!!!!!!!

她竟然对你说「喵」??!!

她竟然对你说「喵」?!?!??!!

破折号前后需要增加一个空格

正确:

你好,我是破折号 —— 一个不苟言笑的符号。

错误:

你好,我是破折号——一个不苟言笑的符号。

全角和半角

不明白什么是全角(全形)与半角(半形)符号?请查看维基百科词条『全角和半角』。

使用全角中文标点

正确:

嗨!你知道嘛?今天前台的小妹跟我说「喵」了哎!

核磁共振成像(NMRI)是什么原理都不知道?JFGI!

错误:

嗨! 你知道嘛? 今天前台的小妹跟我说 “喵” 了哎!

嗨!你知道嘛?今天前台的小妹跟我说”喵”了哎!

核磁共振成像 (NMRI) 是什么原理都不知道? JFGI!

核磁共振成像(NMRI)是什么原理都不知道?JFGI!

数字使用半角字符

正确:

这件蛋糕只卖 1000 元。

错误:

这件蛋糕只卖 1000 元。

例外:在设计稿、宣传海报中如出现极少量数字的情形时,为方便文字对齐,是可以使用全角数字的。

遇到完整的英文整句、特殊名词,其內容使用半角标点

正确:

乔布斯那句话是怎么说的?「Stay hungry, stay foolish.」

推荐你阅读《Hackers & Painters: Big Ideas from the Computer Age》,非常的有趣。

错误:

乔布斯那句话是怎么说的?「Stay hungry,stay foolish。」

推荐你阅读《Hackers&Painters:Big Ideas from the Computer Age》,非常的有趣。

名词

专有名词使用正确的大小写

大小写相关用法原属于英文书写范畴,不属于本 wiki 讨论內容,在这里只对部分易错用法进行简述。

正确:

使用 GitHub 登录

我们的客户有 GitHub、Foursquare、Microsoft Corporation、Google、Facebook, Inc.。

错误:

使用 github 登录

使用 GITHUB 登录

使用 Github 登录

使用 gitHub 登录

使用 gイんĤЦ8 登录

我们的客户有 github、foursquare、microsoft corporation、google、facebook, inc.。

我们的客户有 GITHUB、FOURSQUARE、MICROSOFT CORPORATION、GOOGLE、FACEBOOK, INC.。

我们的客户有 Github、FourSquare、MicroSoft Corporation、Google、FaceBook, Inc.。

我们的客户有 gitHub、fourSquare、microSoft Corporation、google、faceBook, Inc.。

我们的客户有 gイんĤЦ8、キouЯƧquムгє、๓เςг๏ร๏Ŧt ς๏гק๏гคtเ๏ภn、900913、ƒ4ᄃëв๏๏к, IПᄃ.。

不要使用不地道的缩写

正确:

我们需要一位熟悉 JavaScript、HTML5,至少理解一种框架(如 Backbone.js、AngularJS、React 等)的前端开发者。

错误:

我们需要一位熟悉 Js、h5,至少理解一种框架(如 backbone、angular、RJS 等)的 FED。

排版

斜体文字使用加粗样式代替

正确:

斜体本身是为西文文字所设计,为了保持良好的阅读效果,在中文排版时不应出现斜体,因此统一使用加粗样式代替。

错误:

斜体本身是为西文文字所设计,为了保持良好的阅读效果,在中文排版时不应出现斜体,因此统一使用加粗样式代替。

如果文章中有脚注怎么办

英文原文中经常会出现脚注的情况,我们在译者 LeopPro 的推荐下,选择如下的方案:

这里是修改后的脚注显示方案 <sup><a href="#note1">[1]</a></sup>
1. <a name="note1"></a> [how-to-add-footnotes-to-github-flavoured-markdown](http://stackoverflow.com/questions/25579868/how-to-add-footnotes-to-github-flavoured-markdown)

预览效果如下:

这里是修改后的脚注显示方案 [1]

  1. how-to-add-footnotes-to-github-flavoured-markdown

详见译者 LeopPro 提的 Issue:https://github.com/xitu/gold-miner/issues/3153

争议

以下用法略带有个人色彩,即:无论是否遵循下述规则,从语法的角度来讲都是正确的,但同一篇文章风格要保持一致

链接之间增加空格

用法:

提交一个 issue 并分配给相关同事。

访问我们网站的最新动态,请 点击这里 进行订阅!

对比用法:

提交一个 issue 并分配给相关同事。

访问我们网站的最新动态,请点击这里进行订阅!

简体中文使用直角引号

用法:

「老师,『有条不紊』的『紊』是什么意思?」

对比用法:

“老师,‘有条不紊’的‘紊’是什么意思?”

工具

仓库

语言

vinta/paranoid-auto-spacing

JavaScript

huei90/pangu.node

Node.js

huacnlee/auto-correct

Ruby

sparanoid/space-lover

PHP (WordPress)

nauxliu/auto-correct

PHP

hotoo/pangu.vim

Vim

sparanoid/grunt-auto-spacing

Node.js (Grunt)

hjiang/scripts/add-space-between-latin-and-cjk

Python

参考

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Linux搭建Nexus3.X构建maven私服

    如果Linux硬件配置比较低的话,建议修改为合适的大小,否则会出现运行崩溃的现象

    掌上编程
  • github deepfake项目faceswap

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 ...

    sofu456
  • zfaka 增加易支付接口

    Github:https://github.com/zlkbdotnet/zfaka

    Alone88
  • Windows使用ROS机器人操作系统教程说明

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 ...

    zhangrelay
  • GIT 常用快捷命令

    git rm --cached /path/to/file,然后正常 add 和 commit 即可。

    Alone88
  • AI_第一部分 数据结构与算法(12.排序算法实战下)

    第四阶段我们进行深度学习(AI),本部分(第一部分)主要是对底层的数据结构与算法部分进行详尽的讲解,通过本部分的学习主要达到以下两方面的效果:

    还是牛6504957
  • AI_第一部分 数据结构与算法(14.二分查找算法)

    第四阶段我们进行深度学习(AI),本部分(第一部分)主要是对底层的数据结构与算法部分进行详尽的讲解,通过本部分的学习主要达到以下两方面的效果:

    还是牛6504957
  • ROS2学习和使用SLAM算法(gmapping/cartographer/orb-slam等)

    版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。 ...

    zhangrelay
  • AI_第一部分 数据结构与算法(13.图解递归)

    第四阶段我们进行深度学习(AI),本部分(第一部分)主要是对底层的数据结构与算法部分进行详尽的讲解,通过本部分的学习主要达到以下两方面的效果:

    还是牛6504957
  • 初学者|手把手带你学TextBlob

    本文介绍了TextBlob的使用方法,这是一个用Python编写的开源的文本处理库。它可以用来执行很多自然语言处理的任务,比如,词性标注,名词性成分提取,情感分...

    用户1737318

扫码关注云+社区

领取腾讯云代金券