Files
cv/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md
T
dong.nguyen d6ef0bd93f feat(resume): Phase 1 PDF generation with Playwright
- Add playwright and tsx as devDependencies
- Create scripts/generate-resume.ts (build script)
- Create public/resume-template.html (A4 layout, embedded fonts)
- Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold)
- Update src/data/resume.ts (hardcoded resumeAvailable)
- Update spec-v2.md overview table
- Add spec-v2-resume-playwright.md (Phase 1+2 spec)
- Add spec-v2-resume-puppeteer.md (alternative spec)
- Add pnpm-workspace.yaml (allow esbuild builds)
2026-10-11 00:53:10 +07:00

26 KiB
Raw Blame History

Specification — v2 Resume PDF (Playwright)

Document: spec-v2-resume-playwright.md Version: 0.4.1


Requirement

  • Generate resume.pdf (A4, multi-page, embedded fonts) during build
  • Deployed at /resume.pdf (root of /dist)
  • Download button in Hero CTA and Contact section (already implemented in spec-v2-resume.md)
  • PDF content: Header (with profile photo), Experience, Skills, Projects (all)

Phases

Phase 1: Local Generation (Dev Testing)

Mục tiêu: Developer có thể generate PDF locally để test layout, content, pagination trước khi push lên CI.

Scope:

  • Tạo scripts/generate-resume.ts + public/resume-template.html + fonts
  • Install playwright, tsx as devDependency
  • Manual command: pnpm tsx scripts/generate-resume.ts → dist/resume.pdf
  • KHÔNG thêm vào pnpm build script
  • KHÔNG Gitea workflow changes

Workflow:

git checkout -b feature/resume-pdf
# implement Phase 1
pnpm tsx scripts/generate-resume.ts  # test locally
# verify PDF, iterate
git push && PR

Phase 2: Gitea Workflow Integration

Mục tiêu: PDF tự generate trong CI, deploy cùng site.

Scope:

  • Split deploy.yml thành 3 jobs (build / generate-resume / deploy)
  • CI cache cho Playwright browser
  • Thêm tsx scripts/generate-resume.ts vào build pipeline
  • Artifact management cho PDF

Workflow:

git checkout master  # sau khi Phase 1 merged
# implement Phase 2
# push → CI tự generate + deploy PDF

PDF Structure

Page 1: Header + Start of Experience

┌──────────────────────────────────────────┐
│ [Photo]  Dong Nguyen                     │
│          Senior Software Engineer        │
│          your.email@example.com          │
│          github.com/...                  │
│          linkedin.com/...                │
├──────────────────────────────────────────┤
│ EXPERIENCE                               │
│                                          │
│ Senior Software Engineer                 │
│ Current Company  |  2021 – Present       │
│ Ho Chi Minh City, Vietnam                │
│                                          │
│ • System ownership và architecture...    │
│ • Developed IoT-DWS integration...       │
│ • Led system maintenance...              │
│ • Applied Computer Vision...             │
│ • Scrum Master responsibilities...       │
│                                          │
│ IoT-DWS Integration System               │
│ Context: Tiếp nhận và nhanh chóng...     │
│ Technical: HTTP integration, HMAC...     │
│ Impact: Giải pháp DWS integration...     │
│ Metrics: 16 sortations deployed          │
│ Tech: Java, HTTP, HMAC, RocketMQ, DWS   │
└──────────────────────────────────────────┘

Page 2+: Remaining Content

  • AWB Detection (if fits with IoT-DWS, else new page)
  • System Maintenance (if fits, else new page)
  • Skills section (always starts on new page)
  • Projects section (each project starts on new page)

Section Break Rules

  • Experience section starts on a new page (after header)
  • Skills section starts on a new page
  • Each Project starts on a new page
  • Experience achievements may flow across pages naturally if space permits

Technology

Library

playwright@^1.64.0       # Playwright (Chromium)
tsx@^4.19.0              # TypeScript executor (handles .ts imports in Node)
  • playwright full install (includes browser binary ~100MB)
  • tsx — lightweight TS executor for Node (no install overhead)
  • Installed as devDependency
  • Browser downloaded once, cached in node_modules/.cache/playwright

Build Machine

  • Gitea runner: ubuntu-latest — cần npx playwright install-deps chromium cho system dependencies
  • Local dev: npx playwright install chromium (one-time)

