# 炫酷简历定制

**Repository Path**: myprogit/cool-resume-customization

## Basic Information

- **Project Name**: 炫酷简历定制
- **Description**: 用BOSS的，还要会员什么的，简历模板还固定，开发一个高度可定制化的简历制作工具吧，你能想到什么就变成什么简历，这就是终极目标。祝大家都有个好工作，不用天天用这个工具。 
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 炫酷简历定制

#### 介绍

用BOSS的，还要会员什么的，简历模板还固定，开发一个高度可定制化的简历制作工具吧，你能想到什么就变成什么简历，这就是终极目标。祝大家都有个好工作，不用天天用这个工具。

#### 软件架构

目前是一个**本地静态简历模板 + Python 辅助脚本**的轻量项目，主要包含：

- `AK-前端开发工程师-简历.html`：核心简历页面，直接用浏览器打开即可预览和修改样式。
- `assets/`：头像、证书、项目截图等静态资源。
- `export_resume_pdf.py`：将 HTML 简历导出为长图，再转换成 PDF 的 Python 脚本。
- `requirements.txt`：Python 依赖列表（Playwright + img2pdf 等）。

#### 环境依赖

- **操作系统**：macOS / Linux / Windows（均可，只要能装 Python 和浏览器）
- **Python**：建议 Python 3.10+（当前开发环境为 3.12）
- **依赖包**（在 `requirements.txt` 中声明）：
  - `playwright`：用无头浏览器渲染 HTML，并截图生成长图
  - `img2pdf`：把 PNG 长图无损转换为 PDF
- **浏览器内核**：首次运行会通过 `playwright install chromium` 自动下载 Chromium 内核

#### 安装步骤

1. 克隆仓库
   ```bash
   git clone https://gitee.com/myprogit/cool-resume-customization.git
   cd cool-resume-customization
   ```
2. 创建并激活虚拟环境（推荐）
   ```bash
   python3 -m venv .venv
   # macOS / Linux
   source .venv/bin/activate
   # Windows（PowerShell）
   # .venv\Scripts\Activate.ps1
   ```
3. 安装 Python 依赖
   ```bash
   pip install -r requirements.txt
   ```
4. 安装 Playwright 浏览器内核（只需一次）
   ```bash
   playwright install chromium
   ```

#### 使用说明

1. **本地预览 / 修改简历**
   - 直接双击或用浏览器打开 `AK-前端开发工程师-简历.html`
   - 按需修改 HTML / CSS、替换 `assets/` 下的头像、证书、项目截图等资源

2. **切换到项目自带 Python 虚拟环境**
   - 进入项目根目录（路径中有空格，注意加引号）：
     ```bash
     cd "/Users/你的用户名/生活/个人/简历"
     ```
     将 `你的用户名` 替换为当前系统用户名。
   - 激活虚拟环境（按实际目录名二选一）：
     ```bash
     # 如果项目里是 .venv 目录
     source .venv/bin/activate

     # 如果项目里是 venv 目录
     # source venv/bin/activate
     ```
   - 可选：确认当前使用的是虚拟环境中的 Python：
     ```bash
     which python
     ```
     输出路径中应包含项目目录和 `.venv` / `venv`，而不是 `/usr/local/bin/python`。

3. **一键导出长图 + PDF**
   - 确保虚拟环境已激活，当前目录在项目根目录
   - 执行：
     ```bash
     python export_resume_pdf.py
     ```
   - 脚本会自动生成 / 覆盖：
     - `AK-前端开发工程师-简历.png`：完整页面的长图
     - `AK-前端开发工程师-简历.pdf`：由长图转换得到的 PDF

4. **常见问题**
   - **依赖安装失败**：优先检查 Python 版本、网络环境（Playwright 下载浏览器内核需要访问官方 CDN）。
   - **截图内容有改动但 PDF 没更新**：先删除旧的 PNG/PDF，再重新运行 `python export_resume_pdf.py`。
   - **页面样式在 PDF 中略有缩放差异**：可以在 `export_resume_pdf.py` 中调整截图视口宽度或后续 PDF 处理逻辑（见原理说明）。

#### 在线预览（Gitee Pages 部署）

如果你想让这份 HTML 简历可以在浏览器里直接在线访问，而不仅仅是本地打开，可以使用 Gitee Pages 部署：

1. **Fork 或克隆本仓库到自己的 Gitee 账号**
   - 访问本项目仓库首页，点击 `Fork` 到自己的命名空间，或直接推送本地代码到你自己的 Gitee 仓库。

2. **启用 Gitee Pages 服务**
   - 打开你自己的该仓库页面。
   - 顶部导航进入：`服务` → `Gitee Pages`（有时在「代码托管服务」里）。
   - 选择要发布的分支（通常是 `master` 或 `main`），部署目录保持为 `/`（仓库根目录）。
   - 点击「启动」或「更新」Gitee Pages。

3. **访问在线简历页面**
   - Gitee 会生成一个访问地址，大致形式为：
     ```text
     https://你的用户名.gitee.io/你的仓库名/
     ```
   - 进入该地址后，直接访问 `AK-前端开发工程师-简历.html` 即可预览在线简历。

4. **注意事项**
   - Gitee Pages 只托管静态文件（HTML/CSS/JS/图片等），**不会执行 Python 脚本**。
   - `export_resume_pdf.py` 仍然需要在本地虚拟环境中运行，用来生成 PNG 和 PDF 文件。
   - 如果你对简历样式做了修改，记得把最新的 HTML 和 `assets/` 提交到 Gitee 仓库，并重新触发 Gitee Pages 更新。

#### 实现原理（简要）

- **1）浏览器渲染 + 全页面截图**
  - 使用 Playwright 启动无头 Chromium：
    - 以指定视口尺寸打开本地 HTML 文件（`page.goto(html_path.as_uri())`）
    - 等待页面加载完成后，调用 `page.screenshot(full_page=True)` 截取整页长图
  - 好处：
    - 截图结果与浏览器实际渲染效果高度一致（包括动画结束后的最终状态、字体、渐变、阴影等）
    - 不受 PDF 打印分页规则影响，避免「同一个区块被拆成多页」的问题

- **2）长图转 PDF**
  - 使用 `img2pdf` 读取生成的 PNG 长图，直接按照图片像素比例编码为单页 PDF：
    - 不重新排版，只是换了一种容器格式（PNG → PDF）
    - 保证布局、颜色、字体效果与长图完全一致

- **整体设计理念**
  - **编辑体验**：以 HTML/CSS 为主，前端工程师可以随心所欲设计「炫酷简历」。
  - **输出体验**：通过「浏览器截图 → PDF」绕过传统 HTML→PDF 的分页/排版坑，让视觉设计 100% 落地。