You can use @mentions within any Jekyll page or post, just like you would in a comment or issue within a repository.

Setting up

To enable @mentions, you must add the following line to your site's _config.yml file:

gems:
  - jekyll-mentions

If you don't have a _config.yml file, you will need to create one in the root of your GitHub Enterprise Pages repository. For more information, see the Jekyll documentation.

The GitHub Pages website lists the exact versions of the plugins used by the GitHub Enterprise Pages server.

Usage

@mention a user within your Jekyll posts or pages as you would elsewhere on your GitHub Enterprise instance.

@mentions link the mention to the user's GitHub Enterprise profile. However, they don't notify the user.

Testing locally

To preview the output of @mentions locally:

@mentions are currently only supported in the page and post body. @mentions within includes, layouts, and other sources of content may not render properly.

For more information, see The Jekyll Mentions Gem.