製作個人網站
目標
建立或重新設計一個個人網站,作為純靜態檔案:HTML、CSS 和可選的原生 JavaScript。
此技能是在視覺方向確定後的實作步驟。它將主題建議、使用者資料、筆記、範例文章、專案描述或現有的靜態網站資料夾,轉變為一個可運作的個人網站。
核心承諾:
- 無框架。
- 無建置步驟。
- 無套件安裝。
- 無執行時期依賴。
- 直接開啟
index.html進行手動預覽。 - 使用頁面相對路徑的連結和資源,確保直接檔案開啟、本地 HTTP 和靜態主機服務皆可運作。
- 將資料夾部署到靜態主機。
對於自動化的瀏覽器 QA,請透過本地 HTTP 提供靜態資料夾服務,而不是開啟 file:// URL。
合約
輸入:
- 主題方向、使用者資料材料、頁面需求、範例內容或現有靜態資料夾。
- 可選的參考資料,應引導風格,但不需要高保真複製品。
- 期望的輸出資料夾和靜態約束條件。
輸出:
- 一個純靜態網站資料夾,包含 HTML、CSS、可選的原生 JavaScript、本地資源和具代表性的頁面類型。
- 當建立新網站或進行重大重新設計時,會產生
EDITING.md供未來編輯使用。 - 本地預覽說明和驗證摘要。
界限:
- 不要緊密複製特定的目標網站;應使用
copy-website-style。 - 不要匯入大量寫作檔案;應使用
add-blog-posts。 - 不要發布或配置主機服務;應使用
publish-static-site。 - 除非使用者明確要求,否則不要引入框架、套件安裝、後端、CMS、身分驗證或資料庫。
成功閘門:
- 必要的頁面類型存在,且導覽指向真實的相對路徑。
- 網站作為純靜態檔案運作,無需建置步驟。
- 原始碼為 UTF-8 可讀,佔位符清楚標示,且
review-static-site可以通過或僅回報已接受的限制。
如果閘門失敗:
- 在此技能內部修復缺少的頁面類型、路徑、資源、編碼、佔位符或瀏覽器問題。
- 當失敗原因是缺少使用者身分/內容時,使用
personalize-site。 - 修復後再次使用
review-static-site。
簡短流程
對於原創的個人網站工作,請遵循此流程:
- 釐清網站目的、主題方向、可用內容和頁面範圍。
- 在編寫程式碼之前,先決定靜態頁面地圖和佔位符策略。
- 首先建立共享外殼:頁首、導覽、主要佈局、頁尾、全域 CSS 變數和共享互動。
- 實作首頁以及每個被要求或暗示的頁面類型。
- 使用使用者的內容或明確可替換的佔位符;不要虛構詳細的個人身分。
- 新增編輯指南,供未來模型/使用者編輯。
- 使用相對連結和資源驗證直接開啟路徑的相容性。
- 在真實瀏覽器中透過 HTTP 進行本地驗證。
- 在最終交付前,驗證連結、資源、頁面類型和 UTF-8 原始碼可讀性。
使用時機
當使用者有以下情況時,使用此技能:
- 想要一個純 HTML/CSS/JS 的個人網站、部落格、首頁、作品集、研究首頁或靜態網站。
- 要求實作由
search-blog-theme產生的主題方向。 - 想要一個簡單、無框架的網站,易於檢查、編輯和部署。
- 想要重新設計現有靜態網站同時保持無依賴。
- 提供寬鬆的視覺參考,但不需要高保真複製品。
不應使用時機
在以下情況,請勿使用此技能:
- 使用者只想搜尋主題或比較視覺參考。應使用
search-blog-theme。 - 使用者想要緊密複製特定網站的外觀、佈局、動畫或互動感覺。應使用
copy-website-style。 - 使用者想要遷移大量文章、轉換 Obsidian 筆記、修復 frontmatter 或搬移大型內容檔案。應使用
add-blog-posts。 - 使用者只需要部署、DNS、GitHub Pages、Cloudflare Pages、Cloudflare Pages Direct Upload、Netlify 或 Vercel 的協助。應使用
publish-static-site。 - 使用者明確要求框架專案,例如 Next.js、Astro、Hugo、Jekyll、Quartz 或 React。
- 使用者要求後端、資料庫、身分驗證、CMS、評論系統或動態伺服器行為。
輸入
使用使用者提供的任何內容。如果缺少某些細節,請不要阻擋。
有用的輸入包括:
- 主題方向:私人程式碼庫、研究日誌儀表板、數位花園、便當盒作品集、田野筆記本、個人作業系統等。
- 使用者資料:姓名、簡短自傳、角色、地點、社交連結、頭像、履歷、出版物、專案。
- 頁面需求:首頁、關於、部落格、專案、筆記、出版物、聯絡。
- 範例內容:1-3 篇文章、專案描述、Markdown 片段、舊的 HTML 頁面。
- 現有網站資料夾:要保留或重構的當前 HTML/CSS/JS 檔案。
- 寬鬆參考:v0、Figma、GitHub 主題、框架模板、螢幕截圖或氛圍參考。
參考規則
參考資料可能來自任何技術堆疊。將它們視為視覺和結構上的參考,而不是實作選擇,除非使用者明確要求使用該框架。
對於純靜態網站,請依此轉換參考資料:
- React、Next 或 Astro 元件 -> 重複的 HTML 區段加上可重複使用的 CSS 類別。
- Tailwind 工具類別 -> 在
assets/style.css中使用一般 CSS 規則。 - 框架路由 -> 連結的
.html檔案。 - 內容集合或 CMS 資料 -> 靜態 HTML 清單或小型 JSON 檔案。
- 主題配置 -> CSS 自訂屬性。
- 簡單互動 -> 僅在有用時使用原生 JavaScript。
如果使用者想要緊密匹配特定網站,請轉交給 copy-website-style,而不是將其視為寬鬆參考。
預設網站結構
對於新網站,除非使用者另有要求,否則偏好此結構:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
對於現有網站,在實際可行時保留使用者目前的結構。除非能明顯改善所請求的工作,否則不要重新命名或重新組織網站的大部分內容。
頁面期望
僅建立使用者請求所需的頁面。對於完整的個人網站入門套件,請包含:
- 首頁:身分、簡短介紹、主題特定的英雄區域、近期文章、精選專案。
- 關於:自傳、興趣、技能、聯絡方式、社交連結、可選的履歷/出版物。
- 部落格索引:文章清單,包含標題、日期、標籤和摘要。
- 文章頁面:可讀的文章佈局,包含標題、日期、標籤、內容和返回部落格索引的導覽。
- 專案:專案卡片或列,包含描述、技術堆疊、連結和成果。
保持首頁有用。當使用者要求個人網站或部落格時,不要建立行銷登陸頁面。
對於完整的個人網站或部落格入門套件,不要只停留在單一首頁。建立可運作的具代表性頁面類型,即使內容只是佔位符:
- 至少一篇部落格的文章/詳細頁面。
- 當文章、筆記、專案或出版物是網站的一部分時,建立一個清單或歸檔頁面。
- 當首頁連結到身分或背景細節時,建立一個個人資料/關於頁面。
- 任何所選概念暗示的特殊頁面,例如筆記、連結、花園、現在、使用、出版物或實驗。
對於大型的未來內容集合,建立結構和一些具代表性的佔位符條目,而不是虛構完整的檔案庫。
路徑相容性規則
產生的純靜態網站必須在使用者直接開啟 index.html、透過本地 HTTP 提供服務以及部署到常見靜態主機時都能運作。
預設規則:
- 對所有網站本地連結和資源使用頁面相對路徑。
- 從根頁面,將 CSS/JS/圖片連結為
assets/style.css、assets/script.js、assets/images/avatar.png,頁面連結為about.html或posts/example.html。 - 從巢狀頁面(例如
posts/example.html),將共享資源連結為../assets/style.css,根頁面連結為../blog.html或../index.html。 - 除非使用者明確接受僅限伺服器根目錄的行為,否則不要使用根目錄絕對路徑的網站本地路徑,例如
/assets/style.css、/assets/script.js、/posts/example.html、/data/posts.json、/images/foo.png或/。 - 對 CSS
url(...)、favicon、Open Graph 圖片、封面圖片、字型、KaTeX/數學供應商資源、RSS/sitemap 連結和 JavaScript 產生的 URL 應用相同規則。 - 移動或新增頁面時,根據該頁面的資料夾深度重新計算路徑,而不是從根頁面複製連結。
避免僅限伺服器的假設:
- 如果直接開啟預覽是承諾的一部分,請不要依賴
fetch("data/posts.json")或其他本地檔案擷取來進行核心導覽、文章清單或首頁內容。 - 如果重複資料有用,請直接在 HTML 中渲染必要內容,或將資料儲存在使用相對
<script src="assets/script.js">載入的本地 JavaScript 物件中。 - 可選的增強功能可以使用資料檔案,但前提是即使沒有該次擷取,頁面仍然可以正確讀取和導覽。
樣式規則
讓所選的主題引導視覺語言,但保持網站可讀且可維護。
- 將全站樣式放在
assets/style.css中。 - 使用 CSS 自訂屬性來設定顏色、間距、邊框和字型選擇。
- 盡可能使用語意化 HTML:
header、nav、main、article、section、footer。 - 使用響應式佈局規則,讓頁面在行動裝置和桌面上都能運作。
- 如果主題在視覺上強烈,讓文章頁面比首頁更平靜。
- 除非使用者要求特定字型或主題強烈需要,否則偏好系統字型。
- 除非使用者提供或明確可接受,否則不要依賴遠端資源。
- 不要讓裝飾效果阻礙閱讀、導覽或無障礙性。
互動規則
僅在原生 JavaScript 能增加明確價值時使用。
良好的用途:
- 行動導覽切換。
- 主題切換。
- 輕量級標籤或文章篩選。
- 不影響核心閱讀的小型漸進式效果。
避免:
- 重量級動畫框架。
- 除非使用者明確要求,否則避免以 Canvas 為主的裝飾。
- 需要開發伺服器或套件安裝的效果。
- 持續閃爍、強烈故障效果或損害閱讀的滾動效果。
對於動畫主題,請尊重 prefers-reduced-motion。
靜態簡化規則
當寬鬆參考具有複雜或依賴框架的功能時,將其轉換為更簡單的靜態等效項:
- 3D 地球 -> 主題地圖、狀態面板、專案星座或靜態視覺區塊。
- 動畫便當盒網格 -> 帶有微妙懸停狀態的響應式 CSS 網格。
- 終端機模擬器 -> 主題化導覽和日誌風格內容,而不是假命令列,除非有用。
- 知識圖譜 -> 標籤、相關文章、主題索引或手動策劃的連結。
- 動態搜尋 -> 簡單的篩選輸入、靜態標籤頁面,或第一個版本不提供搜尋。
- CMS 驅動的文章 ->
posts/*.html加上data/posts.json。
偏好一個能捕捉使用者所需感覺的乾淨靜態版本,而不是過度建置的參考副本。
現有網站規則
修改現有網站時:
- 在編輯前檢查目前的檔案結構。
- 保留使用者內容和不相關的檔案。
- 將變更範圍限制在所請求的頁面和資源。
- 當現有視覺慣例已經有效時,重複使用它們。
- 除非使用者要求完整重新設計,否則避免取代整個網站。
- 如果網站已經有
style.css或script.js,請小心擴展它們,而不是建立衝突的重複檔案。
內容規則
對於少量內容,直接撰寫靜態 HTML。
對於重複內容,例如文章或專案,請使用以下任一方式:
- 當清單很短時,使用靜態重複 HTML。
- 當能提高可維護性時,使用本地 JavaScript 資料物件加上原生 JavaScript 渲染。
- 僅在該功能允許網站需要本地 HTTP/靜態主機服務,且核心頁面在沒有它時仍能運作的情況下,才使用小型 JSON 檔案。
不要虛構詳細的個人事實。當使用者資料缺失時,清楚使用佔位符。
保持佔位符易於尋找和替換。優先將重複內容儲存在名稱清楚的位置,例如 data/*.json、assets/script.js 中有文件說明的資料區塊,或帶有穩定類別名稱的重複 HTML 區段。
在檔案或 EDITING.md 中清楚標記僅為佔位符的文字、示範文章、範例專案和模擬連結,以便使用者或未來的模型在發布前替換它們。
編輯指南規則
建立新網站或對現有網站進行重大重新設計時,請在輸出資料夾中包含 EDITING.md。
EDITING.md 主要是為未來將修改所產生網站的模型或代理程式而設計。保持簡潔但具體。解釋:
- 資料夾層次結構以及每個檔案/資料夾的用途。
- 網站使用的檔案格式:HTML、CSS、JS、JSON/資料區塊和圖片。
- 頁面地圖:哪個產生的檔案是首頁、關於/個人資料、部落格/清單、文章/詳細、專案、筆記、連結或其他頁面類型。
- 共享佈局區域:頁首、導覽、行動導覽、主要內容、頁尾、側邊欄、覆蓋層或主題控制。
- 每個主要首頁區域在
index.html中的位置,使用附近的 section/class 名稱。 - 每個子頁面模板的位置以及內部連結如何連接到它。
- 重複內容的儲存位置及其預期的物件/標記格式。
- 如何更改網站標題、標語、頭像/標誌、導覽、精選文章、專案清單、連結清單、圖片、顏色和主題變數。
- 哪些內容僅為佔位符,應在發布前替換。
編碼完整性規則
產生的原始檔必須是有效的 UTF-8,並且在原始形式下是人類可讀的,而不僅僅在瀏覽器螢幕截圖中看起來正確。
對於包含中文、日文、韓文、帶重音符號的拉丁文字或其他非 ASCII 內容的頁面或編輯指南:
- 在 HTML 檔案中包含
<meta charset="utf-8">。 - 將檔案寫成 UTF-8 格式。
- 在最終交付前,使用支援 UTF-8 的閱讀器驗證原始碼的可讀性。
…
[翻譯時已截斷]