ppreeper/wkhtmltopdf
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

5. Header and footer support #7

New issue
Closed
opened 2026-05-20 15:30:50 -06:00 by ppreeper · 0 comments
ppreeper commented 2026-05-20 15:30:50 -06:00
Owner
Copy link

Description

Implement --header-html, --footer-html, --header-spacing, and --header-line support via Chrome print templates.

Tasks

  • Read header HTML file from --header-html <file>
  • Read footer HTML file from --footer-html <file>
  • Convert HTML to Chrome header/footer template format
  • --header-spacing → add CSS margin/padding in header template
  • --header-line → inject <hr> or CSS border in header template
  • Pass templates via --print-to-pdf header/footer parameters
  • Handle missing header/footer files with exit code 4

Acceptance Criteria

  • --header-html header.html injects header on every page
  • --footer-html footer.html injects footer on every page
  • --header-spacing 10 adds 10mm gap between header and content
  • --header-line draws separator line under header
  • Chrome page numbers (<span class="pageNumber">) work in templates
  • Missing template file exits with code 4

Notes

  • Chrome header/footer templates use HTML with special classes like pageNumber, totalPages, title, url
  • Relates to PRD #2
## Description Implement `--header-html`, `--footer-html`, `--header-spacing`, and `--header-line` support via Chrome print templates. ## Tasks - [ ] Read header HTML file from `--header-html <file>` - [ ] Read footer HTML file from `--footer-html <file>` - [ ] Convert HTML to Chrome header/footer template format - [ ] `--header-spacing` → add CSS margin/padding in header template - [ ] `--header-line` → inject `<hr>` or CSS border in header template - [ ] Pass templates via `--print-to-pdf` header/footer parameters - [ ] Handle missing header/footer files with exit code 4 ## Acceptance Criteria - `--header-html header.html` injects header on every page - `--footer-html footer.html` injects footer on every page - `--header-spacing 10` adds 10mm gap between header and content - `--header-line` draws separator line under header - Chrome page numbers (`<span class="pageNumber">`) work in templates - Missing template file exits with code 4 ## Notes - Chrome header/footer templates use HTML with special classes like `pageNumber`, `totalPages`, `title`, `url` - Relates to PRD #2
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
No results found.
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ppreeper/wkhtmltopdf#7
No description provided.