anynews/republisher
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: document image pipeline profiles

Browse source
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
Download patch file Download diff file Expand all files Collapse all files

2
repub/pages/sources.py
View file

@ -381,7 +381,7 @@ def source_form(
),
toggle_field(
label="Convert images",
description="Normalize mirrored images through the image conversion pipeline for this source.",
description="Run mirrored images through configured image profiles and thumbnail profiles for this source.",
signal_name="convertImages",
checked=_checked(source, "convert_images", True),
),

4
repub/settings.py
View file

@ -108,6 +108,8 @@ REPUBLISHER_IMAGE_FULL_SUBDIR = "full"
REPUBLISHER_IMAGE_SOURCE_SUBDIR = "source"
REPUBLISHER_IMAGE_THUMBNAIL_SUBDIR = "thumbs"
# Full-size image profiles. The first profile is the canonical public image
# URL used when feed image URLs are rewritten.
REPUBLISHER_IMAGE = [
{
"name": "main_webp",
@ -159,6 +161,8 @@ REPUBLISHER_IMAGE = [
},
]
# Named thumbnail profiles emitted as Media RSS thumbnails for explicit item
# image media.
REPUBLISHER_IMAGE_THUMBNAILS = [
{
"name": "card_hero",

4
repub/utils.py
View file

@ -79,7 +79,7 @@ def canonical_published_image_path(
source_url: str, profiles: Sequence[Mapping[str, Any]]
) -> str:
if not profiles:
raise ValueError("Missing image normalization profiles")
raise ValueError("Missing image profiles")
return published_image_path(source_url, profiles[0])
@ -122,7 +122,7 @@ def canonical_published_media_path(
file_type: FileType, source_url: str, profiles: Sequence[Mapping[str, Any]]
) -> str:
if not profiles:
raise ValueError(f"Missing transcode profiles for {file_type.value}")
raise ValueError(f"Missing media profiles for {file_type.value}")
# The first configured profile is the public URL contract. Reordering profiles
# changes published URLs for already-mirrored media.
if file_type == FileType.IMAGE: