LeanCloud 文案风格指南

本文转载自 LeanCloud 文案风格指南

公司及产品名称

我们的公司及产品名称是「LeanCloud」。注意这是两个单词的合成词，中间沒有空格（參考：GitHub）。如作为 URL 的一部分，应该使用全小写的「leancloud」。

文案风格

一定多检查，确保没有错别字。即使是流行语中故意的谐音错别字也不要使用，比如「墙裂」、「童鞋」等。我们崇尚精练的文风。请在检查中把对表达意思没有明显作用的字、词、句删除，在不影响表达效果的前提下把文案长度减到最短。

中文、英文、数字混合时空格的使用

英文与非标点的中文之间需要有一个空格，如「使用 LeanCloud 开发移动应用」而不是「使用LeanCloud开发移动应用」。数字与非标点的中文之间需要有一个空格，如「我们发布了 5 个产品」而不是「我们发布了5个产品」。尽可能使用中文数词，特别是当前后都是中文时。上面的例子写为「我们发布了五个产品」会更好。数字与单位之间需要有一个空格，如「5 GB」而不是「5GB」。注意特殊名词的大小写：Android、iOS、iPhone、Google、Apple，无论是否在句首都应该以同样的方式写。在官方文案中尽量使用中文，避免中英文混合的情况。例如「app」一般应写为「应用」或「移动应用」。品牌、产品名、人名、地名等特殊名词，如果来自英文，请使用英文以避免在不同译法间选择。

标点相关

只有中文或中英文混排中，一律使用中文/全角标点。中英文混排中如果出现整句英文，则在这句英文中使用英文/半角标点。中文标点与其他字符间一律不加空格。中文文案中使用中文引号「」和『』，其中「」为外层引号。Mac 上如「百度输入法」等都可以方便地输入中文引号。

段落

如果是纯文本，段落之间使用一个空行隔开。如果是 HTML 或其他富文本格式，使用额外空白作为段落间的分隔。段落开头不要留出空白字符。

对第三方内容的引用

如果在正文中部分引用第三方内容，请使用恰当的引用格式并给出出处。如：

One man’s constant is another man’s variable.
— Alan Perlis

如果是全篇转载，请在全文开头显著位置注明出处并链接至原文，如：

本文转载自 WikiQuote

如果格式不允许超链接，请以文本方式直接给出原文链接。如果原文链接太长影响美观，可以使用短链接服务。如：

本文转载自 WikiQuote：http://bit.ly/UlHIdN

图片的使用

图片加载缓慢，经常因为被屏蔽或者加载失败而不能正常显示，并且图片上的文字无法自动适应屏幕大小和分辨率，所以在线上媒介上不要将大段文字放在图片上。Logo 等需要使用特殊字体的局部文字除外。作为文章一部分的各级标题也应该使用通用字体和文本形态。

一些具体用词

「你」和「您」：在不是很正式或没有明确的个体指代对象的时候请用「你」，如文档、博客、群发的邮件等；在指代特定个体时请用「您」，如活动邀请函等。字体和字号的一致：在富文本格式文档中，特别是 HTML 邮件中，常有人因为从不同来源复制粘贴而导致同一层次的文本字体和字号不一致。这给人不专业的感觉，请避免。App 是 application 的缩写，发音为 /ˈæp/，在演讲等口头表达里要注意不要把三个字母拆开念。App 是一个普通名词而不是多个单词的首字母缩写，所以不应该用全大写的 APP。和其他词一样，大小写规则取决于是否处于句首、标题、或特殊短语（如 App Store）中。大多数情况下应该使用中文「应用」以避免这样的问题。不要称呼喜欢我们的用户为「粉丝」，而是使用「用户」。粉丝的说法显得不平等。而且很多人不喜欢这种称呼，因为它含有缺乏独立思考的意思。

推荐阅读

余光中：怎样改进英式中文？——论中文的常态与变态「The Elements of Style」，虽然是讲英语，但很多对中文也适用。