Communitygithub.com

imswarnil/Personal-Website-Jekyll-Theme

決定此主題中每個條目(文章、專案、影片、課程等)的封面圖片:選擇現有照片、生成新圖片,或保留預設的繪製封面。當有人詢問貼文應使用何種圖片、要求縮圖或封面藝術,或新增集合並想知道其圖片樣貌時使用。

Personal-Website-Jekyll-Theme 是什麼?

此技能專為 Personal-Website-Jekyll-Theme 設計,提供一套嚴謹的規則來決定每種類型條目的封面圖片(`image:`)。它根據集合的性質,明確區分何時該使用實際照片、螢幕截圖、YouTube 縮圖,或保持無圖(使用由集合顏色、圖案和標記自動生成的繪製封面)。核心原則是封面不應包含文字,以免與卡片標題重複,且必須能適應 16:10、2:3、9:16 及 1200×675 等多種裁剪比例。技能詳細說明了每個集合(如 posts、portfolio、videos 等)的最佳做法,並提供生成照片級封面圖片的提示語模板。它也涵蓋了如何為新集合添加一致的標記藝術,透過修改 `mark.html` 和 `tools/thumbs.mjs`,確保內聯 SVG 和檔案型 SVG 相匹配,並執行 `npm run thumbs` 來生成集合的預設藝術。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imswarnil/Personal-Website-Jekyll-Theme/tree/HEAD/.claude/skills/collection-art

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

每個集合的封面應是什麼樣子

此主題中的每個條目都可以設定 image:。如果沒有設定,系統會從該集合中自動繪製一個封面——使用該集合的顏色、圖案和標記。這個預設繪製封面是真實的解答,而非佔位符號,對某些集合來說,這正是正確的選擇。因此,第一個問題不是「用什麼圖片」,而是「到底需不需要圖片」。

適用所有集合的規則

封面不應包含任何文字。 標題已經顯示在卡片下方,使用的是可換行、可重新排列且可選取的真正文字。如果再把標題放進圖片裡,就等於設定了兩次,且大小未經選擇,一旦卡片比作品本身窄,文字就會被裁切。如果封面似乎需要說明文字,那麼這些文字應該放在 description: 中。

封面在卡片中為 16:10,系列海報為 2:3,短影片為 9:16,社交卡片為 1200×675。任何發布的圖片都必須能承受所有這些裁剪,這意味著:主體大致居中,外側六分之一區域內不要有重要內容。

各集合的特定規則

posts — 除非你有一張「與文章本身相關」的照片,否則保持繪製封面。一張筆電的庫存照片比繪製封面更糟糕,因為繪製封面至少誠實地表達了「這是一篇文章」。好的例外情況:你親自拍攝的、與你正在書寫的主題相關的照片,實際產品的螢幕截圖,或你自己製作的圖表。

portfolio — 務必使用真實的螢幕截圖。這是唯一一個使用通用封面即代表失敗的集合:專案條目的重點在於展示你製作的內容。使用 screenshots: 來建立輪播圖,並讓 image: 成為其中最好的一張。請以真實的寬度和真實的內容來拍攝介面——絕對不要使用假文或空白狀態。

videos — 不要設定封面。YouTube 縮圖會從 video_id: 自動取得,且那就是你已經在上傳器中選擇的畫面。設定不同的 image: 會導致卡片與影片不一致。

webseries — 使用 2:3 比例的 poster:,並且值得用心製作:來自該系列的一個靜止畫面,經過調色處理,底部預留空間,讓標題和資訊可以疊在漸層遮罩上。採用直向,因為從錄影帶店時代開始,標題卡就是這個形狀。

episodes — 使用該集節目的靜止畫面,否則就不使用。如果設定了 video_id:,則會像影片一樣從 YouTube 取得。

courses — 保持繪製封面,或使用正在教授內容的畫面(如儀表板、編輯器、樂器)。包含微笑人物與筆電的封面,一看就是庫存照片。

lessons — 不使用圖片。課程存在於課程系列之中;課程系列的主視覺就是其身份識別,每堂課都加圖片只會讓課程列表變得雜亂。

podcast — 保持繪製封面。播客自己的作品應放在集合層級(_config.yml 中的 image:),而不是每集都設定。只有當來賓本身就是吸引人的亮點時,才值得使用來賓照片。

newsletter — 保持繪製封面。一期通訊就是一封信;在它前面放一張圖片會變成雜誌封面,這會讓讀者對這個格式產生錯誤的期待。

snippets 和 prompts — 絕對不要設定封面。這兩個卡片的「藝術」就是它們本身:一個是程式碼視窗,一個是聊天視窗,直接從條目的內容中繪製。如果放上圖片,會變成在你想說明的東西上面再疊一張圖。

travel — 使用你最好的照片。這是另一個圖片本身就是內容的集合。使用橫向拍攝,廣角取景以確保 4:3 的卡片裁剪不會切到主體。文字會疊在底部的漸層遮罩上,所以請保持下方三分之一區域的整潔。

uses — 使用在純色背景上拍攝的乾淨產品照,或使用繪製封面。如果可以的話,自己拍攝:將製造商的渲染圖與你自己的照片放在一起,看起來會像是借用來的。

docs — 不使用圖片。這些行項目會自帶圖示。

如果需要生成封面

請將其視為一張照片來描述,而不是一個概念的插圖:

一張 [橫向/直向] 的 [實際主體] 照片,[光線描述],使用 [鏡頭特性] 拍攝。無文字,無標誌,無人看著鏡頭。構圖保持下方三分之一區域整潔。

然後在 320 像素寬(卡片實際顯示的大小)下檢查,再決定它是否可行。大多數生成的圖片在這種尺寸下會崩壞,一個只有在全尺寸下才能閱讀的封面,只能在簡報中閱讀。

新增一個集合

在 _includes/utility/mark.html 中為它加入一個標記,並在 tools/thumbs.mjs 的 MARKS 中加入相同的繪圖——內聯封面和基於檔案的封面必須匹配,因為一個條目如果之後獲得了真實的 .svg,不應該突然看起來像是屬於另一個網站。使用 24 單位網格上的簡單形狀:在卡片顯示的大小下,細節就只是雜訊。

然後執行 npm run thumbs,這個集合就有了自己的藝術品。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能