Font Embedding

  • Font: Inter (self-hosted WOFF2) — clean, professional, good Vietnamese support
  • Embed via @font-face with base64-encoded WOFF2 inline in HTML (not relative paths — file:// URLs fail in Playwright PDF)
  • Fallback: system-ui, -apple-system, sans-serif

File Structure

scripts/
  generate-resume.ts       # Main build script (TS, executed via tsx)
public/
  resume-template.html     # HTML template (with {{placeholders}})
  fonts/
    Inter-Regular.woff2
    Inter-Medium.woff2
    Inter-SemiBold.woff2
    Inter-Bold.woff2
  profile-photo.webp

Implementation

1. Font Setup

Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold) from Google Fonts. Place in public/fonts/ directory. Script reads each file, base64-encodes it, and injects @font-face CSS inline into the HTML template.

Commit font files into repo (~50KB total). Do NOT add to .gitignore.

public/fonts/
  Inter-Regular.woff2
  Inter-Medium.woff2
  Inter-SemiBold.woff2
  Inter-Bold.woff2

Script generates this CSS at build time:

@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: 400;
  font-display: swap;
  src: url('data:font/woff2;base64,{{FONT_REGULAR_BASE64}}') format('woff2');
}
@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: 500;
  font-display: swap;
  src: url('data:font/woff2;base64,{{FONT_MEDIUM_BASE64}}') format('woff2');
}
@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: 600;
  font-display: swap;
  src: url('data:font/woff2;base64,{{FONT_SEMIBOLD_BASE64}}') format('woff2');
}
@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: 700;
  font-display: swap;
  src: url('data:font/woff2;base64,{{FONT_BOLD_BASE64}}') format('woff2');
}

2. HTML Template

public/resume-template.html — static template with {{placeholder}} tokens:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Resume - Dong Nguyen</title>
  <style>
    /* Font faces — injected at build time */
    {{FONT_FACES}}

    /* Page layout */
    @page {
      size: A4;
      margin: 20mm 18mm 20mm 18mm;
    }

    /* Reset */
    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }

    body {
      font-family: 'Inter', system-ui, -apple-system, sans-serif;
      font-size: 10pt;
      line-height: 1.5;
      color: #1a1a1a;
    }

    /* Header */
    .header {
      display: flex;
      align-items: center;
      gap: 16px;
      padding-bottom: 12px;
      border-bottom: 2px solid #1a1a1a;
      margin-bottom: 16px;
    }

    .header-photo {
      width: 72px;
      height: 72px;
      border-radius: 50%;
      object-fit: cover;
      flex-shrink: 0;
    }

    .header-info h1 {
      font-size: 18pt;
      font-weight: 700;
      color: #1a1a1a;
    }

    .header-info .title {
      font-size: 11pt;
      font-weight: 500;
      color: #4a4a4a;
      margin-bottom: 4px;
    }

    .header-info .contact {
      font-size: 9pt;
      color: #666;
      line-height: 1.6;
    }

    /* Section — all sections except first get page break */
    .section + .section {
      page-break-before: always;
    }

    .section-title {
      font-size: 12pt;
      font-weight: 700;
      text-transform: uppercase;
      letter-spacing: 0.5pt;
      color: #1a1a1a;
      padding-bottom: 4px;
      border-bottom: 1px solid #ccc;
      margin-bottom: 10px;
    }

    /* Experience */
    .exp-entry {
      margin-bottom: 12px;
    }

    .exp-header {
      display: flex;
      justify-content: space-between;
      align-items: baseline;
      margin-bottom: 2px;
    }

    .exp-title {
      font-weight: 600;
      font-size: 11pt;
      color: #1a1a1a;
    }

    .exp-duration {
      font-size: 9pt;
      color: #666;
      white-space: nowrap;
    }

    .exp-company {
      font-size: 10pt;
      color: #4a4a4a;
      margin-bottom: 2px;
    }

    .exp-location {
      font-size: 9pt;
      color: #888;
      margin-bottom: 4px;
    }

    .exp-responsibilities {
      list-style: disc;
      padding-left: 16px;
      margin-bottom: 6px;
    }

    .exp-responsibilities li {
      font-size: 9.5pt;
      margin-bottom: 2px;
    }

    /* Achievement */
    .achievement {
      margin-left: 12px;
      margin-bottom: 8px;
    }

    .achievement-title {
      font-weight: 600;
      font-size: 10pt;
      color: #1a1a1a;
      margin-bottom: 2px;
    }

    .achievement-context {
      font-size: 9pt;
      color: #4a4a4a;
      margin-bottom: 4px;
      font-style: italic;
    }

    .achievement-technical {
      list-style: disc;
      padding-left: 20px;
      margin-bottom: 4px;
    }

    .achievement-technical li {
      font-size: 9pt;
      color: #4a4a4a;
      margin-bottom: 1px;
    }

    .achievement-tech {
      font-size: 8.5pt;
      color: #666;
    }

    .achievement-tech span {
      display: inline-block;
      background: #f0f0f0;
      padding: 0 4px;
      border-radius: 2px;
      margin-right: 4px;
    }

    .achievement-impact {
      font-size: 9pt;
      color: #4a4a4a;
      margin-top: 2px;
    }

    .achievement-metrics {
      font-size: 9pt;
      color: #4a4a4a;
      margin-top: 1px;
    }

    /* Skills */
    .skills-grid {
      display: grid;
      grid-template-columns: 1fr 1fr;
      gap: 8px 24px;
    }

    .skill-group-title {
      font-weight: 600;
      font-size: 10pt;
      color: #1a1a1a;
      margin-bottom: 2px;
    }

    .skill-list {
      font-size: 9pt;
      color: #4a4a4a;
      line-height: 1.5;
    }

    /* Projects */
    .project {
      margin-bottom: 12px;
    }

    .project-title {
      font-weight: 600;
      font-size: 11pt;
      color: #1a1a1a;
    }

    .project-role {
      font-size: 9pt;
      color: #666;
      margin-bottom: 2px;
    }

    .project-summary {
      font-size: 9.5pt;
      color: #4a4a4a;
      margin-bottom: 4px;
    }

    .project-tech {
      font-size: 8.5pt;
      color: #666;
    }

    .project-tech span {
      display: inline-block;
      background: #f0f0f0;
      padding: 0 4px;
      border-radius: 2px;
      margin-right: 4px;
    }

    .project-metrics {
      font-size: 9pt;
      color: #4a4a4a;
      margin-top: 2px;
    }

    /* Page break helpers */
    .avoid-break { page-break-inside: avoid; }
  </style>
