Skip to contents

Document Sizing

Source: vignettes/document_sizing.Rmd
document_sizing.Rmd

Document-level sizing can be customized via the geometry argument. This argument accepts a named list of options that are used by the underlying geometry latex package.

Default sizing options

The default for the geometry package is geom_set(), which includes the following settings:

geom_set()
#> $paperheight
#> [1] "8.5in"
#> 
#> $paperwidth
#> [1] "11in"
#> 
#> $left
#> [1] "1in"
#> 
#> $right
#> [1] "1in"
#> 
#> $top
#> [1] "1.25in"
#> 
#> $bottom
#> [1] "1.25in"
#> 
#> $headsep
#> [1] "10pt"
#> 
#> $includehead
#> [1] TRUE
#> 
#> $includefoot
#> [1] TRUE
#> 
#> $headheight
#> NULL
#> 
#> $footskip
#> NULL

Users can optionally override any defaults by passing new values as such:

geom_set(top = "0.5in", bottom = "0.5in")
#> $paperheight
#> [1] "8.5in"
#> 
#> $paperwidth
#> [1] "11in"
#> 
#> $left
#> [1] "1in"
#> 
#> $right
#> [1] "1in"
#> 
#> $headsep
#> [1] "10pt"
#> 
#> $includehead
#> [1] TRUE
#> 
#> $includefoot
#> [1] TRUE
#> 
#> $headheight
#> NULL
#> 
#> $footskip
#> NULL
#> 
#> $top
#> [1] "0.5in"
#> 
#> $bottom
#> [1] "0.5in"

For values set to NULL, {docorator} will perform automatic size calculations. These can be overridden by hardcoded size values.

geom_set(headheight = "20pt")
#> $paperheight
#> [1] "8.5in"
#> 
#> $paperwidth
#> [1] "11in"
#> 
#> $left
#> [1] "1in"
#> 
#> $right
#> [1] "1in"
#> 
#> $top
#> [1] "1.25in"
#> 
#> $bottom
#> [1] "1.25in"
#> 
#> $headsep
#> [1] "10pt"
#> 
#> $includehead
#> [1] TRUE
#> 
#> $includefoot
#> [1] TRUE
#> 
#> $footskip
#> NULL
#> 
#> $headheight
#> [1] "20pt"

Advanced use

Advanced users can pass additional geometry settings/values that are not covered by the defaults. These additional settings will be appended to the default list. Reference the geometry documentation for more information: https://texdoc.org/serve/geometry.pdf/0.