生成网站
概述
使用此技能复现一个从简历到网站的精心工作流。关键原则是在生成页面之前先创建可审阅的源材料:先将简历提取为 Markdown,然后决定哪些内容公开,最后从结构化内容构建网站。
工作流
1. 检查工作空间
在编辑前检查当前项目文件:
- 查找工作流/状态文件,如
WEBSITE_WORKFLOW.md、PROJECT_STATUS.md或类似文件。 - 查找简历/个人资料源文件:通常是
.pdf、.tex、.docx或文本/Markdown 简历。 - 检查网站是否已存在:
package.json、astro.config.*、src/、public/、dist/。 - 在有必要时,使用
git status --short轻量检查 Git 状态。
不要假设项目为空。
2. 读取并检查简历
如果源文件是 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
包括:
- 设计方向
- 目标受众
- 导航
- 页面列表
- 页面用途
- 每个页面的建议内容
- 未解决的问题或决策
- 技术建议
一个好的初始结构:
- 首页
- 关于
- 简历
- 项目
- 联系方式
对于研究背景浓厚的个人资料,为后续的学术网络展示页面留出空间。
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/
从结构化源文件构建网站内容,而不是到处硬编码简历文本。
推荐的内容文件:
src/content/profile.ts:用于身份、个人简介、专业技能、经验、教育背景、出版物。src/content/projects.ts:用于项目条目以及后续的展示说明。
将公共资源复制到 public/:
- 简历 PDF(如果用户希望提供可下载的简历)。
- 头像图片(如果可用且已批准)。
- 项目图片或图表(后续添加)。
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 详细信息。
输出预期
在首次构建完成后,项目应包含:
- 提取的简历源 Markdown 文件。
- 网站结构草案。
- 一个可运行的 Astro 网站。
- 内容与页面/布局代码分离。
- 成功的构建。
- 本地预览 URL。
- 关于待办事项的清晰说明。