StableFill can read settings from stablefill.toml. This is useful when a
paper is rebuilt many times with the same template, output path, input
directory, and formatting settings.
Create stablefill.toml in the directory where you run StableFill:
template = "paper_template.tex"
output = "paper_filled.tex"
input_dir = "tables"
no_header = true
Then run:
stablefill
To create this starter layout automatically, run:
stablefill init
This creates a tables/ directory and a minimal stablefill.toml. It leaves
your template file to you.
To check what the configured project would do without writing output, run:
stablefill inspect
Command-line options override config values:
stablefill --annotate -o paper_annotated.tex
StableFill accepts the main CLI option names in TOML form:
template = "paper_template.tex"
output = "paper_filled.tex"
input = ["tables/main.txt", "tables/appendix.txt"]
input_dir = "tables"
filetype = "tex"
no_header = true
annotate = false
remove_annotations = false
ignore_xml = true
silent = false
verbose = false
Formatting settings can be top-level or under [formatting]:
[formatting]
pvals = [0.1, 0.05, 0.01]
stars = ["*", "**", "***"]
nafilters = [".", "", "NA", "nan", "NaN", "None", "Inf", "INF"]
Use --config to load a differently named file:
stablefill --config stablefill-appendix.toml
Use either input or input_dir, not both. If neither is set, StableFill
still looks for a tables directory next to the template.