docs: add gif asset hygiene guidance

This commit is contained in:
Peter Steinberger
2026-04-26 10:48:00 +01:00
parent bd95baa4f7
commit 975fd5bc8d

View File

@@ -73,6 +73,12 @@ Output
- `--json` prints an array of results (`id`, `title`, `url`, `preview_url`, `tags`, `width`, `height`)
- `--format` for pipe-friendly fields (e.g., `url`)
GIF asset hygiene
- Before recommending or using an animated GIF URL, verify it resolves successfully, has `Content-Type: image/gif`, and is actually animated (multiple frames or loop metadata; e.g. inspect with `file`, `identify`, or a small script).
- Record attribution/license/source URL alongside the asset.
- Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file.
Environment tweaks
- `GIFGREP_SOFTWARE_ANIM=1` to force software animation