# A3 书籍写作规范

## A3.1 专有名词

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

* Node.js
* npm
* JavaScript

## A3.2 标点符号

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

```
，、。！“”（）
```

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

> Node.js 是一种适合用于 Server-side 的开发框架（Framework），相当 Nice！

## A3.3 特殊排版说明

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

## A3.4 代码

片段程序码（snippets），使用 inline code block，并指定 language type。

```javascript
if (something) {
    alert('test');
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nodebook.whyun.com/a3_convention.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.