google-docs-layout

Google Docs 固定版面

責任

本技能負責把參考圖或位置需求轉成可維護的 Google Docs 固定版面，並建立程式驗證與實際文件目視驗收。Apps Script 環境、Git、clasp、OAuth 與遠端同步交由 google-apps-script-project-development；逐步教學交由 google-apps-script-teaching；執行錯誤與異常結果交由 google-apps-script-debugging。

本技能不是新的首頁模式。使用者未指定要做專案或學習時，仍由 google-apps-script-project-development 先完成原有分流；選定的專案或教材涉及 Google Docs 固定版面時，才使用本技能。

執行順序

1. 完整讀取初學者術語規則與固定版面工作流程。
2. 若需求是信封，另讀取信封排版定稿案例；其他文件只借用通用方法，不照抄信封尺寸。
3. 先把參考圖轉成可驗收的位置關係、字體、方向、頁數及長文字條件，再寫程式。
4. 將頁面、欄寬、列高、內距與單頁安全高度集中成版面設定；不同方向使用不同函式與設定。
5. 完成本機純邏輯測試後，由專案開發技能建立本機 commit。若這是對話中第一次提到遠端同步，先說明它是把本機已驗證的程式同步到指定 Apps Script 專案，不等於執行排版函式或建立文件，再稱為「推送到Apps Script(clasp push)」；取得使用者當次確認後才可執行。
6. 遠端測試要讀回可程式判斷的實際 Docs 樣式，最後仍由使用者開啟文件目視確認位置與分頁。
7. 某一版面經使用者目視驗收後標記為基線；之後開發其他方向或變體，不得順便改動基線。

強制原則

• 頁面方向只決定紙張寬高，不等於內容排版完成。
• 一頁固定版面優先使用一個無框線表格作為座標骨架，避免多個相鄰表格在區塊之間自動分頁。
• 不為了方便排版任意合併儲存格；合併會改變索引與欄跨度。只有需求確實需要且測試涵蓋合併後結構時才使用。
• Google Docs 沒有原生中文直書。需要直排中文時，使用窄欄自然折行；不得在每個字後插入手動換行。
• 重寫文件時明確設定字體大小，並清除不需要的粗體與斜體，不能依賴繼承格式。
• 儲存格含多行文字時，以 TableCell.editAsText() 對整格文字套用字體，再逐一處理每個段落的對齊、段前、段後與行距；不得只修改第一個段落。
• 不可拆文字要配置足夠欄寬，必要時使用不可斷行字元；不要期待一般連字號一定留在同一行。
• 列高是最小高度，不可把它當成最終實際頁數。尺寸測試只能當預警，不能取代打開文件目視驗收。
• 字體屬於驗收條件時，要從產出的 Google Docs 逐字讀回 getFontSize(offset)；只檢查原始碼中的 setFontSize() 不算通過。
• 每筆資料一頁時，使用明確分頁並測試長資料；使用者必須目視確認沒有多頁、溢出、遮蔽或跑位。
• 目視驗收時只要要求使用者開啟、切換或操作任何網頁，就必須在同一則指示中提供已核對且可點擊的目標連結；尚未取得或無法核對連結時，先取得並核對，不要求使用者自行尋找文件或頁面。
• 面向使用者的技術術語先用白話解釋用途，再使用「中文名稱(English)」；固定稱為「紀錄檔(Log)」，不得只使用英文術語或縮寫。
• 紀錄檔(Log)不輸出姓名、完整地址或文件 ID 等不必要資訊。

完成標準

只有同時符合以下條件，固定版面才可定稿：

• 參考圖的位置關係與字體需求已明確記錄。
• 不同方向或變體使用分離的排版函式與尺寸設定。
• 本機尺寸、文字轉換、長資料及結構測試通過。
• 遠端實際文件的必要文字樣式已讀回驗證。
• 使用者已開啟 Google Docs，確認方向、位置、字體、分頁與長文字。
• 已驗收版面已記為不可任意改動的基線。