jojo/cmd
Antonin Delpeuch 0a57672544 feat: serve downsized versions of avatars (#11242)
Fixes #2325.

This introduces a way to download downsized versions of the user and repository avatars:
* `/avatars/123abcd` still serves the full-size avatar
* `/avatars/123abcd?size=64` serves it at size 64x64 px

Those downsized versions are computed on demand when requested for the first time and cached. The caching is done in a storage location configurable in the instance settings, just like the storage locations for the full-sized avatars are. The sizes of the downsized images are restricted to a fixed set of sizes, so that the cache doesn't grow too big. The caching and resizing logic is exposed in a way that could potentially be reused for other types of images (such as user uploads in issue discussions).

Luckily, the Go templates already specify in many places which size those avatars should be rendered, even if this information was only used for external avatar providers (such as Gravatar) until now.

The range of sizes requested by the HTML templates is rather wide: the table below lists all the sizes I could find, and the corresponding size served by the backend with the logic I implemented. The scaling factor of 2 was already used for requesting resized external avatars, and likely exists to make sure that users with display scaling enabled get a sharper picture.

| Size requested in the template | After scaling (x2)  | Size of the image served |
|---------|---------|---------|
| 256 px |  512 px | original (512 px) |
| 140 px | 280 px | original (512 px) |
| 48 px | 96 px | 128 px |
| 40 px | 80 px | 128 px |
| 32 px | 64 px | 64 px |
| 28 px | 56 px | 64 px |
| 24 px | 48 px | 64 px |
| 20 px | 40 px | 64 px |

Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/11242
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2026-05-16 12:04:05 +02:00
..
forgejo ci: detect and prevent empty case statements in Go code (#11593) 2026-03-10 02:50:28 +01:00
actions.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin.go feat: replace repo based server-side hooks with centralised hooks (#10397) 2026-04-27 22:34:46 +02:00
admin_auth.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin_auth_ldap.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin_auth_ldap_test.go chore(upgrade): urfave/cli from v2 to v3 (#8035) 2025-06-01 22:16:37 +02:00
admin_auth_oauth.go feat: allow sync quota groups with oauth2 auth source (#8554) 2025-12-01 14:12:00 +01:00
admin_auth_oauth_test.go feat: allow sync quota groups with oauth2 auth source (#8554) 2025-12-01 14:12:00 +01:00
admin_auth_pam.go feat: allow to add pam source from command line (#10388) 2025-12-19 15:20:52 +01:00
admin_auth_pam_test.go feat: allow to add pam source from command line (#10388) 2025-12-19 15:20:52 +01:00
admin_auth_smtp.go fix: rename a file with typo STMP -> SMTP (#10389) 2025-12-10 14:20:05 +01:00
admin_regenerate.go feat: replace repo based server-side hooks with centralised hooks (#10397) 2026-04-27 22:34:46 +02:00
admin_user.go feat: add CLI command 'admin user create-authorized-integration' (#12299) 2026-04-28 21:32:45 +02:00
admin_user_change_password.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin_user_create.go feat: backend DB model for fine-grained repo access tokens 2026-02-27 17:17:29 +01:00
admin_user_delete.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin_user_generate_access_token.go feat: backend DB model for fine-grained repo access tokens 2026-02-27 17:17:29 +01:00
admin_user_generate_authorized_integration.go feat: add 'ui' field to authorized_integration table 2026-05-14 23:54:16 +02:00
admin_user_list.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
admin_user_must_change_password.go chore(upgrade): urfave/cli from v2 to v3 (#8035) 2025-06-01 22:16:37 +02:00
admin_user_reset_mfa.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
cert.go chore: add modernizer linter (#11936) 2026-04-02 03:29:37 +02:00
cmd.go chore: use signal.NotifyContext over custom implementation (#10311) 2026-03-04 00:45:38 +01:00
cmd_test.go chore: use signal.NotifyContext over custom implementation (#10311) 2026-03-04 00:45:38 +01:00
doctor.go feat: serve downsized versions of avatars (#11242) 2026-05-16 12:04:05 +02:00
doctor_convert.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
doctor_test.go chore(upgrade): urfave/cli from v2 to v3 (#8035) 2025-06-01 22:16:37 +02:00
dump.go feat: enable compression on zip dump (#12296) 2026-04-28 02:11:26 +02:00
dump_repo.go chore: add modernizer linter (#11936) 2026-04-02 03:29:37 +02:00
dump_test.go feat: Replace mholt/archiver/v3 with mholt/archives (#7025) 2025-08-08 06:53:20 +02:00
embedded.go chore(upgrade): urfave/cli from v2 to v3 (#8035) 2025-06-01 22:16:37 +02:00
generate.go chore: unify the usage of CryptoRandomString (#10110) 2025-11-15 13:24:53 +01:00
hook.go chore: fix typos throughout the codebase (#10753) 2026-01-26 22:57:33 +01:00
hook_test.go fix: incorrect whitespace handling on pre&post receive hooks 2026-01-06 09:58:20 -07:00
keys.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
mailer.go chore: fix typos throughout the codebase (#10753) 2026-01-26 22:57:33 +01:00
main.go Update module github.com/urfave/cli/v3 to v3.7.0 (forgejo) (#11713) 2026-03-18 20:23:38 +01:00
main_test.go feat: replace repo based server-side hooks with centralised hooks (#10397) 2026-04-27 22:34:46 +02:00
manager.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
manager_logging.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
migrate.go chore: rename 'migrations' to 'gitea_migrations' 2025-10-14 14:40:49 -06:00
migrate_storage.go chore: rename 'migrations' to 'gitea_migrations' 2025-10-14 14:40:49 -06:00
migrate_storage_test.go Update module github.com/golangci/golangci-lint/cmd/golangci-lint to v2 (forgejo) (#7367) 2025-03-28 22:22:21 +00:00
restore_repo.go fix!: detect extra cmdline args and emit errors (#9458) 2025-10-08 18:20:28 +02:00
serv.go chore: unify signing key configuration across modules (#11194) 2026-04-21 19:39:33 +02:00
web.go chore: don't load settings twice for running web (#12111) 2026-04-14 07:25:05 +02:00
web_acme.go fix: use correct ACME default (#8550) 2025-07-17 20:40:09 +02:00
web_graceful.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
web_https.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00