0.19
No release in over 3 years
Low commit activity in last 3 years
@mention support for your Jekyll site
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 12.0
~> 3.0

Runtime

>= 3.7, < 5.0
 Project Readme

Jekyll Mentions

@mentionable support for your Jekyll site

Gem Version Build Status

Usage

Add the following to your site's Gemfile

gem 'jekyll-mentions'

And add the following to your site's _config.yml

plugins:
  - jekyll-mentions

Note: if jekyll --version is less than 3.5 use:

gems:
  - jekyll-mentions

In any page or post, use @mentions as you would normally, e.g.

Hey @benbalter, what do you think of this?

Note: Jekyll Mentions simply turns the @mentions into links, it does not notify the mentioned user.

Configuration

Within the _config.yml

Have your own social network? No problem. We allow you to configure the base URL of all the mentions.

To change it, add the following to your Jekyll configuration:

jekyll-mentions:
  base_url: https://twitter.com

If you're lazy like me, you can use this shorthand:

jekyll-mentions: https://twitter.com

An example of Twitter mentions using jekyll-mentions:

plugins:
  - jekyll-mentions

jekyll-mentions:
  base_url: https://twitter.com

Et voilĂ ! Your mentions will now use that base URL instead of the default of https://github.com.

Within a page's front matter

Now 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:

jekyll-mentions:
  base_url: https://facebook.com

You also can use this shorthand:

jekyll-mentions: https://facebook.com

Now, 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.

If 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:

[@benbalter](https://instagram.com/benbalter)

Now, 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:

jekyll-mentions: false

Now that page/post's mentions will not link to the profiles.