製作手冊時要先打好底的 Word 基本 - 以壞習慣與最佳實務並列整理
· 小村 豪 · Word, 手冊製作, 文件設計, 業務改善
操作手冊、作業流程書、維護程序、內部運用手冊。
這類文件真正在日後見真章的,不是寫作能力,而是有沒有把 Word 當成「只用來調整外觀的工具」。
一開始看起來很快的做法,
- 標題只靠粗體與字級做出來
- 用空白或 Tab 連打來對齊位置
- 按好幾次 Enter 來換頁
- 手動打出目次或頁碼參照
- 把修改意見直接以紅字留在正文中
只要混入這些做法,每次改版就會跟著崩。
本文以「壞習慣」與「最佳實務」並列的方式,整理製作手冊時實際會用到的 Word 基本。
前提是以 .docx 為主格式的 Word 桌面版運用環境。
1. 先下結論
先把結論列出來,製作手冊時這 4 點最重要:
-
讓結構交給 Word 的功能
標題、編號、目次、交互參照、分頁控制不要手打,而是用 Word 的樣式、功能變數與分節來管理。 -
不要把對齊交給空白字元
空白鍵、Tab 連打、空行連打,在日後每次調整時都會崩掉。該用段落設定、縮排、表格與分節。 -
不要把審閱混進正文
修改指示不該是紅字正文,要用註解與追蹤修訂分開。這樣最終版本才清楚哪些已經定案。 -
在發布前把自動元素更新一次
目次、頁碼、交互參照、圖表編號在最後統一更新。要轉成 PDF 前,也檢查一次無障礙。
2. 不要把 Word 當手動對齊工具
製作手冊最重要的,是把 外觀 與 結構 分開。
例如下面這些東西,本質上都是「結構」:
- 章、節、小標題
- 步驟 1、步驟 2、步驟 3
- 圖 2-1、表 3-2
- 參見第 4 章
- 只有封面頁不顯示頁碼
- 改版時的修訂履歷
但在容易崩掉的文件中,這些「結構」全被用「外觀調整」帶過:
- 把字調大,看起來像標題
- 手動打
1. - 用空白對齊
- 按 Enter 換頁
- 直接寫「參見第 3 頁」
只要用這種方式,一改一處就會連帶把別處也弄亂。
Word 本身就內建了標題樣式、目次、段落設定、多層次編號、頁首 / 頁尾、分節符號、標題標號、追蹤修訂、無障礙檢查等,用來 用結構管理文件 的功能。
製作手冊時,光是把這些基本功能用上,事故就能減少很多。
3. 壞習慣與最佳實務對照
| 項目 | 壞習慣 | 最佳實務 |
|---|---|---|
| 標題 | 只靠粗體 + 字級來分章節 | 使用 標題 1 / 標題 2 / 標題 3 |
| 對齊 | 用空白或 Tab 連打對齊 | 使用段落設定、縮排、定位點、表格 |
| 分頁控制 | 用 Enter 連打推到下一頁 | 使用分頁符、分節符 |
| 目次 | 手動打目次 | 用標題樣式 + 自動目次 |
| 步驟編號 | 手動打 1. 2. 3. |
使用編號清單 / 多層次清單 |
| 頁首、頁尾 | 每一頁都直接輸入 | 使用頁首 / 頁尾與頁碼 |
| 圖表 | 只貼圖、沒有標題 | 加上標題標號、本文補充、替代文字 |
| 修改意見 | 把紅字和色標直接留在文件裡 | 用追蹤修訂與註解來審閱 |
| 參照 | 手寫「參見第 3 頁」「上圖」 | 使用交互參照與功能變數更新 |
| 樣式規則 | 每個人做出來都不一樣 | 先把範本與樣式定好 |
4. 實務上要抓住的重點
4.1 標題只靠粗體和字級做出來
壞習慣
把字變大、加粗,讓它「看起來像標題」就結束。
為什麼辛苦
Word 不會把那一行當成正式的標題。
在功能窗格中難以跳轉,自動目次也抓不到。從無障礙角度來看,只是外觀的標題也不利。
最佳實務
對章、節、小標題指派 標題 1 / 標題 2 / 標題 3。
想改變外觀時,別一行一行去動粗體或字級,而是改 樣式本身。
4.2 用空白或 Tab 連打對齊
壞習慣
在操作名稱和說明之間用空白填滿、右側的版本號用 Tab 連打推過去、中間硬塞幾行空行當作段距。
為什麼辛苦
文字多一個字就會整個跑掉。
改字型、加段落、轉 PDF、共同編輯時都很容易位移。
最佳實務
位置與邊界要讓 段落設定 來扛,而不是 字元。
使用縮排、定位點、段落前後間距,必要時改用表格。
4.3 用 Enter 連打來換頁
壞習慣
想讓下一章從新的一頁開始,所以按好幾次 Enter 硬推過去。
為什麼辛苦
上一頁多了 1 行,整個後面就會跑掉。
會跑出空白頁、標題只剩在前一頁、頁首 / 頁尾在意料外的位置切換等現象。
最佳實務
新章的開頭用 分頁符,要切換頁碼或頁首 / 頁尾行為的位置用 分節符。
一出問題就把 ¶ 顯示打開,讓分頁符和段落符號看得見再排查。
4.4 目次、編號、交互參照不要手打
壞習慣
手動做目次頁,每次都重打章名和頁碼。
在正文中直接打 1. 2. 3. 或 1.1 1.2。
直接寫「參見第 12 頁」、「請見圖 3」。
為什麼辛苦
改版時很容易漏改。
只改了頁碼、但標題名稱卻還是舊的,這種事故很常見。
最佳實務
用標題樣式做出 自動目次。
步驟用 編號清單、章節體系用 多層次清單 來管理。
對圖號、頁碼、章號的引用都用 交互參照 或功能變數,最後一次統一更新。
4.5 頁首 / 頁尾和版本號不要一頁一頁直接打
壞習慣
文件名、版本、頁碼都直接輸入在每一頁上。
為了讓封面頁特別一點,就手動調整外觀。
為什麼辛苦
更新版本時容易漏改、頁碼會跑、中途想只對附錄換樣式時就崩掉。
最佳實務
文件名、版本、頁碼集中放進 頁首 / 頁尾。
封面要特殊處理時用 第一頁不同;要對章節或附錄分開切換時,就用分節符配合取消 與前一節相同 的頁首 / 頁尾連結。
4.6 把修訂、註解、圖表分開
壞習慣
在文件中用紅字寫「這邊要改」、「未確認」、「待討論」,最終版也把這些留著。
只貼整個螢幕的截圖,沒有圖號也沒有說明。
為什麼辛苦
哪一段是正文、哪一段是審閱中的備忘,會分不清。
也容易讓最終版殘留審閱痕跡。
最佳實務
修改本身用 追蹤修訂,商量或指示用 註解,兩者分開。
圖表要加 標題標號,視需要設定替代文字。
5. 手冊用 Word 範本的最低限度
一開始不需要搞得很華麗,下面這樣就夠:
| 元素 | 用途 | 最低規則 |
|---|---|---|
| 文件標題 | 封面、開頭標題 | 放文件名、版本、製作日、改版日 |
標題 1 |
章 | 納入自動目次 |
標題 2 |
節 | 納入自動目次 |
標題 3 |
小標題 | 視需要使用 |
內文 |
正文 | 基本段落 |
| 編號清單 | 步驟 | 用於操作步驟 |
| 項目符號 | 補充 | 用於列出條件或注意事項 |
| 圖說明 | 圖號 | 圖 1、圖 2… |
| 表說明 | 表號 | 表 1、表 2… |
| 頁首 / 頁尾 | 共通資訊 | 文件名、版本、頁碼 |
進一步訂下面這些運用規則也會輕鬆很多:
- 原稿為
.docx - 對外發布為 PDF
- 改版時使用追蹤修訂
- 發布前更新功能變數
- 發布前做無障礙檢查
6. 發布前檢查
把手冊輸出成 PDF 前,至少要檢查下列項目:
6.1 全文功能變數更新
用 Ctrl + A 全選後,更新所有功能變數。
可以減少目次、頁碼、交互參照、圖表編號的漏更新。
6.2 整理追蹤修訂與註解
確認審閱途中留下的修訂與註解是否都已經處理。
注意「只是把顯示關掉」而實際還留著的情況。
6.3 檢查標題層級
檢查章節是否都用 標題 1 / 2 / 3 統一管理。
這邊沒對齊,目次和導覽就會亂。
6.4 檢查圖片與表格
檢查圖表有沒有編號、圖片會不會太大、本文有沒有說明該看什麼。
6.5 無障礙檢查
執行無障礙檢查,確認標題、替代文字、對比、表格結構等沒有問題。
如果要輸出成 PDF 發布,先在 Word 這邊整理好會比較安全。
7. 結語
用 Word 做手冊時,最要避免的是 連結構都用手動方式維護。
- 標題交給樣式
- 步驟交給編號功能
- 目次交給自動產生
- 分頁交給分頁符與分節
- 圖表交給標題標號
- 審閱交給追蹤修訂與註解
- 引用交給交互參照
- 發布前統一更新與檢查
重點是:不要把 Word 當成「打字工具」就結束,要把它當作 管理文件結構的工具 來使用。
手冊真正的差別,不在寫下的那一刻,而在修改的那一刻。
每次改版就崩掉的文件,多半在進到內容之前,Word 的基本規則就已經崩了。
反過來說,光是把這些基本做好,文件的可維護性就會大幅提升。
一開始不用追求華麗的設計。
先把 標題、編號、目次、分頁、審閱 這 5 件事從手動操作中移除,才是最實務的做法。
相關文章
共用相同標籤的最新文章。能以相近的主題延伸理解。
Word 手冊製作應用篇 - 圖片・圖・螢幕截圖配置的糟糕模式與最佳實踐
本文以糟糕模式與最佳實踐並列,整理 Word 手冊中圖片、圖與螢幕截圖的處理方式。涵蓋預設與文字排列、首次出現直後配置、裁切、圖編號自動化、文繞圖的例外運營,以及容量、機密資訊、替代文字與無障礙檢查等發佈前關鍵點。
整理 Windows 的字元編碼與換行符 - Shift_JIS / UTF-8 / UTF-16、亂碼、CRLF / LF,為何混亂
本文整理 Windows 上字元編碼與換行符容易混亂的核心:bytes、UTF-8 與 CP932、UTF-16LE、BOM、CRLF 與 LF 是不同軸的概念,亂碼源於以錯誤前提 decode,且誤儲存後無法還原。讀完即可在規格中寫出明確的 encoding 與換行約定,...
偽隨機數與真正隨機數的差異 - 如何區分的整理
本文整理偽隨機數與真正的隨機數差異,重點不在輸出外觀而在產生器結構:一般 PRNG 重視可重現性、CSPRNG / DRBG 主打不可預測性、NRBG 則以物理熵源為基礎。文中說明 seed 與 reseed、health test 的角色,並給出資安、模擬、抽籤等用途的選...
GS1 等條碼規格中,標準定義了什麼、實務運用上要注意什麼 - GTIN · AI · GS1-128 · GS1 DataMatrix 的整理
整理 GS1 條碼規格中被標準化的範圍,把 GTIN、AI、GS1-128、GS1 DataMatrix、GS1 QR Code 的差異與適用場景分層說明,並彙整 FNC1、掃描器輸出、商品主檔運用等接收端容易踩雷的重點,協助讀者把條碼當作可共享的業務介面來設計。
開發 COM 元件、OCX/ActiveX 時常見的坑 - 整理 Visual Studio 的 32bit/64bit、註冊、管理員權限
整理開發 COM、OCX、ActiveX 元件時最容易卡關的四個面向:宿主行程的 32bit/64bit、Visual Studio 2022 變成 64bit 後的設計時整合、regsvr32 與 Regasm 的註冊位置、以及管理員權限與 HKCU/HKLM 的關係,協...
相關主題
與本文相近的主題頁面。以本文為起點,可進一步連到相關服務與其他文章。
Windows 技術主題
彙整 KomuraSoft LLC 關於 Windows 開發、故障調查與既有資產活用文章的主題中心。
作者檔案
本文作者的個人檔案頁面。
Go Komura
小村軟體有限公司 代表
以 Windows 軟體開發、技術諮詢與故障調查為中心,在難以重現的故障調查與既有資產仍在運作的專案上具有優勢。