文件 / reference
資料模型
網站、機器人與 API 背後的內容檔案：條目、角色視角、技能、文件與標籤。
檔案
| 項目 | 路徑 |
|---|---|
| 經驗條目 | content/corpus/experiences/<slug>.md |
| 教育條目 | content/corpus/education/<slug>.md |
| 社群條目 | content/corpus/community/<slug>.md |
| 專案條目 | content/corpus/projects/<slug>.md |
| 角色視角 | content/corpus/lenses/<slug>.md |
| 機器人技能 | content/corpus/skills/<name>.md |
履歷（listed: false 會隱藏一份） |
content/corpus/resumes/<slug>.md |
| 論點 | content/corpus/arguments/<slug>.md |
| 觀點 | content/corpus/views/<slug>.md |
| 翻譯（AI 協助，可編輯） | content/corpus/i18n/<locale>.json, content/docs/i18n/<locale>.json |
| 站點文案編輯（選單、標題、前言） | content/site/copy.json (over web/lib/content.ts) |
| 個人檔案文件 | content/corpus/profile.md |
| 資歷文件 | content/corpus/credentials.md |
| 能力文件 | content/corpus/capabilities.md |
| 演講與寫作文件 | content/corpus/talks-and-writing.md |
| 思考文件 | content/corpus/thinking.md |
| 翻譯詞彙表 | content/corpus/i18n/glossary.json |
| 文件 | content/docs/{tutorials,how-to,explanation}/<slug>.md |
條目前置資料（frontmatter）
| 欄位 | 規則 |
|---|---|
slug |
kebab-case 識別碼；必須與檔名相同 (content/corpus/ |
kind |
取自 experience, education, community, project 之一 |
title |
正式的職務或專案標題（職稱在所有語言中均維持英文） |
org |
組織名稱 |
orgUrl |
選用的 https URL |
location |
選用 |
start |
YYYY-MM |
end |
YYYY-MM 或 'present' |
period |
選用的顯示標籤，會覆寫 start/end（例如 '2010 — 2011'） |
approx |
選用布林值：日期為約略（僅顯示年份） |
tags |
產業標籤：it, engineering, ai, devrel, web3, business, marketing, consulting, hospitality, community, creative |
lenses |
角色視角（請參見 GET /api/admin/schema → lenses） |
skills |
技能／工具清單 |
metrics |
關鍵成果清單——簡短、客觀、在可知處提供數字 |
summary |
一句話摘要 |
featured |
選用布林值：顯示在首頁 |
timeline |
選用布林值（僅限專案）：同時顯示於職涯時間軸 |
proof |
清單 { type: article|video|code|talk|paper|site, title, url? } —— url 為 https 或已上傳的 /media/… 檔案（例如 PDF） |
image |
選用封面影像：/media/…（使用 admin_upload_media 上傳）或靜態的 /img/… 路徑 |
imageAlt |
設定 image 時必填 |
gallery |
選用的 { src: /media/… image or video, alt, caption? } 清單，顯示於條目頁面 |
body |
使用含有 ## 區段的 Markdown：總覽、Jenks 做了什麼、成就、為何對雇主很重要 |
標籤
it · engineering · ai · devrel · web3 · business · marketing · consulting · hospitality · community · creative
角色視角
head-of-ai— AI 負責人ai-transformation-consultant— AI 轉型engineering-manager— 工程經理solution-architect— 解決方案架構師system-integrator— 系統整合工程師support-engineer— 技術支援工程師ict-specialist— 資通訊專家developer-advocate— 開發者倡導者developer-evangelist— 開發者傳教士digital-marketer— 數位行銷人員hospitality— 餐旅業
語言
英文為來源。CI 會翻譯成 zh, zh-hant, ja, fr, es, eo（AI 協助、雜湊快取，並針對標題與角色名稱使用固定詞彙表）。正式職稱維持英文。
.md本頁內容在 AI 協助下翻譯；官方職稱保留英文。