</head>
<body>
  <!-- Header -->
  <div class="header">
    <img class="header-photo" src="data:image/webp;base64,{{PHOTO_BASE64}}" alt="Dong Nguyen" />
    <div class="header-info">
      <h1>{{NAME}}</h1>
      <div class="title">{{TITLE}}</div>
      <div class="contact">
        {{EMAIL}}<br>
        {{GITHUB}}<br>
        {{LINKEDIN}}
      </div>
    </div>
  </div>

  <!-- Experience -->
  <div class="section">
    <div class="section-title">Experience</div>
    {{EXPERIENCE}}
  </div>

  <!-- Skills -->
  <div class="section">
    <div class="section-title">Skills</div>
    <div class="skills-grid">
      {{SKILLS}}
    </div>
  </div>

  <!-- Projects -->
  <div class="section">
    <div class="section-title">Projects</div>
    {{PROJECTS}}
  </div>
</body>
</html>

3. Build Script

scripts/generate-resume.ts — executed via tsx:

import { chromium } from 'playwright';
import { readFileSync, existsSync } from 'node:fs';
import { join, resolve } from 'node:path';

const ROOT = resolve(import.meta.dirname, '..');

// --- Validate required files ---
const requiredFiles = [
  'public/profile-photo.webp',
  'public/fonts/Inter-Regular.woff2',
  'public/fonts/Inter-Medium.woff2',
  'public/fonts/Inter-SemiBold.woff2',
  'public/fonts/Inter-Bold.woff2',
  'public/resume-template.html',
];

for (const file of requiredFiles) {
  if (!existsSync(join(ROOT, file))) {
    console.error(`❌ Missing required file: ${file}`);
    process.exit(1);
  }
}

// --- Load data (tsx handles .ts imports natively) ---
const { profile } = await import(join(ROOT, 'src/data/profile.ts'));
const { experiences } = await import(join(ROOT, 'src/data/experience.ts'));
const { skillGroups } = await import(join(ROOT, 'src/data/skills.ts'));
const { projects } = await import(join(ROOT, 'src/data/projects.ts'));


// --- Read template ---
const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8');

// --- Read and base64-encode assets ---
const photoBase64 = readFileSync(join(ROOT, 'public/profile-photo.webp')).toString('base64');

