Skip to content

keryx post image

Description

Give a post its image from one of two sources (spec 0062 D4). --from-cover encodes the article's cover to JPEG beside it (cover-<slug>.jpg). --pick <path> copies a picture the project already has, by its project-relative path: a reel's cover, card, portrait or take, another post's image, or an article's cover. The copy lands in the article's bundle as post-<id>.jpg, whatever the source's format; the source is never referenced in place (R-ANN-23). A reel file that is not on disk but is in the workspace's media.lock is fetched from the object store first, that file alone.

Either way the public URL follows from announce.public_base_url, the alt text is kept, and image.source records where the file came from (R-ANN-25). The studio's Pick… gallery is the same operation with thumbnails; GET /api/v1/imagery lists what it offers.

Usage

keryx post image --article <dir> --post <id> (--from-cover | --pick <project-relative path>)

keryx post image --article content/post/my-post --post launch --from-cover
keryx post image --article content/post/my-post --post launch --pick reels/my-post/cover.png
keryx post image --article content/post/my-post --post recap --pick content/post/other/post-launch.jpg

Flags

Flag Description Default Required
--article the article's bundle directory yes
--post the post piece (its id, from post new) yes
--from-cover use the article's cover false
--pick a project-relative path to copy in

Exactly one of --from-cover and --pick.