# ECT* Workshop 2025 — "Few-Body Systems and Universality"

Source for the combined proceedings, `ectWS_report_FBsys_combined.pdf`
(67 pages, 366 references).

## Build

```sh
./build.sh
```

That runs `merge_bibs.py`, then `pdflatex → bibtex → pdflatex → pdflatex`, and
reports the error/warning counts. A clean build takes a few seconds and should
end with all five counters at zero.

```sh
./build.sh clean       # remove build artifacts, keep the PDF
./build.sh distclean   # remove build artifacts and the PDF
```

## Requirements

- **TeX Live 2023 or newer**, full installation. The document loads 94 packages;
  `texlive-full` (Debian/Ubuntu), `texlive-scheme-full` (Fedora) or MacTeX all
  cover it. A minimal install will not — among the less common requirements are
  `physics`, `braket`, `bbm`, `dsfont`, `isotope`, `yfonts`, `leftidx`,
  `slashed`, `scalerel`, `stackengine`, `adjustbox`, `soul`, `hyphenat`,
  `gensymb`, `environ`, `suffix` and `cleveref`.
- **python3** (standard library only) for `merge_bibs.py`.
- **ghostscript**, used by `epstopdf` to convert Capitani's two EPS figures.
  This is why the build passes `--shell-escape`.

The Springer class and style files (`svjour3.cls`, `svglov3.clo`, `spphys.bst`)
are bundled here; they are Springer's, licensed for Few-Body Systems
submissions.

## Layout

| | |
|---|---|
| `ectWS_report_FBsys_combined.tex` | master document: preamble, front matter, `\input`s of the 13 contributions |
| `*_body.tex` | the contributions, one file each |
| `merge_bibs.py` | merges the per-contribution `.bib` files into `combined_refs.bib` |
| `combined_refs.bib` | **generated — do not edit**, regenerated on every build |
| `svjour3.cls`, `svglov3.clo`, `spphys.bst` | Springer FBS class and bibliography style |

Figures live beside the contribution they belong to (`capitani/`, `kievsky/`,
`Mai/`, `mitra/`, `Nicholson/`, `Jackura/jackura_extracted/`), plus
`dawid_figure.pdf` and `QCDtoNP.jpg` at the top level.

## Editing the bibliography

Each contribution keeps its own `.bib` file; those are the source of truth. The
14 of them collectively define 565 keys more than once, and feeding them to
bibtex directly produces 135 `Repeated entry` errors. `merge_bibs.py` folds them
into a single `combined_refs.bib`, keeping the **first** definition of each key —
which is exactly how bibtex resolves such a clash, so the rendered bibliography
is unchanged.

So: **edit the per-contribution `.bib` file, then rebuild.** Never edit
`combined_refs.bib`; it is overwritten every time.

Two things worth knowing if you touch the references:

- `spphys.bst` **does not print titles for `@article`** entries. A wrong or
  missing article title is therefore invisible in the PDF. It does print titles
  for `@book`, `@phdthesis`, `@unpublished` and `@misc`.
- `spphys.bst` sentence-cases titles, so anything that must keep its capitals
  needs brace protection: `{Efimov}`, `{EFT}`, `{Lorentz}`, `{$^4$He}`.
  Literal Unicode (Greek letters, narrow no-break spaces) in a title that *does*
  get printed will fail the pdflatex run — use `$\pi$`, not `π`.

## Editing text

`*_body.tex` are the files the master document includes; those are what the PDF
is built from. Some contributions also have a standalone `.tex` in the same
directory, kept for reference — editing one of those does **not** affect the
combined PDF.