const fonts: Record<string, string> = {};
for (const [name, weight] of [
  ['REGULAR', 'Inter-Regular.woff2'],
  ['MEDIUM', 'Inter-Medium.woff2'],
  ['SEMIBOLD', 'Inter-SemiBold.woff2'],
  ['BOLD', 'Inter-Bold.woff2'],
] as const) {
  fonts[name] = readFileSync(join(ROOT, 'public/fonts', weight)).toString('base64');
}

// --- Generate font-face CSS ---
const fontFaces = Object.entries(fonts).map(([key, b64]) => {
  const weightMap: Record<string, number> = { REGULAR: 400, MEDIUM: 500, SEMIBOLD: 600, BOLD: 700 };
  return `@font-face {
  font-family: 'Inter';
  font-style: normal;
  font-weight: ${weightMap[key]};
  font-display: swap;
  src: url('data:font/woff2;base64,${b64}') format('woff2');
}`;
}).join('\n');

// --- Render HTML helpers ---
function renderExperience(exps: Awaited<typeof experiences>): string {
  return exps.map(exp => `
    <div class="exp-entry avoid-break">
      <div class="exp-header">
        <span class="exp-title">${exp.title}</span>
        <span class="exp-duration">${exp.duration}</span>
      </div>
      <div class="exp-company">${exp.company}</div>
      ${exp.location ? `<div class="exp-location">${exp.location}</div>` : ''}
      <ul class="exp-responsibilities">
        ${exp.responsibilities.map(r => `<li>${r}</li>`).join('')}
      </ul>
      ${exp.achievements?.map(ach => `
        <div class="achievement avoid-break">
          <div class="achievement-title">${ach.title}</div>
          <div class="achievement-context">${ach.context}</div>
          ${ach.technicalWork?.length ? `
            <ul class="achievement-technical">
              ${ach.technicalWork.map(t => `<li>${t}</li>`).join('')}
            </ul>
          ` : ''}
          <div class="achievement-tech">
            ${ach.technologies.map(t => `<span>${t}</span>`).join('')}
          </div>
          ${ach.impact ? `<div class="achievement-impact">${ach.impact}</div>` : ''}
          ${ach.metrics?.length ? `<div class="achievement-metrics">${ach.metrics.join(', ')}</div>` : ''}
        </div>
      `).join('')}
    </div>
  `).join('');
}

function renderSkills(groups: Awaited<typeof skillGroups>): string {
  return groups.map(group => `
    <div class="avoid-break">
      <div class="skill-group-title">${group.title}</div>
      <div class="skill-list">${group.skills.join(' · ')}</div>
    </div>
  `).join('');
}

function renderProjects(projs: Awaited<typeof projects>): string {
  return projs.map(project => `
    <div class="project avoid-break">
      <div class="project-title">${project.title}</div>
      <div class="project-role">${project.role}</div>
      <div class="project-summary">${project.summary}</div>
      <div class="project-tech">
        ${project.technologies.map(t => `<span>${t}</span>`).join('')}
      </div>
      ${project.metrics?.length ? `<div class="project-metrics">${project.metrics.join(', ')}</div>` : ''}
    </div>
  `).join('');
}

// --- Assemble HTML ---
const html = template
  .replace('{{NAME}}', profile.name)
  .replace('{{TITLE}}', profile.title)
  .replace('{{EMAIL}}', profile.email)
  .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/'))
  .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/'))
  .replace('{{PHOTO_BASE64}}', photoBase64)
  .replace('{{FONT_FACES}}', fontFaces)
  .replace('{{EXPERIENCE}}', renderExperience(experiences))
  .replace('{{SKILLS}}', renderSkills(skillGroups))
  .replace('{{PROJECTS}}', renderProjects(projects));

// --- Generate PDF ---
const browser = await chromium.launch();
const page = await browser.newPage();
await page.setContent(html);  // No waitUntil needed — all resources inline

