1page.title=写作风格
2page.type=设计
3
4@jd:body
5
6  <h2 id="voa">Android 的语言风格</h2>
7
8  <p>撰写应用中显示的文本时，应力求简明、简易和友好。</p>
9
10  <h4 id="concise">简明</h4>
11
12  <ul>
13    <li>仅告知用户最必要的信息。</li>
14    <li>避免冗余的表述，例如标题重复陈述信息框中的正文内容。</li>
15    <li>尽可能缩短文本长度。</li>
16  </ul>
17
18  <p><em>避免使用啰嗦、生硬的文字</em></p>
19
20  <div class="layout-content-row">
21    <div class="layout-content-col span-6 layout-with-list-item-margins">
22
23      <div class="do-dont-label bad">错误做法</div>
24
25      <table class="ui-table good"><tbody><tr><td>
26      如需更详细的说明，请参考手机随附的文档。
27      </td></tr></tbody></table>
28
29    </div>
30    <div class="layout-content-col span-6">
31
32      <div class="do-dont-label good">正确做法</div>
33
34      <table class="ui-table good"><tbody><tr><td>
35      请阅读手机随附的说明。
36      </td></tr></tbody></table>
37
38    </div>
39  </div>
40
41  <p><em>请勿提供无关信息</em></p>
42
43  <div class="layout-content-row">
44    <div class="layout-content-col span-6 layout-with-list-item-margins">
45
46      <div class="do-dont-label bad">从“设置向导”屏幕</div>
47
48      <table class="ui-table bad">
49      <thead>
50        <tr>
51          <th>
52          登录…
53          </th>
54        </tr>
55      </thead>
56      <tbody>
57        <tr>
58          <td>
59          你的手机需要与 Google 服务器通信<br />
60          然后才能登录到你的帐户。<br />
61          此过程最多可能需要 5 分钟。
62          </td>
63        </tr>
64      </tbody>
65      </table>
66
67    </div>
68    <div class="layout-content-col span-6">
69
70      <div class="do-dont-label good">从“设置向导”屏幕</div>
71
72      <table class="ui-table good">
73      <thead>
74        <tr>
75          <th>
76          登录…
77          </th>
78        </tr>
79      </thead>
80      <tbody>
81        <tr>
82          <td>
83          你的手机正在连接 Google。<br />
84          此过程最多可能需要 5 分钟。
85          </td>
86        </tr>
87      </tbody>
88      </table>
89
90    </div>
91  </div>
92
93  <h4 id="simple">简易</h4>
94
95  <ul>
96    <li>使用简短字词、主动动词和常用名词。</li>
97    <li>最重要的内容放在最前面。用句首的几个字词来传达全句最重要的信息。</li>
98    <li>不要费力解释细枝末节，大部分用户并不关心这些。</li>
99  </ul>
100
101  <p><em>关注用户的兴趣点，而不是技术细节</em></p>
102
103  <div class="layout-content-row">
104    <div class="layout-content-col span-6 layout-with-list-item-margins">
105
106      <div class="do-dont-label bad">错误做法</div>
107
108      <table class="ui-table good"><tbody><tr><td>
109      手动控制 GPS，以防止其他应用使用它
110      </td></tr></tbody></table>
111
112    </div>
113    <div class="layout-content-col span-6">
114
115      <div class="do-dont-label good">正确做法</div>
116
117      <table class="ui-table good"><tbody><tr><td>
118      若想省电，请将“位置信息模式”切换为“耗电量低”
119      </td></tr></tbody></table>
120
121    </div>
122  </div>
123
124  <p><em>将重要信息放在最前面</em></p>
125
126  <div class="layout-content-row">
127    <div class="layout-content-col span-6 layout-with-list-item-margins">
128
129      <div class="do-dont-label bad">错误做法</div>
130
131      <table class="ui-table good"><tbody><tr><td>
132      其他 77 人为此 +1 了，包括张三
133      </td></tr></tbody></table>
134
135    </div>
136    <div class="layout-content-col span-6">
137
138      <div class="do-dont-label good">正确做法</div>
139
140      <table class="ui-table good"><tbody><tr><td>
141      张三及其他 76 人为此 +1 了
142      </td></tr></tbody></table>
143
144    </div>
145  </div>
146
147  <p><em>将用户目标放在最前面</em></p>
148
149  <div class="layout-content-row">
150    <div class="layout-content-col span-6 layout-with-list-item-margins">
151
152      <div class="do-dont-label bad">错误做法</div>
153
154      <table class="ui-table good"><tbody><tr><td>
155      触摸“下一步”，以完成 Wi-Fi 连接设置
156      </td></tr></tbody></table>
157
158    </div>
159    <div class="layout-content-col span-6">
160
161      <div class="do-dont-label good">正确做法</div>
162
163      <table class="ui-table good"><tbody><tr><td>
164      要完成 Wi-Fi 连接设置，请触摸“下一步”
165      </td></tr></tbody></table>
166
167    </div>
168  </div>
169
170
171  <h4 id="friendly">友好</h4>
172
173  <ul>
174    <li>使用缩写词。</li>
175    <li>使用“您”或“你”直接与读者对话。</li>
176    <li>语气应轻松自然，但要避免使用俚语。</li>
177
178  </ul>
179
180  <p><em>避免使用令人困惑或令人厌烦的表达</em></p>
181  <div class="layout-content-row">
182    <div class="layout-content-col span-6 layout-with-list-item-margins">
183      <div class="do-dont-label bad">错误做法</div>
184      <table class="ui-table bad">
185      <thead>
186        <tr>
187          <th>
188          抱歉！
189          </th>
190        </tr>
191      </thead>
192      <tbody>
193        <tr>
194          <td>
195          “MyAppActivity”活动<br />
196          （在应用“MyApp”中）无响应
197          </td>
198        </tr>
199      </tbody>
200      </table>
201
202    </div>
203    <div class="layout-content-col span-6">
204      <div class="do-dont-label good">正确做法</div>
205      <table class="ui-table good">
206      <thead>
207        <tr>
208          <th>
209          MyApp 无响应
210          </th>
211        </tr>
212      </thead>
213      <tbody>
214        <tr>
215          <td>
216          是否将其关闭？
217          </td>
218        </tr>
219      </tbody>
220      </table>
221    </div>
222  </div>
223
224
225  <h4>应避免使用的字词</h4>
226
227  <div style="padding:5px 2.1em">
228  <table>
229    <tr>
230      <td class="do-dont-label bad" style="width:40%">不使用</td>
231      <td class="do-dont-label good" style="width:40%">使用</td>
232    </tr>
233    <tr>
234      <td>一、二、三、四…</td>
235      <td>1、2、3、4…</td>
236    </tr>
237    <tr>
238      <td>应用程序</td>
239      <td>应用</td>
240    </tr>
241    <tr>
242      <td>cannot、could not、do not、did not、will not、you will</td>
243      <td><em></em>缩写词：can’t、couldn’t、don’t、didn’t、won’t、you’ll 等等</td>
244    </tr>
245      <tr>
246      <td>okay、ok</td>
247      <td>OK</td>
248    </tr>
249    <tr>
250      <td>请、抱歉、谢谢</td>
251      <td><em>故作礼貌可能会令用户生厌，特别是在提示“出错”的消息中。<br />
252          例外情况：在日语中，必须使用“请”。所以，祈使动词均应据此进行本地化（打开 -&gt; 请打开）。
253          </em></td>
254    </tr>
255      <tr>
256      <td>there is、there are、it is<br />
257          <em>以及其他“无主语”表述（语法上称为虚指）</em></td>
258      <td><em>使用名词作为主语</em></td>
259    </tr>
260    <tr>
261      <td>abort、kill、terminate</td>
262      <td>stop、cancel、end、exit</td>
263    </tr>
264      <tr>
265      <td>fail、failed 等“否定用法”<em></em></td>
266      <td><em>一般情况下，请使用肯定用语<br />
267          （例如，使用“do”而非“don’t”，除非在“不再显示…”、“无法连接”等情况下。）</em></td>
268    </tr>
269    <tr>
270      <td>me、I、my、mine</td>
271      <td>you、your、yours</td>
272    </tr>
273      <tr>
274      <td>确定吗？警告！</td>
275      <td><em>应告诉用户后果，例如，“你的所有照片和媒体内容都将丢失”</em></td>
276    </tr>
277  </table>
278
279  </div>
280
281  <h2 id="formatting_text">设置文本格式</h2>
282
283  <h4 id="capitalization">大写</h4>
284
285  <ul>
286    <li>所有界面字符串都使用句子样式的大写：“Words to live by”。</li>
287    <li>大写以下各项中的所有重要字词：
288      <ul>
289        <li>应用名称（Calendar、Google Drive）</li>
290        <li>正式功能的名称（Android Beam、Face Unlock）</li>
291        <li>专有名词（Statue of Liberty、San Francisco Giants）</li>
292      </ul>
293    </li>
294    <li>避免滥用大写。对于不属于正式功能名称中的字词，请不要使用大写：
295      <ul>
296        <li>Sim card lock、Home screen；而非 Sim Card Lock、Home Screen。</li>
297      </ul>
298    </li>
299  </ul>
300
301
302  <h4 id="punctuation">标点符号</h4>
303  <ul>
304    <li><strong>句号。</strong> 只使用单个句子或短语时（如在问候语、标签或通知中），句尾无需加句号。但如果结合使用两句或更多句，则每一句的句尾都需加句号。</li>
305    <li><strong>省略号。</strong> 省略号 (…)（MacOS 中的 Option-; 和 HTML 中的 &amp;hellip;）用于表示：
306      <ul>
307        <li>未完成的状态，例如操作正在进行（“正在下载…”）或文本未完全显示。</li>
308        <li>需要用户在随后显示的界面中做出重要选择的菜单项（例如“打印…”或“共享…”）。例外情况：如果命令的措辞已经表明需要进一步的界面操作（但有限制范围），则无需使用省略号，例如<strong>在网页中查找</strong>或<strong>选择日期</strong>。</li>
309      </ul>
310    </li>
311  </ul>
312