docs: cover both PDF fixes and the cost of dropping <id> from a template

Troubleshooting gains an entry for missing and misplaced PDFs, including the
naming-template cause, since a library with no <id> in its folder and file
templates is one Libation cannot recognise the output of at all. The CLI
reference notes what a plain liberate run now covers, and that the
Audiobookshelf upload is deliberately not part of the PDF back-fill.

Co-authored-by: rmcrackan <rmcrackan@gmail.com>

docs/advanced/command-line-interface.md

@@ -160,6 +160,10 @@ If Audiobookshelf auto-upload is enabled in Settings, `liberate` also uploads ea
 
 Titles Audible has recently refused a license for are left out of the run and reported as one summary, rather than being requested again every time. This matters most for a scheduled run. See [Retrying titles Audible refuses](/docs/features/retrying-refused-downloads); naming an ASIN or passing `--force` overrides it.
 
+The run covers both halves of "book and pdf backups": titles that need downloading, and titles whose audio you already have but whose PDF is missing. Before 13.7.9 it only did the first, so `liberate --pdf` was the only way to get a PDF for a title downloaded earlier.
+
+Audiobookshelf auto-upload is not part of that second half. It runs when a title is liberated, so a run that only back-fills a PDF does not upload; use `abs upload` to send titles liberated earlier.
+
 ## Upload Already-Liberated Books to Audiobookshelf
 
 Auto-upload only runs at the moment a book is liberated. Use `abs upload` to send books liberated earlier, using the files already on disk. Nothing is re-downloaded.
@@ -190,6 +194,10 @@ libationcli liberate --pdf
 libationcli liberate -p
 ```
 
+Downloads nothing but PDFs, and never downloads an audiobook. A plain `liberate` covers the same titles, so this is for when you want only the PDFs.
+
+A PDF is saved beside its audiobook, or in the folder the [folder template](/docs/features/naming-templates) names for that title when Libation cannot find the audio files. Before 13.7.9 the second case put the PDF directly in your Books directory.
+
 ## Re-Liberate a Single Book
 
 After Audible updates a title (or to replace a bad file), re-download just that book. Naming an ASIN always re-downloads it, even if it is already liberated:

docs/advanced/troubleshoot.md

@@ -193,6 +193,21 @@ After a refusal Libation waits before asking about that title again, so you see
 
 Attach your log file when opening a GitHub issue.
 
+## PDFs are missing, or land loose in the Books directory
+
+Both were fixed in 13.7.9.
+
+**`libationcli liberate` downloaded no PDFs.** A plain run only looked at titles that needed an audiobook, so a title whose audio was already downloaded was never reached and its PDF was never fetched. `libationcli liberate --pdf` was the only way to get them. A plain run now covers both. If your library predates the fix, one `libationcli liberate` (or **Liberate** \> **Begin Book and PDF Backups** in the app) collects the PDFs you are missing.
+
+**PDFs went into the Books directory instead of the book's folder.** Libation saves a PDF beside its audiobook, which it locates by looking for the title's ASIN in the file path. When that lookup found nothing it fell back to the Books directory itself. It now falls back to the folder the [folder template](/docs/features/naming-templates) names for that title.
+
+The lookup finds nothing in two situations, and the second is worth checking:
+
+1. The audio files are not on this machine — the title is marked downloaded but the files live elsewhere, or were deleted.
+2. **Your folder and file templates have no `<id>` tag.** Then no file Libation writes has the ASIN in its path, so Libation cannot recognise its own output for any title. Add `<id>` back in Settings \> Download/Decrypt; the defaults are `<title short> [<id>]` for folders and `<title> [<id>]` for files. This also explains PDFs with no ASIN in the name: the file name comes from your file template.
+
+Already-misplaced PDFs are not moved. Move them into their book folders yourself, or set the affected titles' PDF status to Not Downloaded and download them again.
+
 ## The log file is too large to attach to a bug report
 
 From 13.7.9 the log rolls every 10 MB as well as every month, keeping the 20 newest files, so the current

docs/features/naming-templates.md

@@ -8,6 +8,12 @@ File and Folder names can be customized using Libation's built-in tag template n
 
 These templates apply to both GUI and CLI.
 
+::: tip Keep `<id>` somewhere in your templates
+Libation finds a title's existing files by looking for its ASIN in the path. Drop `<id>` from both the folder
+and the file template and Libation can no longer recognise its own output, so a later PDF, cover or metadata
+download cannot be placed beside the audiobook it belongs to, and the grid cannot tell that a file is present.
+:::
+
 ## Template Tags
 
 These are the naming template tags currently supported by Libation.