{"id":14979155,"url":"https://github.com/jekyll/jekyll-avatar","last_synced_at":"2025-12-12T01:02:48.169Z","repository":{"id":42372213,"uuid":"49378146","full_name":"jekyll/jekyll-avatar","owner":"jekyll","description":"A Jekyll plugin for rendering GitHub avatars","archived":false,"fork":false,"pushed_at":"2022-04-15T10:28:49.000Z","size":113,"stargazers_count":91,"open_issues_count":2,"forks_count":10,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-10-04T21:23:51.144Z","etag":null,"topics":["avatars","github","github-pages","jekyll","jekyll-plugin"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jekyll.png","metadata":{"files":{"readme":"README.md","changelog":"History.markdown","contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-10T17:50:55.000Z","updated_at":"2025-10-03T10:35:59.000Z","dependencies_parsed_at":"2022-07-15T08:51:32.402Z","dependency_job_id":null,"html_url":"https://github.com/jekyll/jekyll-avatar","commit_stats":null,"previous_names":["benbalter/jekyll-avatar"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/jekyll/jekyll-avatar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-avatar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-avatar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-avatar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-avatar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jekyll","download_url":"https://codeload.github.com/jekyll/jekyll-avatar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-avatar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278523052,"owners_count":26000955,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["avatars","github","github-pages","jekyll","jekyll-plugin"],"created_at":"2024-09-24T13:59:24.037Z","updated_at":"2025-10-06T19:08:26.541Z","avatar_url":"https://github.com/jekyll.png","language":"Ruby","readme":"# Jekyll Avatar\n\n*A Jekyll plugin for rendering GitHub avatars*\n\n[![CI](https://github.com/jekyll/jekyll-avatar/actions/workflows/ci.yml/badge.svg)](https://github.com/jekyll/jekyll-avatar/actions/workflows/ci.yml)\n\nJekyll Avatar makes it easy to add GitHub avatars to your Jekyll site by specifying a username. If performance is a concern, Jekyll Avatar is deeply integrated with the GitHub avatar API, ensuring avatars are cached and load in parallel. It even automatically upgrades users to Retina images, when supported.\n\n## Installation\n\nAdd the following to your site's `Gemfile`:\n\n```ruby\ngem 'jekyll-avatar'\n```\n\nAnd add the following to your site's `_config.yml` file:\n\n```yaml\nplugins:\n  - jekyll-avatar\n```\nNote: If you are using a Jekyll version less than 3.5.0, use the `gems` key instead of `plugins`.\n\n## Usage\n\nSimply add the following, anywhere you'd like a user's avatar to appear:\n\n```\n{% avatar [USERNAME] %}\n```\n\nWith `[USERNAME]` being the user's GitHub username:\n\n```\n{% avatar hubot %}\n```\n\nThat will output:\n\n```html\n\u003cimg class=\"avatar avatar-small\" src=\"https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=40\" alt=\"hubot\" srcset=\"https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=40 1x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=80 2x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=120 3x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=160 4x\" width=\"40\" height=\"40\" /\u003e\n```\n\n### Customizing\n\nYou can customize the size of the resulting avatar by passing the size argument:\n\n```\n{% avatar hubot size=50 %}\n```\n\nThat will output:\n\n```html\n\u003cimg class=\"avatar\" src=\"https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=50\" alt=\"hubot\" srcset=\"https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=50 1x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=100 2x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=150 3x, https://avatars3.githubusercontent.com/hubot?v=3\u0026amp;s=200 4x\" width=\"50\" height=\"50\" /\u003e\n```\n\n### Passing the username as variable\n\nYou can also pass the username as a variable, like this:\n\n```\n{% assign user=\"hubot\" %}\n{% avatar {{ user }} %}\n```\n\nOr, if the variable is someplace a bit more complex, like a loop:\n\n```\n{% assign employees = \"alice|bob\" | split:\"|\" %}\n{% for employee in employees %}\n  {% avatar user=employee %}\n{% endfor %}\n```\n\n### Lazy loading images\n\nFor pages showing a large number of avatars, you may want to load the images lazily.\n\n```liquid\n{% avatar hubot lazy=true %}\n```\n\nThis will set the `data-src` and `data-srcset` attributes on the `\u003cimg\u003e` tag, which is compatible with many lazy load JavaScript plugins, such as:\n\n* https://www.andreaverlicchi.eu/lazyload/\n* https://appelsiini.net/projects/lazyload/\n\n### Using with GitHub Enterprise\n\nTo use Jekyll Avatars with GitHub Enterprise, you must set the `PAGES_AVATARS_URL` environmental variable.\n\nThis should be the full URL to the avatars subdomain or subpath. For example:\n\n* With subdomain isolation: `PAGES_AVATARS_URL=\"https://avatars.github.example.com\"`\n* Without subdomain isolation: `PAGES_AVATARS_URL=\"https://github.example.com/avatars\"`\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-avatar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjekyll%2Fjekyll-avatar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-avatar/lists"}