{"id":13612186,"url":"https://github.com/jekyll/jekyll-mentions","last_synced_at":"2025-10-18T03:52:08.505Z","repository":{"id":13366371,"uuid":"16053994","full_name":"jekyll/jekyll-mentions","owner":"jekyll","description":":busts_in_silhouette: @mention support for your Jekyll site","archived":false,"fork":false,"pushed_at":"2023-12-25T11:09:47.000Z","size":14822,"stargazers_count":200,"open_issues_count":6,"forks_count":31,"subscribers_count":7,"default_branch":"main","last_synced_at":"2025-04-01T06:34:25.386Z","etag":null,"topics":["jekyll-plugin"],"latest_commit_sha":null,"homepage":"http://rubygems.org/gems/jekyll-mentions","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":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2014-01-19T20:45:49.000Z","updated_at":"2025-03-02T17:40:12.000Z","dependencies_parsed_at":"2023-12-26T21:23:38.831Z","dependency_job_id":null,"html_url":"https://github.com/jekyll/jekyll-mentions","commit_stats":{"total_commits":175,"total_committers":16,"mean_commits":10.9375,"dds":0.7085714285714286,"last_synced_commit":"f4eec355e0ce212ba9200b7ce9934ab77fa76176"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-mentions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-mentions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-mentions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jekyll%2Fjekyll-mentions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jekyll","download_url":"https://codeload.github.com/jekyll/jekyll-mentions/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247801176,"owners_count":20998339,"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","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":["jekyll-plugin"],"created_at":"2024-08-01T20:00:24.222Z","updated_at":"2025-10-18T03:52:08.445Z","avatar_url":"https://github.com/jekyll.png","language":"Ruby","funding_links":[],"categories":["Text Filters","Ruby"],"sub_categories":[],"readme":"# Jekyll Mentions\n\n@mentionable support for your Jekyll site\n\n[![Gem Version](https://badge.fury.io/rb/jekyll-mentions.svg)](http://badge.fury.io/rb/jekyll-mentions)\n[![Build Status](https://travis-ci.org/jekyll/jekyll-mentions.svg?branch=master)](https://travis-ci.org/jekyll/jekyll-mentions)\n\n## Usage\n\nAdd the following to your site's `Gemfile`\n\n```\ngem 'jekyll-mentions'\n```\n\nAnd add the following to your site's `_config.yml`\n\n```yml\nplugins:\n  - jekyll-mentions\n```\n\nNote: if `jekyll --version` is less than `3.5` use:\n\n```yml\ngems:\n  - jekyll-mentions\n```\n\nIn any page or post, use @mentions as you would normally, e.g.\n\n```markdown\nHey @benbalter, what do you think of this?\n```\n\n**Note**: Jekyll Mentions simply turns the @mentions into links, it does not notify the mentioned user.\n\n## Configuration\n\n### Within the `_config.yml`\n\nHave your own social network? No problem. We allow you to configure the base URL of all the mentions.\n\nTo change it, add the following to your Jekyll configuration:\n\n```yaml\njekyll-mentions:\n  base_url: https://twitter.com\n```\n\nIf you're lazy like me, you can use this shorthand:\n\n```yaml\njekyll-mentions: https://twitter.com\n```\n\nAn example of Twitter mentions using jekyll-mentions:\n\n```yaml\nplugins:\n  - jekyll-mentions\n\njekyll-mentions:\n  base_url: https://twitter.com\n```\n\nEt voilà! Your mentions will now use that base URL instead of the default of `https://github.com`.\n\n### Within a page's front matter\n\nNow do you want to override the base URL for just a single page/post? No problem. Just set the base URL for that specific page in the front matter:\n\n```yaml\njekyll-mentions:\n  base_url: https://facebook.com\n```\n\nYou also can use this shorthand:\n\n```yaml\njekyll-mentions: https://facebook.com\n```\n\nNow, every single mentions in the site will use the base URL defined in the `_config.yml`, _except_ in the file where you set the base URL to be something different.\n\nIf you wish to change the base URL for a single mention, but not every mentions in that file, then you'll have to link to the URL the old-fashioned way:\n\n```markdown\n[@benbalter](https://instagram.com/benbalter)\n```\n\nNow, let's say you have a single file where you _don't_ want your mentions to become mentionable, AKA you want that to stay plain text. You can do that by specifying `false` in the front matter of that file:\n\n```yaml\njekyll-mentions: false\n```\n\nNow that page/post's mentions will not link to the profiles.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-mentions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjekyll%2Fjekyll-mentions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjekyll%2Fjekyll-mentions/lists"}