otty / dotfiles

All tools/pdfjam

pdfjam

A shell-script interface to the "pdfpages" LaTeX package.

Detected by pdfjam | macOS, Linux |github.com

Sync it pdfjam.toml

Sync rules

What travels, what stays, what never leaves

pdfjam in your home directory Every rule on this page, by file

# User defaults for pdfjam, read after any site-wide pdfjam.conf.

# Where this machine's TeX installation lives.

latex=/usr/local/texlive/2024/bin/universal-darwin/pdflatexmachine-local

pdflatex=/usr/local/texlive/2024/bin/universal-darwin/pdflatexmachine-local

pdfinfo=/opt/homebrew/bin/pdfinfomachine-local

iconv=/usr/bin/iconvmachine-local

builddir=/Users/octocat/tmp/pdfjammachine-local

# Output preferences.

paper=a4paper

…

Each machine keeps its own copy of these.

latex=pdflatex=pdfinfo=iconv=builddir=

Each machine keeps its own copy of these.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/pdfjam.tomlThe file this page is generated from

id = "pdfjam"

name = "pdfjam"

homepage = "https://github.com/pdfjam/pdfjam"

description = "A shell-script interface to the \"pdfpages\" LaTeX package."

# The script's own header line, verbatim.

detect = ["pdfjam"]

platforms = ["macos", "linux"]

# pdfjam(1), Configuration Files: the settings built into the script "are

# over-ridden by any that are found at a site-wide configuration file (at

# /etc/pdfjam.conf, /usr/share/etc/pdfjam.conf, /usr/local/share/pdfjam.conf,

# or /usr/local/etc/pdfjam.conf), which in turn are over-ridden by any that are

# found in a user-defaults file at ~/.pdfjam.conf."

# The script itself adds a second user location above that one:

# configpath="$configpath:${XDG_CONFIG_HOME:-$HOME/.config}"

# configFiles=$(printf "%s" "$configpath" |

# sed 's/:/\/pdfjam.conf:/g; s/$/\/pdfjam.conf/')

# configFiles="${configFiles}:$HOME/.pdfjam.conf"

# so $XDG_CONFIG_HOME/pdfjam.conf — the file sits directly in the config

# directory, not in a pdfjam/ subdirectory — is read as well, and it reads the

# variable, hence [configHome]. Both spellings are listed; a consumer skips the

# one that is absent.

paths = [

"~/.pdfjam.conf",

"[configHome]/pdfjam.conf",

]

exclude = []

secret = []

# Read once per invocation, by a script that then exits.

side_effect = false

# The script's Defaults block lists what a conf file may set: paper, suffix,

# keepinfo, landscape, twoside, tidy, runs, builddir, enc, preamble — and the

# four it fills in by locating programs on this machine,

# latex=$(command -v pdflatex)

# pdfinfo=$(command -v pdfinfo)

# iconv=$(command -v iconv)

# plus the legacy spelling it still honours, `if [ -n "${pdflatex:-}" ]; then

# latex="$pdflatex"; fi`. Setting any of those in a conf file pins an absolute

# path to a binary in this machine's TeX installation, which the next machine

# will not have; builddir names a scratch directory on this disk. Everything

# else in the file is a preference about the output.

[[machine_lines]]

file = ["~/.pdfjam.conf", "[configHome]/pdfjam.conf"]

match = { prefix = ["latex=", "pdflatex=", "pdfinfo=", "iconv=", "builddir="] }

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/pdfjam. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits latex= and pdflatex= for you — that part is Otty’s own sync, or a template you write by hand.