@mentionable support for your Jekyll site
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.
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
.
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.