生成網站
概述
使用此技能來重現一個謹慎的 CV 轉網站工作流程。關鍵原則是先建立可審閱的原始材料,再產生頁面:首先將 CV 提取為 Markdown,接著決定哪些內容公開,最後根據結構化內容建立網站。
工作流程
1. 檢查工作區
在編輯前檢查目前的專案檔案:
- 尋找工作流程/狀態檔案,例如
WEBSITE_WORKFLOW.md、PROJECT_STATUS.md或類似檔案。 - 尋找 CV/個人檔案來源檔案:通常是
.pdf、.tex、.docx,或純文字/Markdown CV。 - 檢查網站是否已存在:
package.json、astro.config.*、src/、public/、dist/。 - 在必要時使用
git status --short快速檢查 Git 狀態。
不要假設專案是空白的。
2. 讀取與檢查 CV
如果來源是 PDF:
- 使用 PDF 技能。
- 使用
pdfplumber或其他可靠的 PDF 文字工具提取文字。 - 盡可能將頁面轉換為圖片並進行視覺檢查,以避免誤判版面與章節邊界。
- PDF 文字提取可能會有間距/圖示偽影;請在結構化輸出中手動清理。
如果來源是 LaTeX:
- 直接讀取
.tex原始檔。 - 將章節指令、巨集與列表視為結構。
- 除非使用者要求重新產生 PDF,否則不需在本機編譯 LaTeX。
如果來源是 .docx:
- 使用文件技能提取結構與內容。
3. 提取為可審閱的 Markdown
在建立網站頁面之前,先建立 Markdown 原始檔案。建議路徑:
content/cv_extracted.md
包含結構化章節,例如:
- 身份
- 公開聯絡資訊
- 私人或隱藏聯絡資訊/詳細資料
- 個人簡介
- 語言能力
- 技術專長
- 專業技能
- 工作經歷
- 教育背景
- 著作
- 專案
- 每個專案的網站呈現潛力
保持此檔案的事實性。它是原始素材,而非最終的行銷文案。
4. 詢問或確認公開/隱私決策
在將個人詳細資料放到公開網站之前,請確認:
- 公開電子郵件
- 是否顯示電話號碼
- 是否顯示出生日期
- 是否顯示完整地址
- 是否顯示居住地/簽證/駕照詳細資料
- 哪些連結是公開或隱藏的:GitHub、LinkedIn、Google Scholar、ORCID、ResearchGate 等
- 偏好的受眾:業界、學術、混合、客戶、招募人員、合作者
- 視覺偏好:極簡、學術、富表達的技術作品集等
預設隱私立場:
- 隱藏出生日期、電話號碼、完整地址、居留許可、駕照及類似敏感詳細資料,除非使用者明確要求公開。
- 偏好公開電子郵件、城市/國家及選定的專業連結。
5. 草擬網站結構
在進行搭建或大量編輯頁面之前,先建立結構草稿。建議路徑:
WEBSITE_STRUCTURE_DRAFT.md
包含:
- 設計方向
- 目標受眾
- 導覽列
- 頁面列表
- 頁面用途
- 每個頁面的建議內容
- 待解決問題或決策
- 技術建議
一個良好的初始結構:
- 首頁
- 關於我
- CV
- 專案
- 聯絡方式
對於研究型個人檔案,保留未來加入學術網頁呈現頁面的空間。
6. 搭建網站
對於內容豐富的個人網站,預設使用 Astro,除非使用者要求其他技術棧。
建議的結構:
src/
pages/
index.astro
about.astro
cv.astro
projects.astro
contact.astro
content/
profile.ts
projects.ts
layouts/
BaseLayout.astro
styles/
global.css
public/
從結構化原始檔案建立網站內容,而不是將 CV 文字四處寫死在頁面中。
建議的內容檔案:
src/content/profile.ts:用於身份、個人簡介、專業領域、經歷、教育、著作。src/content/projects.ts:用於專案條目及後續呈現備註。
將公開資產複製到 public/:
- CV PDF(如果使用者想要可下載的 CV)。
- 頭像圖片(如果可用且已批准)。
- 之後的專案圖片或圖表。
7. 設計第一版
對於第一個個人網站:
- 讓第一頁呈現實際的身份/個人簡介,而不是行銷登陸頁面。
- 盡可能使用真實的視覺資產。
- 保持聯絡資訊具隱私意識。
- 建立可快速瀏覽但未來可擴充的頁面。
- 針對業界受眾,強調工程實用性、研發工作流程、技術深度與可轉移能力。
- 針對學術受眾,強調研究問題、方法、著作與呈現流程。
避免過度設計第一版。為未來的專案呈現頁面保留明確的空間。
8. 在本機進行驗證
執行:
npm.cmd install
npm.cmd run build
npm.cmd run dev
在 Windows/PowerShell 上,如果 npm 因指令碼執行原則被封鎖,建議使用 npm.cmd。
如果 Astro 遙測嘗試寫入工作區之外,請在 package.json 中設定指令碼,例如:
"dev": "set ASTRO_TELEMETRY_DISABLED=1&& astro dev",
"build": "set ASTRO_TELEMETRY_DISABLED=1&& astro build",
"preview": "set ASTRO_TELEMETRY_DISABLED=1&& astro preview"
驗證:
- 建置成功。
- 本機路由回傳 200。
- 公開資產載入正常。
- 沒有意外顯示敏感詳細資料。
- 在可行時進行瀏覽器視覺品質檢查,或由使用者手動審閱。
9. 更新狀態與 Readme 檔案
如果專案有使用狀態/儀表板檔案,請更新它,例如:
PROJECT_STATUS.md
有用的輔助檔案:
readme_website.txt:如何編輯、預覽、建置與提交網站。readme_git.txt:Git 設定與常用指令。WEBSITE_WORKFLOW.md:長期工作流程。
保持狀態簡潔。除非使用者要求,否則不要加入雜亂的 Git 詳細資料。
輸出期望
在第一個迭代結束時,專案應包含:
- 提取出的 CV 原始 Markdown。
- 網站結構草稿。
- 一個可運作的 Astro 網站。
- 內容與頁面/佈局程式碼分離。
- 成功的建置。
- 本機預覽 URL。
- 關於待辦事項的明確備註。