From f4bebc352e7fc21ee4c19f6c43bb961c82170671 Mon Sep 17 00:00:00 2001
From: rjzupkoii <rjzii@yahoo.com>
Date: Sun, 15 Sep 2024 14:16:44 -0400
Subject: [PATCH] Closes #2287, #534 with updates to documentation, better
 emoji generation

---
 Gemfile            | 11 ++++++-----
 _config.yml        |  4 +++-
 _pages/markdown.md |  3 +++
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/Gemfile b/Gemfile
index 2c55ca5d28f51..e784682cea07e 100644
--- a/Gemfile
+++ b/Gemfile
@@ -1,10 +1,11 @@
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 group :jekyll_plugins do
-  gem "jekyll"
-  gem "jekyll-feed"
+  gem 'jekyll'
+  gem 'jekyll-feed'
   gem 'jekyll-sitemap'
-  gem "webrick", "~> 1.8"
+  gem 'jemoji'
+  gem 'webrick', '~> 1.8'
 end
 
-gem "github-pages"
+gem 'github-pages'
diff --git a/_config.yml b/_config.yml
index a57b8a62eb4bb..8c3478cfd501d 100644
--- a/_config.yml
+++ b/_config.yml
@@ -312,7 +312,9 @@ plugins:
   - jekyll-gist
   - jekyll-feed
   - jekyll-redirect-from
-# mimic GitHub Pages with --safe
+  - jemoji
+
+# Mimic GitHub Pages with --safe
 whitelist:
   - jekyll-paginate
   - jekyll-sitemap
diff --git a/_pages/markdown.md b/_pages/markdown.md
index 09f2ae2545b2c..83f060f145915 100644
--- a/_pages/markdown.md
+++ b/_pages/markdown.md
@@ -30,6 +30,9 @@ redirect_from:
   * Orange circle: building
   * Red X: error
   * No icon: not built
+* Academic Pages uses [Jekyll Kramdown](https://jekyllrb.com/docs/configuration/markdown/), GitHub Flavored Markdown (GFM) parser, which is similar to the version of Markdown used on GitHub, but may have some minor differences. 
+  * Some of emoji supported on GitHub should be supposed via the [Jemoji](https://github.com/jekyll/jemoji) plugin :computer:.
+  * The best list of the supported emoji can be found in the [Emojis for Jekyll via Jemoji](https://www.fabriziomusacchio.com/blog/2021-08-16-emojis_for_Jekyll/#computer) blog post.
 
 ## Resources
  * [Liquid syntax guide](https://shopify.github.io/liquid/tags/control-flow/)