# 可編輯 Word 範本 / Editable Word templates

> 使用範圍 / Availability: 本指南描述已實作的操作；實際可用功能以產品頁的模組狀態及校方設定為準。文件不代表已通過學校上線驗收。A guide is not a deployment approval; check the current module status and school configuration.

## 校長及課程統籌

1. 開啟「Word 範本」，下載起始 DOCX 或已儲存版本。用 Word 修改版面、字體、文字及學校自有校徽。
2. 保留必要標記：`{{school_name}}`、`{{child_name}}`、`{{class_name}}`、`{{period}}`、`{{assessment_table}}`。評估表格標記須獨佔一段，亦可用下方的指定排序標記取代；其餘支援標記見頁面的完整清單。
3. 校徽可取代 `{{school_logo}}` 段落，使用內嵌 PNG／JPEG。不要加入巨集、外部圖片連結、嵌入程式或未知標記。
4. 學校部署上載 DOCX 建立新版本，限 10 MB，亦受校方儲存配額限制。驗證失敗不會覆蓋舊版本；修正檔案後重試。
5. 產生中文、英文及雙語的虛構測試報告，逐頁核對字體、行高、表格跨頁、校徽及簽署欄。範本轉換在學校伺服器執行。若轉換失敗，工作及 PDF 會明確標示 HTML 後備版式，不能當作原 Word 排版已通過驗收。

公開示範不接受範本上載，可下載及查看內置原創範本。新版範本不會改寫舊報告的快照。教師輸入文字不會因選英文範本而自動翻譯。範本不應嵌入真實幼兒紀錄；校徽、字體及圖片的使用權由學校確認。

## 在 Word 指定評估項目次序

在「設定評估框架」的學習項目下，複製唯讀的「Word 範本項目代碼」。更改項目名稱不會改變代碼。在 Word 將獨立一段的 `{{assessment_table}}` 改成：

```text
{{assessment_table:order=my_world_physical,my_world_language}}
```

這兩個代碼是內置示範框架的例子；校本範本須使用所選框架的實際代碼。上述例子先列身體活動，再列語言項目。沒有列出的已啟用項目會全部保留，按框架原有次序接在後面，不會因未列出而刪除。全年報告仍先列第一學期、再列第二學期，指定次序分別在每個學期內套用；同一項目兩學期的觀察紀錄不會合併。若某項目只在其中一個學期存在，只會在該學期排序。

可列 1–250 個不重複代碼，使用半形逗號分隔且不加空格。每個代碼長 1–60 字元，以小寫英文字母開頭，其餘只可用小寫英文字母、數字、底線或連字號；不能使用顯示名稱、公式、條件式或其他欄位。Word 將標記分成不同字型的文字片段仍可辨認，但整個標記須獨佔一段。原有 `{{assessment_table}}` 繼續沿用框架次序。

上載時驗證格式；產生報告時按該份報告的快照核對項目代碼。不存在或在所有選定學期都停用的代碼會令報告工作失敗，不會默默改回原次序或 HTML 後備版式。請修正範本或選用適合該框架的版本，再重新產生。排序不會加入 SEN／非華語支援的受限備註，也不會修改框架或已保存的觀察。

## English quick guide

Managers download a DOCX, edit it in Word and retain the required markers above. The assessment-table marker must occupy its own paragraph. Use embedded, licensed PNG/JPEG artwork; macros, external links and unknown markers are rejected. Upload creates a validated version on an enabled school deployment. Test Chinese, English and bilingual outputs before use. A failed Word conversion is clearly identified as HTML fallback. The public demo blocks template uploads; existing report snapshots keep their original template version.


### Set the item order in Word

Copy each read-only **Word template item code** from the learning items in **Configure framework**. Replace the standalone `{{assessment_table}}` paragraph with the ordered example above, using codes from your actual selected framework. Codes stay the same when an item label is renamed.

The listed items appear first in that order. Every unlisted enabled item remains afterward in its original framework order. Annual reports preserve Term 1 followed by Term 2 and apply the order separately within each term; observations for the same item in two terms are never merged. A key present in only one term is reordered only there. The original plain marker remains fully supported.

Use 1–250 unique codes separated by ASCII commas without spaces. Each code is 1–60 characters, beginning with a lowercase ASCII letter and continuing with lowercase letters, digits, underscores or hyphens. Display labels, expressions and arbitrary fields are not accepted. The marker must occupy its own paragraph; Word may split its text across formatting runs.

Upload checks the syntax. Report generation checks codes against the selected report snapshot. An unknown key, or a key disabled in every selected term, fails the report job before Word conversion or HTML fallback. Correct the template and retry; it never silently ignores the requested order. Ordering does not include restricted SEN/NCS notes or change the framework, observations or previous report snapshots.