Communitygithub.com

imswarnil/个人网站Jekyll主题

为该主题中的条目(文章、项目、影片、剧集、课程、播客、新闻简报、旅行、装备等)决定封面图片:是提供一张照片、生成一张,还是保留绘制好的默认图片。当用户询问某篇文章应该用什么图片、请求缩略图或封面图,或者正在添加一个合集并希望知道其图片应该是什么样子时使用。

个人网站Jekyll主题 是什么?

该技能为使用Jekyll个人网站主题的开发者提供了一套完整的封面图片决策指南。它并非简单地要求“上传一张图片”,而是基于内容类型给出了细致的规则:例如,文章推荐保留绘制封面,除非有与内容直接相关的照片;作品集必须使用真实截图;视频和剧集则自动从YouTube获取缩略图,无需手动设置。技能详细说明了每种合集的封面策略,并强调封面不应包含文字(标题已在卡片中呈现),以及设计时要考虑16:10、2:3、9:16等多种裁剪比例,确保主体居中、下部三分之一保持简洁。对于需要生成的封面,它还提供了具体的撰写提示和验证步骤(在320px宽度下检查效果)。该技能适用于Claude Code、Cursor、Codex等支持自定义技能的AI编程助手,帮助用户避免常见的封面设计错误,如使用与内容无关的库存图片、在封面上重复文字,或忽视响应式裁剪问题。

兼容平台~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: 成为其中最棒的一张。以真实的宽度和真实的内容拍摄界面——绝不要使用 lorem ipsum 占位文本,也绝不要展示空状态。

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 —— 不使用封面。行项目会带有一个图标。

如果你需要生成一张封面

以拍照的方式来构思,而不是把它当作概念插图:

一张[宽幅/竖版]的[实际主体]照片,[光线],使用[镜头特点]拍摄。没有文字,没有标志,没有人看着镜头。构图保持底部三分之一区域整洁。

然后以 320px 宽度检查它——这是卡片实际显示的尺寸——然后再决定它是否合适。大多数生成的图像在这个尺寸下都会失效,一张只有在全尺寸下才好看的封面,只是一张在构思阶段才好看的封面。

添加一个新的合集

在 _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.

相关技能