豌豆荚文案风格指南

[a]

这是文书表述上的一些文字格式规范,目的在于增强文字的可读性和豌豆荚产品及豌豆们对外形象的一致性,适用范围包括但不限于软件界面、帮助文档等严肃内容平台,博客和微博等网络宣传媒体平台的用词风格可较轻松活泼些。本指南会不断增补修订[b]

标点符号

  1. 中文文书原则上请使用全角标点符号,英文文书请使用半角标点符号。中英夹杂原则上请使用全角标点符号。下面有另行规定者例外。
  2. 括号的使用:中文文书中,括号中包括数字时采用半角括号,并在括号外留一个空格。例如:全部联系人 (12)[c]
  3. 英文文书逗号和句号后请留一个半角空格;中英夹杂文书中英文 (包括数字) 与汉字之间留一个半角空格。
  1. 正确:「这是 1 只 HTC 手机」错误:「这是1只HTC手机」
  2. 正确:「2011 年 8 月 14 日」错误:「2011年8月14日」
  1. 百分号写法:56.8% 是对的,56.8 % 是错的。百分号和它前面的数字之间不留空格。
  2. 段落之间使用 <p> 标签分隔 (一般来说实施效果是,段落间的视觉空隙为一倍 line-height)。段首不要空格。
  3. 不要使用「。。。」代替「……」 ,也不要使用三个英文句点「.」代替(实施:两个 &hellip; )。
  4. 引号一律使用「」,而不是 “”。
  5. 严禁出现「!!」。尽量避免使用「!」。请先冷静下来再坐电脑前敲键盘。
  6. 长数字的书写:从小数点起,向左和向右每三位数字一组,组间空格。示例:2 748 456。

遣词造句

  1. 对用户称呼「您」。
  2. 人称代词:当提及豌豆荚团队时,请尽量使用「豌豆们」代替「我们工程师团队」、「我们」。
  3. 能用中文就尽量避免英文罗马字。
  4. 手机品牌:中国的用中文,外国的用英文。
  5. 用主动语态,不要用被动语态。一般情况下,主动语态比被动语态更有力
  6. 使用具体、明确、展示细节的词汇,能激发想象,使读者自己代入情境。「把硬币放进口袋里,他咧开嘴笑了」,远远强过「他满意地拿走了辛苦挣来的奖赏」。
  7. 减少形容词的使用,少用 「的」,避免使用「哈,哈哈」、「呵,呵呵」等。
  8. 请使用常用词汇,不要用网络新词、科学术语和行话[d],该解释的要解释清楚。例如,「任务」等词即过于技术化,APK 亦禁止出现。
  9. 记住,不要让用户来猜你在写什么
  10. 记住,如果你写了一条文案觉得非常聪明非常好笑,很可能需要停下来想一下用户是否能理解。(本条感谢 37signals 的文案建议
  11. 「的」「地」「得」要用对。是的,连小学都不要求了但是要用对。
  12. 卖萌和幽默建议:
  1. 以下情况下幽默卖萌需要非常谨慎:报错信息,涉及支付、安全和隐私的信息;
  2. 以下情况下推荐卖萌或幽默文案:用户引导、新功能介绍。

用字规范

  1. 手机正式名称可以以 Google Phone Gallery 上的为准,括号加注通用名或昵称,如:「Google Nexus One (N1 或 G5)」,「HTC Desire (G7)」。禁止只用通用名的写法。
  2. 根据软件发布流程的一般写法,所有用户可见的版本有:Beta、Release Candidate,未来可能对开发者可见的版本:Alpha。统一为首字母大写。两侧不出现中文或英文引号,也不出现括号。
  3. 用 root(小写字母)直接表达 root,不用引号

豌豆荚的产品名

豌豆荚只有一个产品,即「豌豆荚」。一般情况下均使用「豌豆荚」的统一称呼,不加区分。

如有可能出现混淆,用通俗易懂的语言告知用户。如:「请在手机上打开豌豆荚」,或使用「Windows 上的豌豆荚」、「Android 上的豌豆荚」。

遇极少数实在无法避免之例外情况,可称为「豌豆荚 xx 版」,如「豌豆荚 Windows 版」,「豌豆荚 Android 版」,「豌豆荚 Web 版」。

常用名词列表

[a]原文档中有一些同事的 comments 一并摘抄如下。

[b]这个文档应该加入 technical description,以便在实现时总是使用同一个方案。Yahoo Style Guideline 就包括大多数标点用的转义符和 Unicode 编码。 http://styleguide.yahoo.com/resources/basic-webpage-coding/special-characters

—cat

[c]Junyu:「如果标点符号都用中文的话, 括号在界面中占的位置会很大, 例如「全部联系人(12)」,我在想应该用英文比较合适。那就是得规定一下什么符号用中文,什么符号用英文。」

关于括号的用法,列了几个:

全角标点:

半角标点,不空联系人

有(三)个更新

全部(12)个联系人

有(三)个更新

半角标点,括号前后一个空格

全部 ( 12 ) 个联系人

有 ( 三 ) 个更新

半角标点,括号外空格: 全部 (12) 个联系人

有 (三) 个更新

和 junyu 一致觉得「半角标点,括号外空格」半角标点,括号外空格看起来比较美观。

格: 全部(12)个

—chenta

[d]比如apk这类词就不是每个用户都知道是什么。请用安装文件代替。

—hidecloud