<commit_before>#書籍寫作規範

##章節標題設定

 * 章節標頭為 H1, #
 * 章節底下第一層目錄為 h2, ##
 * 章節底下第二層目錄為 h3, ###

##專有名詞

技術類專有名詞依循官方常見用法。
 
| English | 中文翻譯 |
| --- | ---|
| Node.js | Node.js |
| JavaScript | JavaScript|
| npm | npm |
| package | package|
| module | 模組 |
| export | export |
| closure | 閉包 |
| CommonJS | ComonJS |
| Framework | 框架 |


##中英文混雜

中英文夾雜時，必須要使用『半型空白』隔開，
 
####中英文混搭專有名詞範例，

  此書獻給所有 Node.js 以及對於 JavaScript 熱愛的程式開發者


##標點符號

以中文全形標點符號為主。

  * ，、。！「」（）

遇英文段落（整句）採用一般（半形）標點符號。

中文與英文單字之間以一個空白字元隔開，標點符號與英文單字之間不需要空隔。

這是為了讓排版顯示的自動斷詞斷句可以正確運作，以及增加中英文混雜段落的閱讀舒適。

####標點符號範例

  Node.js 是一種適合用於 Server-side 的開發框架（Framework），相當 Nice！

##特殊排版說明

中文同一段落為了方便編輯，可以將句子斷行；\
但行尾必須加上半形「\」倒斜線符號。\
因為在 HTML、EPUB 或 MOBI 格式中，\
換行字元會被當做空白字元處理，導致增加過多影響版面美觀的空隔。

###程式碼

只有一行、不需要 Highlight，或是一般的 command line 操作指令說明，\
使用標準 Code 寫法。

    This is line One
    This is line Two

片段程式碼（snippets），使用 inline code block，並指定 language type。

程式碼與 ``.. code-block`` 之間一定要隔一個空行，且一定要有程式碼（否則文件無法編譯）。

.. code-block:: javascript

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

.. literalinclude:: src/hello.js
   :language: javascript
<commit_msg>Update convention.md<commit_after>#書籍寫作規範

##章節標題設定

 * 章節標頭為 H1, #
 * 章節底下第一層目錄為 h2, ##
 * 章節底下第二層目錄為 h3, ###

##專有名詞

技術類專有名詞依循官方常見用法。
 
| English | 中文翻譯 |
| --- | ---|
| Node.js | Node.js |
| JavaScript | JavaScript|
| ECMAScript | ECMAScript|
| npm | npm |
| package | package|
| module | 模組 |
| export | export |
| closure | 閉包 |
| CommonJS | ComonJS |
| Framework | 框架 |


##中英文混雜

中英文夾雜時，必須要使用『半型空白』隔開，
 
####中英文混搭專有名詞範例，

  此書獻給所有 Node.js 以及對於 JavaScript 熱愛的程式開發者


##標點符號

以中文全形標點符號為主。

  * ，、。！「」（）

遇英文段落（整句）採用一般（半形）標點符號。

中文與英文單字之間以一個空白字元隔開，標點符號與英文單字之間不需要空隔。

這是為了讓排版顯示的自動斷詞斷句可以正確運作，以及增加中英文混雜段落的閱讀舒適。

####標點符號範例

  Node.js 是一種適合用於 Server-side 的開發框架（Framework），相當 Nice！

##特殊排版說明

中文同一段落為了方便編輯，可以將句子斷行；\
但行尾必須加上半形「\」倒斜線符號。\
因為在 HTML、EPUB 或 MOBI 格式中，\
換行字元會被當做空白字元處理，導致增加過多影響版面美觀的空隔。

###程式碼

只有一行、不需要 Highlight，或是一般的 command line 操作指令說明，\
使用標準 Code 寫法。

    This is line One
    This is line Two

片段程式碼（snippets），使用 inline code block，並指定 language type。

程式碼與 ``.. code-block`` 之間一定要隔一個空行，且一定要有程式碼（否則文件無法編譯）。

.. code-block:: javascript

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

.. literalinclude:: src/hello.js
   :language: javascript

{'fraction_non_alphanumeric': 0.14749780509218613, 'fraction_numerical': 0.0026338893766461808, 'mean_word_length': 3.901075268817204, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1030446', 'n_tokens_mistral': 1596, 'n_tokens_neox': 1821, 'n_words': 191}