const outputPath = join(ROOT, 'dist/resume.pdf');
await page.pdf({
  path: outputPath,
  format: 'A4',
  printBackground: true,
  // margin inherited from @page CSS

await browser.close();
console.log(`resume.pdf generated at ${outputPath}`);

4. package.json

Phase 1 (local dev only):

{
  "scripts": {
    "build": "tsc -b && vite build"
  },
  "devDependencies": {
    "playwright": "^1.64.0",
    "tsx": "^4.19.0"
  }
}

Build script không chạy PDF generation. Developer chạy manual:

pnpm tsx scripts/generate-resume.ts

Phase 2 (CI integration):

{
  "scripts": {
    "build": "tsc -b && vite build && tsx scripts/generate-resume.ts"
  }
}

Data Detection

src/data/resume.ts — controls whether download button is visible in UI:

// src/data/resume.ts
export const resumeAvailable = true  // set false when PDF not yet deployed

Phase 1 (dev): Hardcoded boolean. Developer sets false locally until PDF is ready, sets true after deployment to verify the button appears.

Phase 2 (CI): After CI generates and deploys dist/resume.pdf, the button will show because /resume.pdf exists on the server.

⚠️ Do NOT use existsSync — this file is bundled by Vite for the browser. Node.js fs APIs are unavailable in browser runtime.


Acceptance Criteria

Phase 1

  • pnpm tsx scripts/generate-resume.ts produces dist/resume.pdf
  • PDF is A4 size, multi-page with correct pagination
  • Header contains profile photo (circular crop), name, title, contact info
  • Experience section includes all companies, roles, responsibilities, achievements (with technicalWork bullets)
  • Skills section includes all skill groups
  • All projects included (not just featured)
  • Sections do not split across pages (achievements, projects, skill groups use page-break-inside: avoid)
  • Experience section starts on a new page after header
  • Skills section starts on a new page
  • Each project starts on a new page
  • Fonts are embedded (Inter, 4 weights, base64 inline)
  • PDF is readable and well-formatted (no overflow, text not cut off)
  • Works locally on Windows dev machine
  • pnpm build still works (no PDF in build output)
  • Script exits with error if required files are missing

Phase 2

  • pnpm build produces dist/resume.pdf (auto-generated)
  • Works in Gitea CI (ubuntu-latest)
  • CI cache reduces Playwright install to 0s after first run
  • Download button shows in Hero and Contact sections
  • PDF deployed to /resume.pdf (root of /dist)

Tradeoffs

Phase 1

Aspect Detail
Install overhead ~110MB (playwright + tsx)
Manual command pnpm tsx scripts/generate-resume.ts
Build time Not in pnpm build — developer controlled
CSS control Full CSS (same as website)
Font embedding Base64 in HTML, increases HTML size ~50KB
Photo Inline base64 (avoids file:// URL issues)
Platform Works on Windows local, Ubuntu CI

Phase 2

Aspect Detail
CI build time +5-10s (download once cached, render ~2s)
CI first run +60s (download Playwright browser)
CI subsequent +5-10s (cache hit)
Workflow complexity 3 jobs (build / generate-resume / deploy)
Failure isolation PDF error does not block site deploy

Future Enhancements

Phase 2+: Gitea Workflow

Current (deploy.yml — Phase 1):

name: Deploy Static Site

on:
  push:
    branches: [master]

jobs:
  build and deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: pnpm/setup@v3
        with:
          cache: true
          version: ^12.0.0
          runtime: node@24
      - run: pnpm build
      - name: rsync deployments
        uses: burnett01/rsync-deployments@v9
        with:
          debug: true
          switches: -avzr --delete
          path: dist/
          remote_path: /opt/stacks/dong-site/dist/
          remote_host: ${{ secrets.DEPLOY_HOST }}
          remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
          remote_user: ${{ secrets.DEPLOY_USER }}
          remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}

Phase 2 (3 jobs split):

name: Deploy Static Site

on:
  push:
    branches: [master]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: pnpm/setup@v3
        with:
          cache: true
          version: ^12.0.0
          runtime: node@24
      - run: pnpm build  # tsc -b && vite build (không có PDF)
      - uses: actions/upload-artifact@v4
        with:
          name: static-site
          path: dist/
          retention-days: 5

  generate-resume:
    runs-on: ubuntu-latest
    needs: build
    steps:
      - uses: actions/checkout@v7
      - uses: pnpm/setup@v3
        with:
          cache: true
          version: ^12.0.0
          runtime: node@24

      # Cache Playwright browser — download 1 lần, reuse các lần sau
      - name: Cache Playwright browser
        uses: actions/cache@v4
        with:
          path: ~/.cache/ms-playwright
          key: playwright-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }}
          restore-keys: |
            playwright-${{ runner.os }}-

      - run: pnpm install --frozen-lockfile
      - run: npx playwright install chromium
      - run: npx playwright install-deps chromium
      - run: pnpm tsx scripts/generate-resume.ts

      # Upload PDF artifact
      - uses: actions/upload-artifact@v4
        with:
          name: resume-pdf
          path: dist/resume.pdf
          retention-days: 30

  deploy:
    runs-on: ubuntu-latest
    needs: [build, generate-resume]
    steps:
      - uses: actions/download-artifact@v4
        with:
          name: static-site
          path: dist/

      - uses: actions/download-artifact@v4
        with:
          name: resume-pdf
          path: dist/

      - name: rsync deployments
        uses: burnett01/rsync-deployments@v9
        with:
          debug: true
          switches: -avzr --delete
          path: dist/
          remote_path: /opt/stacks/dong-site/dist/
          remote_host: ${{ secrets.DEPLOY_HOST }}
          remote_port: ${{ secrets.DEPLOY_SSH_PORT }}
          remote_user: ${{ secrets.DEPLOY_USER }}
          remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }}

