制作个人网站
目标
创建或重新设计一个个人网站,作为纯静态文件: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、评论系统或动态服务器行为。
输入
使用用户提供的任何内容。如果某些细节缺失,不要阻止流程。
有用的输入包括:
- 主题方向:私人代码档案、研究日志仪表盘、数字花园、Bento 作品集、田野笔记本、个人操作系统等。
- 用户资料:姓名、简短简介、角色、位置、社交链接、头像、简历、出版物、项目。
- 页面需求:首页、关于、博客、项目、笔记、出版物、联系。
- 样本内容: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 中渲染必要的内容,要么将数据存储在本地 JavaScript 对象中,并通过相对
<script src="assets/script.js">加载。 - 可选的增强功能可以仅在页面即使没有该抓取也能正常读取和导航时才使用数据文件。
样式规则
让选定的主题指导视觉语言,但保持网站可读和可维护。
- 将全站样式放在
assets/style.css中。 - 使用 CSS 自定义属性表示颜色、间距、边框和字体选择。
- 尽可能使用语义 HTML:
header、nav、main、article、section、footer。 - 使用响应式布局规则,使页面在移动端和桌面端都能正常工作。
- 如果主题视觉上强烈,使文章页面比首页更平静。
- 除非用户要求特定字体或主题强烈需要,否则优先使用系统字体。
- 不要依赖远程资产,除非用户提供或显然可以接受。
- 不要让装饰效果阻碍阅读、导航或可访问性。
交互规则
仅在能增加明确价值时使用纯 JavaScript。
好的用途:
- 移动导航切换。
- 主题切换。
- 轻量级标签或文章筛选。
- 不影响核心阅读的小型渐进效果。
避免:
- 重型动画框架。
- 大量使用 Canvas 的装饰,除非用户明确要求。
- 需要开发服务器或包安装的效果。
- 持续闪烁、激进闪烁或影响阅读的滚动效果。
对于动画主题,请尊重 prefers-reduced-motion。
静态简化规则
当松散参考包含复杂或依赖框架的功能时,将其翻译为更简单的静态等价物:
- 3D 地球 -> 主题地图、状态面板、项目星图或静态视觉块。
- 动画 Bento 网格 -> 响应式 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 名称。 - 每个子页面模板的位置以及内部链接如何连接到它。
- 重复内容的存储位置及其期望的对象/标记格式。
- 如何更改站点标题、标语、头像/Logo、导航、精选文章、项目列表、链接列表、图片、颜色和主题变量。
- 哪些内容是仅占位符的,应在发布前替换。
编码完整性规则
生成的源文件必须是有效的 UTF-8,并且在源形式上人类可读,而不仅仅是在浏览器截图中看起来正确。
对于包含中文、日文、韩文、带重音的拉丁文本或其他非 ASCII 内容的页面或编辑指南:
- 在 HTML 文件中包含
<meta charset="utf-8">。 - 将文件编写为 UTF-8。
- 在最终交付前使用 UTF-8 感知的阅读器验证源可读性。