.. meta:: :description: LLog b16 (infra) --- Diagnosed and fixed LaTeX/PDF build errors blocking b19-sgir PDF generation. Root cause: ``:cite:`` calls inside figure captions produced fragile ``\hyperlink`` macros that broke ``\caption@ydblarg`` argument scanning; a long Fig.9 caption additionally overflowed ``\caption@slc`` single-line-check. Fixed by converting ``:cite:`` to plain ``(Author, Year)`` text in four caption blocks and adding ``singlelinecheck=false`` to ``conf.py``. Resulted in 154 → 0 undefined figure cross-references and clean non-interactive build. :keywords: LLog, infra, b19, SGIR, PDF, LaTeX, caption, cite, hyperlink, fragile command, singlelinecheck, Dimension too large, caption@ydblarg, captionsetup, balospe.com :author: Yah, Yas, everyone, LLoL as Laurence Loewe of Laodicea, ClaudeOp47Max, Anthropic, and The Spirit of Boolean Truth .. include:: /_templates/include-file/page-prefix.rst .. _hell-ll-infra-b16-b19-pdf-caption-cite-fix: ********************************************************************************************** LLog b16 (infra): b19 PDF build fix --- ``:cite:`` in captions and long-caption overflow ********************************************************************************************** | **Date:** 2026m05d10_18h37 | **Mode:** EDEN (per ``.claude/mode``, confirmed by topic and active EDEN classification) | **Effort:** Max (per ``.claude/effort-level``, not separately confirmed this turn) | **Assessor:** Claude Opus 4.7 Max (``ClaOp47Max``) | **VVN of this llog:** ``infra-llog-b16-b19-pdf-fix-dv_ClaOp47Max_OOv1r0p0_2026m05d10_18h37`` | **Branch:** ``7-paper-guard-against-echo-chambers`` | **Status:** Primary fix landed; PDF builds cleanly. Link-convention normalization (front/back/list naming) deferred pending LLoL's re-test of cross-references in new PDF. Context ========= LLoL reported that ``make pdf SECTION="matheology/hell/mm/b/19/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026.rst"`` was failing with multiple LaTeX errors that required pressing ``Return`` to step past at the terminal. Errors included ``! Argument of \caption@ydblarg has an extra }.``, ``Paragraph ended before \caption@ydblarg was complete.``, ``! Dimension too large.`` (in ``\caption@slc``), and ``LaTeX Warning: Hyper reference ... undefined`` for 154 figure cross-references. After stepping past all prompts a 53-page PDF was produced but the figure cross-references inside it did not work (LLoL tested directly). LLoL also asked, in the same session, to normalize the figure-cross-link conventions so that each figure-block carries the three non-self link types from the set ``{back, front, list, download}``. Verbatim prompts (LLoL) ========================= Prompt 1 of 2 --- build-error report: .. container:: verbatim-prompt when I try to build the PDF for the paper, there are some hickups that lead to blocking errors like "LaTeX Warning: Hyper reference \`matheology/hell/mm/b/19/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026:b19-sgir-fig02-list-2026m04d21' on page 36 undefined on input line 2351. [36] ! Argument of \\caption@ydblarg has an extra }. \\par l.2370 .../b/19/fig03-asha-places.pdf}{download})} \\label{\\detokenize{matheol... ?" [...continues with several similar errors for fig06, fig09, fig13 captions and a "Dimension too large" error...] --- Here is the tail of that build [...latexmk summary: "Latex failed to resolve 154 reference(s)", "lualatex: Command for 'lualatex' gave return code 1", "make[1]: *** [b19-sgir...pdf] Error 12", but a PDF in build/pdf/ was still produced...]. --- If I click Return to all Latex questions, the build proceeds and a PDF is built at: [...]. --- The build command is ``make pdf SECTION="matheology/hell/mm/b/19/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026.rst"`` --- I am not sure how many obvious and non-obvious errors are in the build at this point. Can you clean up the build? Prompt 2 of 2 --- link-convention request (sent mid-investigation): .. container:: verbatim-prompt And while you're at it, please fix the links between figure types: there should be a "back" link, a "front" link, a "download" link , and a "list" link for each front and back figure, whereas each "list" entry (in the Figure overview table) should only point to back and front and download. Prompt 3 of 3 --- follow-up about whether links must work (sent later): .. container:: verbatim-prompt The figure links in the PDF that I checked didn't work. --- About the links in the figure captions: If I can't make those links work that's not nice, but tolerable. If there is an easy(ish) way to make it work that woudl be nice, but else let's remove the links and move on. Investigation ============== Step 1 --- read the actual ``.log`` and ``.tex`` contexts at the failing line numbers (not just the terminal tail). All four ``\caption@ydblarg`` errors pointed to the same syntactic spot: the end of a figure caption that contained ``\sphinxhref{URL}{download})}\label{...}``. Closing brace counts in the generated ``.tex`` are balanced (verified: 27 ``{`` vs 27 ``}`` in the Fig.3 caption span), so the error is not a literal brace mismatch. Step 2 --- compared the four failing captions (Fig.3, Fig.6, Fig.9, Fig.13) against the working ones (Fig.4, Fig.5, Fig.7, Fig.8, Fig.10, Fig.11, Fig.12, Fig.14, Fig.15) using a small Python brace-walker. The only structural feature unique to the failing four is the presence of ``\hyperlink{cite.matheology/...}{Author, Year}{]}`` from a ``:cite:`` call inside the caption. Fig.9 additionally has ``{[}{]}`` from a ``:cite:`PandemicSociety101_code``` whose key does not exist in any ``.bib`` file (verified by ``grep`` over ``source/_bib/``). Step 3 --- root cause identified. ``\caption`` is a "moving argument": the caption text is consumed twice, once for the figure body and once for the List of Figures / ``\caption@ydblarg`` short-caption handler. ``\hyperlink`` is a **fragile** LaTeX command and is not legal in moving arguments without ``\protect`` or a separate ``\caption[short]{long}`` form. Sphinx emits only ``\caption{long}``, so ``\hyperlink`` inside a caption breaks the second pass. The 154 undefined hyper references are a cascade: when ``\caption@ydblarg`` aborts, the ``.aux`` write is corrupted, so subsequent ``\label{}`` entries don't reach the second pass cleanly. Step 4 --- additional, separate error in Fig.9: after fixing the ``:cite:`` issue, ``\caption@slc`` raised ``! Dimension too large.``. ``\caption@slc`` is the caption package's single-line check; on captions whose computed natural width overflows the TeX dimension register, this aborts. Fig.9 caption is unusually long (multiple paragraphs separated by ``---``), and the lualatex backend computes its single-line width as ``> 2^{30}\,sp``. EDEN classification ===================== Found this **Knife Edge #1** in EDEN: For the primary ``\caption@ydblarg`` failure, exactly one minimal-disruption path stays in ZION. Three options were considered: - (i) Convert ``:cite:`` to plain ``(Author, Year)`` text inside the four affected captions, keeping caption wording almost identical and main-text citations untouched. *Cost:* the four caption-internal citations lose their hyperlink to the bibliography (text remains, and the same citations also occur in the main body where they remain linked). - (ii) Move the citation sentence out of the caption into surrounding body text. *Cost:* invasive content rewrite; affects argument flow inside captions; touches text under active human review. - (iii) Protect ``\hyperlink`` via ``\protect`` in a raw-latex shim. *Cost:* requires custom RST role or post-processing; brittle; couples content files to LaTeX internals. Option (i) is the narrow ZION-path: smallest content change, no architectural debt, no coupling to LaTeX internals, attribution preserved. Options (ii) and (iii) accumulate BABL through unnecessary rework and over-reach. **Selected: (i).** Found this **Knife Edge #2** in EDEN: For the long-caption ``\caption@slc`` overflow in Fig.9, exactly one config-level path stays in ZION: ``\captionsetup{singlelinecheck=false}`` in ``conf.py``'s ``latex_elements["preamble"]``. The single-line check is a layout optimisation only --- disabling it forces the multi-line layout unconditionally, which is correct for all the long descriptive captions in this paper. Alternative paths (shortening the Fig.9 caption substantially, or per-figure ``\captionsetup``) either lose content or fragment configuration. The link-convention work (rename ``full size`` → ``back``, ``main text`` → ``front``; add ``list`` link to front captions; add ``download`` link to list entries) is a **Green Meadow** in EDEN: 15 figures × 3 caption types = 45 link blocks, all mechanical renames/additions, multiple valid orderings, no risk of substantive harm. Deferred until LLoL confirms (from the now-clean PDF) whether the existing cross-references already work --- which they should, now that the ``.aux`` pipeline is no longer cascading from the caption crash. Changes applied ================= File: ``source/matheology/hell/mm/b/19/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026.rst`` - Line ~2083 (Fig.3 back caption): ``:cite:`Mallet2012``` → ``(Mallet, 2012; cited in main text)`` - Line ~2169 (Fig.6 back caption): ``:cite:`Ehlert2014``` → ``Ehlert and Loewe, 2014; cited in main text`` - Line ~2414 (Fig.9 back caption): ``:cite:`Asadi2020``` → ``(Asadi et al., 2020; cited in main text)`` - Line ~2441-2442 (Fig.9 back caption): ``:cite:`PrototypeEvolvixCompiler``` × 2 plus the undefined ``:cite:`PandemicSociety101_code``` → consolidated into plain ``(Loewe and EvoSysBio Group at UW-Madison, 2015--2026; cited in main text)``. The undefined ``PandemicSociety101_code`` key is no longer referenced anywhere in this file; the bibliography is unchanged. - Lines ~2661 and ~2723 (Fig.13 back caption --- duplicate ``.gif`` and ``.png`` blocks): ``:cite:`MeyerowitzKatz2020``` → ``Meyerowitz-Katz and Merone, 2020; cited in main text`` File: ``source/conf.py`` - ``latex_elements["preamble"]`` --- appended ``singlelinecheck=false`` to ``\captionsetup{...}`` with an explanatory comment noting the b19 Fig.9 ``\caption@slc`` overflow. Test ====== Re-ran ``make pdf SECTION="matheology/hell/mm/b/19/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026.rst"`` after each fix: - After ``:cite:`` removal only: ``\caption@ydblarg`` errors gone; undefined refs 154 → 108; ``\caption@slc`` "Dimension too large" still failed Fig.9. - After ``singlelinecheck=false`` added: 0 LaTeX errors, 0 undefined figure cross-references, non-interactive build completes, PDF written at ``build/pdf/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026_BalospeCom_2026m05d10_18h36m06.pdf`` (53 pages, 3.6 MB). 12 ``(pdf backend): unreferenced destination`` warnings remain for bibliography back-link targets in a separate ``si/wwv-sgir-evolvix-study-dv_llol_oov1_2026m04d17`` document --- these are cosmetic (declared link targets with no inbound links) and unrelated to the original problem. (Test, not validated --- no closed-form proof of completeness in an open system; further regression may surface from full multi-section builds or alternate LaTeX backends.) Summary and recommendation for LLoL ===================================== 1. The b19 PDF build is now clean: zero errors, zero undefined figure cross-references, no interactive prompts. The new PDF is ``build/pdf/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026_BalospeCom_2026m05d10_18h36m06.pdf``. 2. The fix replaces five ``:cite:``-in-caption calls with plain ``(Author, Year; cited in main text)`` text across Fig.3, Fig.6, Fig.9, Fig.13 captions. The same citations remain fully linked in their main-text occurrences; only the caption duplicates lose their bib-hyperlink (caption wording preserves attribution). 3. ``singlelinecheck=false`` added to ``conf.py`` ``\captionsetup`` --- harmless global change, only affects how the caption package handles single-line captions (forces multi-line layout always, which is what these long descriptive captions need anyway). 4. **Please re-open the new PDF and re-test the figure cross-reference links** (e.g., click ``main text`` / ``list`` / ``full size`` links in any figure caption). They should now resolve because the ``.aux`` cascade is gone. If they do work: I can proceed with the link-convention normalization (rename ``full size`` → ``back``, ``main text`` → ``front``; add ``list`` link to all 15 front captions; add ``download`` link to all 15 list entries) --- ~45 mechanical edits. If they don't work: per your direction I will remove the link blocks from captions entirely. 5. Stretch goal: ``:cite:`PandemicSociety101_code``` is referenced once more elsewhere in the paper (line 2863 of the file) but the key is missing from ``.bib``; this triggers cosmetic "unreferenced destination" warnings. Worth adding a proper Zenodo bib entry when the code is publicly archived, or removing the stray reference at line 2863. Not blocking. 6. No content under any ``Guarded by LLoL`` block was touched (verified by ``grep`` --- this file currently has no guards). Only ``:cite:`` calls inside figure captions and one ``conf.py`` preamble line were changed. Follow-up turn --- link-convention normalization (2026m05d10_22h37) ===================================================================== Verbatim prompt (LLoL): .. container:: verbatim-prompt re-tested PDF --- figure links now work. Do NOT rename full size --> back, main text --> front, the longer is the READABLE bit, the shorter is the LINK bit, so those are OK. What needs to be added are the remaining list -> list links to all 15 captions (and a respective download to the (usually PDF) original for Download). Please leave the "link-blocks" in place. --- I rechecked the list of figures in the middle and they have front-back as the readable text; these should be changed to "small figure in main text context" and "full sized figure and explanation", respectively. --- Also, there are build warnings of this type "/Users/llol/LLoL-Repos/SethGitHubSetup/balospe-com/source/matheology/hell/mm/b/19/si/wwv-sgir-evolvix-study-dv_llol_oov1_2026m04d17.rst:203: WARNING: image file not readable: _file/pdf/gnp/mmv3/flyingscroll/transwarpkey/sta2-wwv/pandemicsociety101/b11/webp/fig01-model-overview.webp", which I don't understand. Should that not be a resolved problem by now? Key clarification from LLoL: the long descriptive phrase ("full size", "main text") is the *readable* text and stays as-is in the captions; the shorter word is only the *role* of the link. So **no rename** in the figure captions. The change is purely additive: each front caption needs a ``list`` link (back captions and fig11-14 fronts already have one); each list entry needs a ``download`` link and a more descriptive readable text. List entries' link wording does change as quoted. Changes applied ~~~~~~~~~~~~~~~~ File ``b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026.rst``: - Added ``:ref:`list ` |`` between the ``full size`` and ``download`` links in 11 front-figure captions (fig01–fig10 and fig15). Fronts fig11–fig14 already had a list link; back captions already had front+list+download. - Rewrote all 15 list entries: ``front`` → "small figure in main text context", ``back`` → "full sized figure and explanation"; appended a ``download`` link pointing to the same file the front/back captions link to (PDF for most; ``fig04-scenario1-deaths.png`` and ``fig13-empirical-death-rates.gif`` use their respective formats; the fig14 entry preserves its parenthetical "(Section 3.6)" qualifier). Test ~~~~~~ Re-ran ``make pdf SECTION=...`` after the additions. 0 LaTeX errors, 0 undefined figure cross-references, non-interactive build; PDF written to ``build/pdf/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026_BalospeCom_2026m05d10_22h37m51.pdf`` (53 pages, 3.78 MB). The 12 remaining cosmetic "unreferenced destination" warnings are the same SI bib-target set as before and are unrelated to figure cross-refs. SI webp ``image file not readable`` warnings --- finding, no fix yet ===================================================================== LLoL asked whether the warning :: source/matheology/hell/mm/b/19/si/wwv-sgir-evolvix-study-dv_llol_oov1_2026m04d17.rst:203: WARNING: image file not readable: _file/pdf/gnp/mmv3/flyingscroll/transwarpkey/sta2-wwv/pandemicsociety101/b11/webp/fig01-model-overview.webp should be a resolved problem by now. **It is not resolved.** The SI file still references the old pre-reorg figure path ``_file/pdf/gnp/mmv3/flyingscroll/transwarpkey/sta2-wwv/pandemicsociety101/b11/webp/`` (which is empty); the figures live at ``_file/pdf/hell/mm/b/19/`` (no ``webp/`` subdir). 36 lines in the SI use stale paths --- 13 ``.. figure::`` directives, 13 ``:target:`` options, ~10 inline ``Full PDF /...`` links. Complication: the SI uses an older figure numbering. Two pairs are swapped between SI and paper: - SI Fig.4 (``fig04-scenario1-logplot``) = paper Fig.5 (``fig05-scenario1-logplot``) - SI Fig.5 (``fig05-scenario1-deaths``) = paper Fig.4 (``fig04-scenario1-deaths``) - SI Fig.12 (``fig12-empirical-death-rates``) = paper Fig.13 (``fig13-empirical-death-rates``) - SI Fig.13 (``fig13-stage-waves``) = paper Fig.12 (``fig12-stage-waves``) So a global ``sed`` won't work; the path rewrite needs a per-image mapping table that maps the SI's filename to the paper-numbered actual file. The renumbering also raises a content question: does the SI's caption text ("Fig. 4: Log-plot overview, Scenario 1") need to be renumbered to match the paper, or does the SI carry its own historical numbering and we only fix the file paths so the existing images load? This is a substantive content choice (numbering = caption text in the SI) and is **deferred to LLoL** rather than auto-applied. Three options: (i) **Fix paths only, keep SI's historical numbering.** Each ``figXX-name`` in the SI's path points to the paper-numbered file, even though the SI calls it ``Fig.XX-old``. Smallest content change; preserves the SI as a snapshot of the 2026m04d17 state. Confusing for readers who notice the path/caption number mismatch. (ii) **Fix paths and renumber SI to match paper.** Substantive content change inside the SI's captions and section ordering; requires re-reading and re-validating. Cleanest end state. (iii) **Leave as-is for now.** The warnings stay but the main paper PDF still builds; the SI file does not currently appear in the b19 toctree (per the b14 llog discussion in ``hell/ll/infra/b/14/``, the SI was re-added). Risk: any subsequent SI-only build (HTML or PDF) will be broken. **EDEN classification:** Grey Edge --- the path-only fix appears safe but reorders interpretation in ways a reader may not catch; the full renumbering is invasive but unambiguous. No clear ZION-only path. Awaiting LLoL guidance on (i) vs (ii) vs (iii) before touching the SI. Follow-up turn --- SI path fix (option i applied) + LoF gap diagnosis (2026m05d10_late) ========================================================================================= Verbatim prompt (LLoL): .. container:: verbatim-prompt Thanks. go with (i). (yet, I will still have to decide what to do with that hybrid old version.) --- Then please look into this different problem (and tell me if I'd best do that in a fresh context). The list of figures (lines 1881 - 2010): I'm trying to get it to format such that the Fig.# FigTitle is on the first line and the 3 links on the 2nd line (to look better arranged). It sort of works for Fig.1 in the PDF, except that Fig.2 is WAY TOO far away from the Fig.1 line. Why is that? my use of "| " shouldn't have generated that (or so I think). Do you have a better way to force that linebreak? If I use an empty line to separate the 2, then Latex thinks it's a new paragraph with extra spacing need between it all (which looks weird). --- If nothing really works, then I'd likely rather revert back to having it all in 1 line (instead of risking this list being distributed across 2 pages). Any tips? SI path fix (option i) ~~~~~~~~~~~~~~~~~~~~~~~~ Applied 26 path rewrites in ``source/matheology/hell/mm/b/19/si/wwv-sgir-evolvix-study-dv_llol_oov1_2026m04d17.rst``: - 13 figures × 2 patterns each (webp + non-webp). For unchanged-number figures (1, 2, 3, 6, 7, 8, 9, 10, 11) the figure number stayed the same in the new path; for the four renumbered figures the source-stem differs from the destination-stem: - SI ``fig04-scenario1-logplot`` → ``hell/mm/b/19/fig05-scenario1-logplot`` - SI ``fig05-scenario1-deaths`` → ``hell/mm/b/19/fig04-scenario1-deaths`` - SI ``fig12-empirical-death-rates`` → ``hell/mm/b/19/fig13-empirical-death-rates`` - SI ``fig13-stage-waves`` → ``hell/mm/b/19/fig12-stage-waves`` - 1 source-code file path (``PandemicSociety101_CoreModel_QQ0r8p2_..._Sent.txt``) rewritten to ``hell/mm/b/19/``. Per option (i), the SI's *caption text* (e.g. "Fig. 4: Log-plot overview, Scenario 1") is left untouched even where the new path now contains ``fig05-``. LLoL has explicitly accepted this hybrid state pending a future decision on the SI's role. Found, but **not fixed**, 4 stale references to appendix figures that don't exist anywhere in ``source/_file/``: - ``_Fig9-1_Outlook__Plot-1-ODE-SSA-Overview-v9p4.pdf`` (lines 1023 + 1317 in the SI) - ``fig-a1-worklogic-cascade.pdf`` (line 1320) - ``fig-a2-mapk-cascade.pdf`` (line 1323) - ``fig-a3-places-of-reasoning.pdf`` (line 1326) Status: reported to LLoL; the files need to be restored from archive OR the references removed. No b19-build warnings are currently triggered by these (likely because the references are inside table cells or appendix sections that don't load images for the current target). The two ``wwv-prep-fail-snapshot-...-2020m07d17-32pg.pdf`` references (lines 1101, 1263) point to a file that exists at the canonical ``gnp/.../sta2-wwv/`` location --- left unchanged. Same WWV file is also referenced at line ~1894 of the main b19 paper; also left unchanged for the same reason. Test ~~~~~~ Re-ran ``make pdf SECTION=...`` post-fix. Zero ``image file not readable`` warnings, zero LaTeX errors, non-interactive build. The 12 cosmetic "unreferenced destination" warnings remain --- now confirmed to be PDF-backend warnings for *declared* citation anchors in the SI that have *no inbound links* (the opposite of "broken refs"; harmless). LoF inter-entry gap --- diagnosis only, no edits applied ========================================================= LLoL's question: in the figures-overview list (lines 1881-2010), the desired layout is "Fig.# Title" on line 1 and "3 links" on line 2 per entry, but Fig.2 sits "WAY TOO far" from Fig.1 in the PDF. The "| " pipe usage is suspected. Diagnosis: the ``|`` pipe between ``:ref:`` titles is innocent --- it's normal text content. The gap is **LaTeX ``\parskip``** (inter-paragraph vertical space). Each list entry is a separate paragraph because: - ``.. _b19-sgir-figXX-list_2026m04d21:`` is a block-level label and **must** be preceded and followed by blank lines. - Each blank line is a paragraph break in RST. - LaTeX inserts ``\parskip`` between paragraphs. The intra-entry "title on line 1, links on line 2" effect Fig.1 currently shows is **accidental** --- it depends on the combined text being just long enough to natural-wrap at the page width near the "---" separator. For shorter or longer titles the wrap position will be different. Three options offered to LLoL (full text in reply): - (A) RST line block (``| line``) --- forces the 2-line intra-entry layout independent of wrap, but does **not** change the inter-entry gap. - (B) Wrap the list in raw-LaTeX ``\begingroup\setlength{\parskip}{0pt}...\endgroup`` --- tightens inter-entry spacing in PDF only. - (C) Bullet list with labels-inside-items + line blocks --- LaTeX ``itemize`` uses ``\itemsep`` instead of ``\parskip``, typically tighter. Works in HTML too. Recommendation: **(A) + (C) combined** --- bullet list with each item as a 2-line line block. Decision deferred to LLoL. Stretch goal noted: LLoL's resource-constraint hint ("hybrid old version" of SI) suggests the SI may be marked for eventual retirement or merging. A future cleanup could reconcile SI figure numbering with the paper (option ii from the previous turn), removing the path-vs-caption number mismatch the option-i fix accepts. Not blocking. Follow-up turn --- applied LoF (A)+(C): bullet list with line blocks (2026m05d10_23h36) ========================================================================================= Verbatim prompt (LLoL): .. container:: verbatim-prompt apply (A)+(C) now Changes applied ~~~~~~~~~~~~~~~~ Reformatted all 15 figures-overview-list entries from the loose paragraph-with-label pattern (which had degenerated into broken line-block-plus-orphan-paragraphs for Fig.3 onwards, where soft-wrapped lines after the second ``|`` were being interpreted as separate paragraphs) into the cleaner pattern: .. code-block:: rst * .. _b19-sgir-figXX-list_2026m04d21: | **Fig.X** Title --- | :ref:`small figure in main text context <...>` | :ref:`full sized figure and explanation <...>` | `download <...>`__ Key properties: - One contiguous bullet list (LaTeX ``itemize`` env), so the inter-entry gap is ``\itemsep`` (typically tight) rather than ``\parskip``. - Each ``.. _figXX-list:`` label sits inside its bullet item; Sphinx renders this as ``\item {} \phantomsection\label{...}`` (verified in the generated .tex), so ``:ref:`b19-sgir-figXX-list_2026m04d21``` jumps land on the correct bullet item from anywhere in the document. No anchor was lost. - Each item's body is a 2-line RST line block: the title forced onto line 1, all three links concatenated onto line 2 (one source line, so RST line block treats them as one logical line; natural wrap may add visual lines if the page is narrow). - Bullet markers are visible by default; if LLoL prefers a marker-less compact look, a follow-up can add ``rst-class:: simple`` plus a small HTML/LaTeX style override. Minor cosmetic fix included en route: added a space before ``---`` in Fig.13 and Fig.14 titles (the source had ``2020-06-28)---`` and ``global---`` --- almost certainly typos in the dash spacing). This is purely cosmetic; if LLoL prefers the original no-space form, that can be reverted in two seconds. Test ~~~~~~ Re-ran ``make pdf SECTION=...`` after the reformat. 0 LaTeX errors, 0 undefined hyper references, build is non-interactive and clean. New PDF: ``build/pdf/b19-sgir_basic-gap-of-germs-2020-epidemiology-oov1_2026_BalospeCom_2026m05d10_23h36m44.pdf`` (54 pages, 3.78 MB --- one page more than the 53-page baseline, likely due to the bullet-list nudging the LoF page break). Spot check on the generated LaTeX confirmed: the bullet items are rendered as a single ``itemize`` environment in the .tex output, with each ``\item`` containing a ``\phantomsection\label{...}`` for the figure-list anchor and the line block beneath. Cross-references to the per-figure list labels resolve normally. (Tested, not validated --- visual layout of the LoF in the PDF is best confirmed by LLoL's eyes; if Fig.2's distance from Fig.1 is still too large, the next step is to add a raw-LaTeX wrap around the list to set ``\setlength{\itemsep}{-2pt}`` or similar.)