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

4. Advanced flag translation (dpi, zoom, viewport, smart-shrinking, media-type) #6

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

Description

Map remaining wkhtmltopdf flags to Chrome arguments.

Tasks

  • --dpi → --device-scale-factor (DPI / 96 as scale factor)
  • --zoom → CSS transform: scale() wrapper or --force-device-scale-factor
  • --viewport-size WIDTHxHEIGHT → --window-size=WIDTH,HEIGHT
  • --disable-smart-shrinking → disable auto-fit-to-page in print settings
  • --print-media-type → ensure Chrome uses print CSS media queries
  • --extra-chromium-args → append raw Chrome flags
  • Warn on stderr for any unmapped flags (unless --quiet)

Acceptance Criteria

  • --dpi 300 → device scale factor = 3.125
  • --zoom 1.5 → content scaled by 1.5x
  • --viewport-size 1920x1080 → --window-size=1920,1080
  • --disable-smart-shrinking → no auto-shrink in PDF output
  • --print-media-type → print CSS applies in output
  • --extra-chromium-args="--disable-extensions" → passed through to Chrome
  • Unmapped flags produce warning on stderr

Notes

  • Relates to PRD #2
## Description Map remaining wkhtmltopdf flags to Chrome arguments. ## Tasks - [ ] `--dpi` → `--device-scale-factor` (DPI / 96 as scale factor) - [ ] `--zoom` → CSS `transform: scale()` wrapper or `--force-device-scale-factor` - [ ] `--viewport-size WIDTHxHEIGHT` → `--window-size=WIDTH,HEIGHT` - [ ] `--disable-smart-shrinking` → disable auto-fit-to-page in print settings - [ ] `--print-media-type` → ensure Chrome uses print CSS media queries - [ ] `--extra-chromium-args` → append raw Chrome flags - [ ] Warn on stderr for any unmapped flags (unless `--quiet`) ## Acceptance Criteria - `--dpi 300` → device scale factor = 3.125 - `--zoom 1.5` → content scaled by 1.5x - `--viewport-size 1920x1080` → `--window-size=1920,1080` - `--disable-smart-shrinking` → no auto-shrink in PDF output - `--print-media-type` → print CSS applies in output - `--extra-chromium-args="--disable-extensions"` → passed through to Chrome - Unmapped flags produce warning on stderr ## Notes - 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#6
No description provided.