A3 书籍写作规范

A3.1 专有名词

技术类专有名词依循官方常见用法。

  • Node.js
  • npm
  • JavaScript

A3.2 标点符号

以中文全角标点符号为主。

  1. ,、。!“”()

遇英文段落(整句)采用一般(半角)标点符号。中文与英文单字之间以一个空白字符隔开,标点符号与英文单字之间不需要空隔。这是为了让排版显示的自动断词断句可以正确运作,以及增加中英文混杂段落的阅读舒适。举个例子:

Node.js 是一种适合用于 Server-side 的开发框架(Framework),相当
Nice!

A3.3 特殊排版说明

中文同一段落为了方便编辑,可以将句子断行;但行尾必须加上半角“”倒斜线符号。因为在 HTML、EPUB 或 MOBI 格式中,换行字符会被当做空白字符处理,导致增加过多影响版面美观的空隔。

A3.4 代码

片段程序码(snippets),使用 inline code block,并指定 language type。

  1. if (something) {
  2. alert('test');
  3. }