docs: document image pipeline profiles

This commit is contained in:
Abel Luck 2026-05-27 10:13:06 +02:00
parent 18a7f652d4
commit cbb427b89d
6 changed files with 40 additions and 5 deletions

View file

@ -17,6 +17,19 @@ Because `out_dir` in [`demo/repub.toml`](/home/abel/src/guardianproject/anynews/
- `repub.toml`: example runtime config with feed definitions, slugs, and Scrapy overrides
- `fixtures/local-feed.rss`: simple local RSS fixture for `file://` feed testing
## Image Profiles
The demo config uses the default image profiles from `repub/settings.py`.
`REPUBLISHER_IMAGE` controls full-size image variants; the first profile is the
canonical image URL written into feeds. `REPUBLISHER_IMAGE_THUMBNAILS` controls
named thumbnail variants for explicit item image media.
By default, mirrored image source bytes are kept under `images/source/`, full
profile variants are written under `images/full/`, and thumbnail profile
variants are written under `images/thumbs/` inside each feed output directory.
Edit the Scrapy settings in [`demo/repub.toml`](/home/abel/src/guardianproject/anynews/republisher-redux/demo/repub.toml)
when a demo run needs to disable thumbnails or test a different profile set.
## Local File Feed
`repub` already accepts absolute `file://` feed URIs. To point it at the demo fixture, generate an absolute URI like this from the repo root: