Summary
v0.19 added --page-width / --page-height on gog docs write and gog docs page-layout (closes #629). Setting A4 today requires the explicit numbers:
gog docs write <id> --page-width=595.275pt --page-height=841.89pt --margin-left=36pt --margin-right=36pt --margin-top=36pt --margin-bottom=36pt
Would be more ergonomic to accept named sizes:
gog docs write <id> --page-size=A4
gog docs page-layout <id> --page-size=Letter
Suggested set
Common print sizes the CLI could map to PT:
| Name |
Width (pt) |
Height (pt) |
Notes |
| A4 |
595.275 |
841.890 |
ISO 216 |
| A5 |
419.528 |
595.275 |
ISO 216 |
| Letter |
612 |
792 |
US 8.5×11 in |
| Legal |
612 |
1008 |
US 8.5×14 in |
| Tabloid |
792 |
1224 |
US 11×17 in |
Behaviour: --page-size=<name> sets both width and height in one go; mutually exclusive with --page-width / --page-height (or, if both passed, explicit dims override the named preset).
Why
- Removes the magic-number footgun (
841.890 is easy to mistype)
- Matches how customers actually think about page layouts ("A4" vs "841.89pt")
- Trivial to add — internal lookup table, no API change needed
Workaround
Pass explicit --page-width=595.275pt --page-height=841.89pt until shipped.
Summary
v0.19 added
--page-width/--page-heightongog docs writeandgog docs page-layout(closes #629). Setting A4 today requires the explicit numbers:Would be more ergonomic to accept named sizes:
Suggested set
Common print sizes the CLI could map to PT:
Behaviour:
--page-size=<name>sets both width and height in one go; mutually exclusive with--page-width/--page-height(or, if both passed, explicit dims override the named preset).Why
841.890is easy to mistype)Workaround
Pass explicit
--page-width=595.275pt --page-height=841.89ptuntil shipped.