文檔頁面技能
在單一 HTML 檔案中製作一份三欄文檔頁面。
工作流程
- 讀取當前的 DESIGN.md(已注入在上方)。使用正文類型的權杖(token)來處理散文;使用等寬權杖(mono token)處理程式碼;遵守行高和最大寬度規則。
- 從簡報中挑選一個主題 — 頁面應看起來像真正的文檔,而非通用線框。使用具體的 API 名稱、指令範例、合理的參數。
- 佈局三個區域,以內聯軸方式表達,讓佈局在
dir="rtl"下能正確翻轉:- 內聯起始導航(240–280px,固定):分組連結列表,當前頁面以粗體顯示並帶有內聯起始邊緣的強調色條。3–5 組,每組包含 4–8 個連結。
- 文章主體(最大寬度 ~720px,居中於中間欄):H1 標題、引導段落、H2 區塊、程式碼區塊、提示框(注意/警告)、內聯連結、列表。
- 內聯結尾目錄(200–240px,固定):「本頁內容」包含 H2/H3 錨點,當前區塊在使用者滾動時會高亮顯示。
- 撰寫一個單一 HTML 文件:
<!doctype html>到</html>,所有 CSS 內聯在檔案中。- 使用 CSS Grid 實現三欄佈局;側欄使用粘性定位。
- 程式碼區塊:等寬權杖、柔和背景填充、複製按鈕提示(僅視覺效果 — 無需 JavaScript)。
- 每個 H2/H3 都帶有錨點 ID,以便目錄連結正常運作。
- 在導航、文章和目錄上使用
data-od-id。
- 散文:撰寫至少 350 字的可信文檔內容。包含至少一個 shell 指令、一個程式碼片段(5–15 行)、一個提示框、一個表格。
- 自我檢查:
- 正文文字在 DS 行長最佳點(60–75 字元)處換行。
- 程式碼使用 DS 等寬權杖,而非通用的
monospace。 - 強調色使用節制 — 僅用於當前導航項目、連結、一個提示框邊框。不可用於正文。
- 頁面在 1280w 寬度下可讀,在 900w 以下優雅縮小(目錄消失,導航變為頂部抽屜)。
- 在側欄和強調色條上使用邏輯 CSS(
margin-inline-start、border-inline-start、inset-inline-end、text-align: start),使佈局在dir="rtl"下能正確翻轉。
輸出合約
在 <artifact> 標籤之間輸出:
<artifact identifier="docs-slug" type="text/html" title="文檔 — 頁面標題">
<!doctype html>
<html>...</html>
</artifact>
在 artifact 之前寫一句話,之後不寫任何內容。