文件 / how to
新增一則經歷
適用於 Jenks — 建立新的經歷、專案、社群或學歷條目,通過驗證並在所有位置顯示。
檔案放在哪裡
每個條目對應一個 Markdown 檔。資料夾取決於其 kind:
| 類型 | 路徑 |
|---|---|
experience |
content/corpus/experiences/<slug>.md |
project |
content/corpus/projects/<slug>.md |
community |
content/corpus/community/<slug>.md |
education |
content/corpus/education/<slug>.md |
slug 為 kebab-case,且必須與檔名相同。
範本
---
slug: acme-ai-advisor
kind: experience
title: AI Advisor
org: Acme Pty Ltd
orgUrl: https://acme.example
location: Melbourne
start: 2026-11
end: present
tags: [ai, consulting]
lenses: [ai-transformation-consultant, head-of-ai]
skills: [AI strategy, Governance]
metrics:
- One short, factual key result with a number where known
summary: One sentence that says what Jenks did and why it mattered.
featured: false
proof:
- { type: article, title: "Case study", url: "https://acme.example/case-study" }
---
## Overview
The organisation, the situation and Jenks's mandate.
## What Jenks did
- Concrete actions, one per bullet.
## Achievements
- Results with numbers where they are known.
## Why it matters to employers
Why this experience is relevant to the roles Jenks is targeting.
欄位規則
start為YYYY-MM;end為YYYY-MM或present。當確切月份未知時使用period(例如 "2010 — 2011"),日期為約略時加上approx: true。tags必須取自:it、engineering、ai、devrel、web3、business、marketing、consulting、hospitality、community、creative。lenses必須取自:head-of-ai、ai-transformation-consultant、engineering-manager、solution-architect、system-integrator、support-engineer、ict-specialist、developer-advocate、developer-evangelist、digital-marketer、hospitality。proof項目需要type(article、video、code、talk、paper、site)與title;url必須為http(s)。- 專案可以設定
timeline: true以同時出現在生涯時間軸中。 - 官方職稱請與 LinkedIn 上完全一致。
完整清單見 data model reference 以及
jenks admin schema。
圖片
將照片、影片剪輯或 PDF 上傳至媒體庫(主控台的 Media 分頁,或
jenks admin media upload <file>),然後引用回傳的 /media/… URL:
image: /media/2026/10/acme-workshop-3f9a1c2b7d.webp
imageAlt: Jenks running an AI workshop at Acme
gallery:
- src: /media/2026/10/acme-team-0c1d2e3f4a.webp
alt: The Acme leadership team at the kick-off
當設定 image 時必須提供 imageAlt,且每個 gallery 項目都需要 alt。若對應的 /media/… 檔案不存在,將拒絕儲存。在主控台的視覺化編輯器中,你可以從媒體庫挑選,而無需手動輸入 URL。參見 Upload and use images and files。
發佈
jenks admin validate content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md
jenks admin put content/corpus/experiences/acme-ai-advisor.md acme-ai-advisor.md \
-m "Add Acme AI Advisor" --branch dev
jenks admin deploys
檢查 https://dev.jenksguo.xyz/career/acme-ai-advisor,然後執行 jenks admin promote。
發佈後,該條目會出現在生涯頁面與其專屬頁面、全部七種語言版本、/llms-full.txt 與 /experience.json,以及 Ask Jenks 助理與 MCP 工具的回答中。
.md本頁內容在 AI 協助下翻譯;官方職稱保留英文。