Add support for GFM admonitions in the blog

Signed-off-by: Harry Mellor <[email protected]>

Author: hmellor

Gemfile

@@ -1,3 +1,6 @@
 source "https://rubygems.org"
 
-gem "github-pages", "~> 232", group: :jekyll_plugins
+group :jekyll_plugins do
+    gem "github-pages", "~> 232"
+    gem "jekyll-gfm-admonitions"
+end

Gemfile.lock

@@ -138,6 +138,8 @@ GEM
       jekyll (>= 3.0, < 5.0)
     jekyll-feed (0.17.0)
       jekyll (>= 3.7, < 5.0)
+    jekyll-gfm-admonitions (0.1.0)
+      jekyll (~> 3.0)
     jekyll-gist (1.5.0)
       octokit (~> 4.2)
     jekyll-github-metadata (2.16.1)
@@ -275,10 +277,12 @@ GEM
 
 PLATFORMS
   arm64-darwin
+  arm64-darwin-24
   x86_64-linux
 
 DEPENDENCIES
   github-pages (~> 232)
+  jekyll-gfm-admonitions
 
 BUNDLED WITH
    2.6.2

README.md

@@ -31,6 +31,30 @@ math block
 $$
 ```
 
+## GitHub Flavored Admonitions
+
+The blog supports GitHub flavored admonitions via [jekyll-gfm-admonition](https://github.com/Helveg/jekyll-gfm-admonitions). It supports the following syntax:
+
+```markdown
+> [!NOTE]
+> Highlights information that users should take into account, even when skimming.
+> And supports multi-line text.
+
+> [!TIP]
+> Optional information to help a user be more successful.
+
+> [!IMPORTANT]
+> Crucial information necessary for users to succeed.
+
+> [!WARNING]
+> Critical content demanding immediate
+> user attention due to potential risks.
+
+> [!CAUTION]
+> Negative potential consequences of an action.
+> Opportunity to provide more context.
+```
+
 ## Theme customization
 
 The theme we are using is [Minima](https://github.com/jekyll/minima). If you need to customise anything from this theme, see [Overriding theme defaults](https://jekyllrb.com/docs/themes/#overriding-theme-defaults).

_config.yml

@@ -17,6 +17,7 @@ remote_theme: jekyll/minima@5ce4006d175e6e5278bb63a0aad1a85e3bf2370b
 plugins:
   - jekyll-feed
   - jekyll-seo-tag
+  - jekyll-gfm-admonitions
 
 # Theme-specific settings