Job dependency graph:

build ──────────────┐
                    ├──→ deploy
generate-resume ────┘

Key decisions:

  • generate-resume depends on build (chỉ cần checkout, không cần artifact)
  • deploy depends on cả 2 jobs — đảm bảo cả site + PDF sẵn sàng
  • Artifact retention: site 5 ngày, PDF 30 ngày
  • Cache key dựa trên pnpm-lock.yaml — invalidate khi dependency thay đổi
  • npx playwright install chromium — install vào ~/.cache/ms-playwright (khác với node_modules/.cache)
  • dist/ từ artifact overwrite lẫn nhau — resume.pdf không conflict với file nào trong site

Migration plan:

  • Phase 1 merged → deploy.yml unchanged
  • Phase 2: replace deploy.yml với 3-job version
  • Update package.json scripts thêm tsx scripts/generate-resume.ts
  • First CI run: +60s (download browser), subsequent: +5-10s (cache hit)
  • Monitor: check dist/ trên server có resume.pdf sau deploy

PDF Metadata

Đặt metadata trong page.pdf() options:

await page.pdf({
  path: outputPath,
  format: 'A4',
  printBackground: true,
  margin: { top: '20mm', right: '18mm', bottom: '20mm', left: '18mm' },
});

Thực tế Playwright PDF không hỗ trợ title/author trực tiếp. Alternative:

  • Inject <meta> tags trong HTML (chỉ hiển thị trong browser print dialog)
  • Dùng pdf-lib sau khi generate để set metadata (thêm dependency)

Recommendation: Bỏ qua metadata — resume PDF không cần metadata chuyên nghiệp.

Version Stamping

Thêm footer "Last updated: YYYY-MM-DD" vào mỗi trang PDF.

Implementation:

  • Script inject footer vào HTML template: {{UPDATED_DATE}}
  • Hoặc dùng JavaScript trong page để inject dynamic date:
await page.evaluate((date: string) => {
  const footer = document.createElement('div');
  footer.className = 'pdf-footer';
  footer.textContent = `Last updated: ${date}`;
  document.body.appendChild(footer);
}, new Date().toISOString().slice(0, 10));

CSS:

.pdf-footer {
  page-break-inside: avoid;
  text-align: center;
  font-size: 8pt;
  color: #999;
  margin-top: 16px;
  padding-top: 8px;
  border-top: 1px solid #eee;
}

Conditional Content

Ẩn contact info nếu dùng placeholder values (trước khi publish thật):

if (profile.email === 'your.email@example.com') {
  console.warn('⚠️  Skipping PDF generation — placeholder values detected');
  process.exit(0);
}

Project Sections

Render ProjectSection[] details trong PDF (hiện chỉ render title/summary/tech/metrics).

Mỗi ProjectSection có type: "text" | "diagram" | "metrics" | "code":

function renderProjectSections(sections: ProjectSection[]): string {
  return sections.map(s => {
    switch (s.type) {
      case 'text':
        return `<div class="project-section-text">${s.content}</div>`;
      case 'diagram':
        return `<div class="project-section-diagram">${s.content}</div>`;
      case 'metrics':
        return `<div class="project-section-metrics">${s.content}</div>`;
      case 'code':
        return `<pre class="project-section-code">${s.content}</pre>`;
    }
  }).join('');
}

Multiple Language Versions (Future)

Hỗ trợ PDF tiếng Anh + tiếng Việt. Hiện tại chỉ English.

Approach:

  • Duplicate template: resume-template-en.html, resume-template-vi.html
  • Script chạy 2 lần, output resume-en.pdf, resume-vi.pdf
  • Data modules xuất cả 2 ngôn ngữ: profile.nameEn, profile.nameVi