Files

T

juanatsap b44f9b9a99 refactor: Rename 'extended' → 'long' + add compact sidebar fonts

BREAKING CHANGE: API parameter renamed from 'extended' to 'long'

## Breaking Change: Terminology Standardization

Renamed 'extended' to 'long' across entire codebase for consistency:

**Backend (Go):**
- internal/handlers/cv.go (7 locations)
  - Migration logic to auto-convert 'extended' → 'long' cookies
  - API validation now rejects 'extended', requires 'long'
  - Toggle state logic updated
- internal/handlers/pdf_test.go (17 occurrences)
  - Test function renamed: TestExportPDF_ExtendedWithSkills → TestExportPDF_LongWithSkills
  - All test cases, parameters, and expected filenames updated
- internal/pdf/generator.go (2 comment updates)

**Frontend:**
- PDF-EXPORT-FEATURE.md (3 occurrences)
- doc/3-API.md (parameter documentation)
- doc/7-CUSTOMIZATION.md (examples updated)
- templates/partials/modals/pdf-modal.html (button text, URLs)
- static/js/main.js (migration logic)
- static/hyperscript/toggles._hs (toggle logic)
- tests/mjs/24-pdf-download-params.test.mjs (test expectations)
- tests/mjs/test-preference-migration.test.mjs (NEW)
- tests/mjs/verify-migration.test.mjs (NEW)

**PDFs Renamed:**
- cv-extended-with_skills-jamr-2025-en.pdf → cv-long-with_skills-jamr-2025-en.pdf
- cv-extended-with_skills-jamr-2025-es.pdf → cv-long-with_skills-jamr-2025-es.pdf

**Migration:** Automatic cookie migration from 'extended' → 'long' for seamless UX

## New Feature: Compact Sidebar Fonts

Reduces page count for short CV with skills from 6 → 5 pages:

**Implementation:**
- Location: internal/pdf/generator.go (lines 154-215)
- Cookie detection: `cookies["cv-length"] == "short"`
- Font reduction: 2-6% (0.94-0.98em) - very subtle
- Only activates for: `length=short` + `version=with_skills`
- Long version: Always uses full-size fonts

**Impact:**
- Page count: 6 pages → 5 pages (16.7% reduction)
- Readability: Maintained - fonts remain professional
- Design philosophy: Subtle, natural content flow

**Testing:**
- New test: TestPDFGenerator_CompactSidebarFonts
- Comprehensive coverage of cookie detection and PDF generation
- Manual verification: 5-page PDF with compact but readable fonts

**Documentation:**
- doc/LONG-PDF-GENERATION.md (NEW, 13 KB)
  - Complete feature documentation
  - Implementation details with code examples
  - Font size breakdown table
  - Testing and troubleshooting guides
  - Compact sidebar fonts section (comprehensive)

**Files Changed:**
- 11 modified (backend + frontend + docs)
- 5 new files (2 PDFs, 1 doc, 2 tests)
- 2 files renamed (PDFs)

**Tests:** All Go tests passing, API validation verified, PDF generation tested

2025-11-20 11:21:43 +00:00

README.md

CV Project Documentation

Complete documentation for the Go + HTMX CV website project.

For Developers

Getting Started

1. Architecture Overview - System design and Go backend architecture
2. Modern Web Techniques - Frontend architecture (HTMX, Hyperscript, CSS) ⭐
3. API Reference - Complete API documentation with endpoints and responses

Technical Implementation

4. Hyperscript Rules - Hyperscript conventions and best practices
5. Zoom Implementation - Custom zoom feature technical details

Deployment & Operations

8. Deployment Guide - Production deployment instructions
9. Security Policies - Security guidelines and vulnerability reporting

For Users & Customizers

6. User Guide - End-user documentation for CV features
7. Customization Guide - How to customize your CV content and styling
10. Privacy Policy - Data handling and privacy information

📖 Documentation Overview

Core Technical Documentation

#	Document	Purpose	Audience
1	ARCHITECTURE.md	Go backend architecture, package structure, design patterns	Backend developers
2	MODERN-WEB-TECHNIQUES.md	HTMX/Hyperscript frontend architecture, component patterns, ADRs	Frontend developers
3	API.md	Complete API reference with all endpoints	API consumers, integrators
4	HYPERSCRIPT-RULES.md	Hyperscript coding conventions	Frontend developers
5	ZOOM_IMPLEMENTATION.md	Zoom feature implementation details	Feature developers

User & Operations Documentation

#	Document	Purpose	Audience
6	USER_GUIDE.md	End-user feature documentation	CV users
7	CUSTOMIZATION.md	Content and style customization	CV customizers
8	DEPLOYMENT.md	Deployment instructions and operations	DevOps, site operators
9	SECURITY.md	Security policies and reporting	Security teams
10	PRIVACY.md	Privacy policy and data handling	Legal, compliance

🏗️ Architecture Quick Reference

Backend: Go (Hono-inspired routing)

Clean package structure (internal/ pattern)
Template caching and rendering
JSON-based CV data model
Middleware: logging, security headers, CORS

Frontend: HTMX + Hyperscript + Vanilla CSS

Hypermedia-driven architecture (minimal JavaScript)
Server-side rendering with HTMX partial updates
Declarative behaviors with Hyperscript
Component-level skeleton loaders
Light/dark/auto color themes

Key Features:

✅ Custom zoom control (25%-175%)
✅ Bilingual support (English/Spanish)
✅ Keyboard shortcuts (L/I/V/?)
✅ Print-optimized CSS
✅ Mobile responsive
✅ Accessibility (WCAG AA compliance)

🎯 Common Tasks

"I want to..."

...understand the system architecture → Start with 1-ARCHITECTURE.md (backend) and 2-MODERN-WEB-TECHNIQUES.md (frontend)

...add a new feature → Read 2-MODERN-WEB-TECHNIQUES.md for frontend patterns, 3-API.md for backend APIs

...customize my CV content → Follow 7-CUSTOMIZATION.md for content and styling changes

...deploy to production → Use 8-DEPLOYMENT.md for step-by-step deployment instructions

...understand HTMX patterns → Check 2-MODERN-WEB-TECHNIQUES.md Section 6 (HTMX Patterns)

...write Hyperscript code → Follow conventions in 4-HYPERSCRIPT-RULES.md

...report a security issue → See 9-SECURITY.md for responsible disclosure process

📦 Archive

Historical documentation (bug fixes, testing reports, implementation notes) is stored in archive/ for reference. These documents are not actively maintained but preserved for historical context.

🔗 External Resources

HTMX Documentation: https://htmx.org/
Hyperscript: https://hyperscript.org/
Go Documentation: https://go.dev/doc/
Playwright Testing: https://playwright.dev/

📝 Documentation Standards

All documentation in this project follows these standards:

Markdown format with GitHub-flavored syntax
Clear structure with table of contents for long documents
Code examples with syntax highlighting
Up-to-date reflecting current implementation
Versioned via Git with meaningful commit messages

Last Updated: 2025-11-18 Documentation Status: ✅ Clean, organized, zero redundancy Total Active Docs: 11 core documents + archive