From 8d52c34f1afa3f38e95e34cd1e8f78a2ee7f4c9f Mon Sep 17 00:00:00 2001
From: Nicola Belluti <me@nicolabelluti.me>
Date: Thu, 10 Sep 2026 15:06:20 +0200
Subject: [PATCH] Updated `instruction.md`

---
 assets/css/custom.css             |  4 ++++
 layouts/shortcodes/instruction.md | 16 +++++++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/assets/css/custom.css b/assets/css/custom.css
index 6122366..56ce8ac 100644
--- a/assets/css/custom.css
+++ b/assets/css/custom.css
@@ -1,3 +1,7 @@
 html {
   scroll-padding-top: 5rem;
 }
+
+h3.hx\:sr-only + * {
+  margin-top: 0 !important;
+}
diff --git a/layouts/shortcodes/instruction.md b/layouts/shortcodes/instruction.md
index 22e8bb4..0e9b44f 100644
--- a/layouts/shortcodes/instruction.md
+++ b/layouts/shortcodes/instruction.md
@@ -58,7 +58,18 @@ result is negative, zero, or positive.
 {{- $examples     := .Get "examples" -}}
 {{- $description  := .Inner -}}
 
-### {{ $mnemonic }}
+<!--
+Sligtly edited version of Hextra's `details` shortcode
+<https://github.com/imfing/hextra/blob/main/layouts/_shortcodes/details.html>
+-->
+<details class="hx:last-of-type:mb-0 hx:rounded-lg hx:bg-neutral-50 hx:dark:bg-neutral-800 hx:p-2 hx:mt-4 hx:group">
+  <summary class="hx:flex hx:items-center hx:cursor-pointer hx:select-none hx:list-none hx:p-1 hx:rounded-sm hx:transition-colors hx:hover:bg-gray-100 hx:dark:hover:bg-neutral-800 hx:before:mr-1 hx:before:inline-block hx:before:transition-transform hx:before:content-[''] hx:dark:before:invert hx:rtl:before:rotate-180 hx:group-open:before:rotate-90">
+    <strong class="hx:text-xl">{{ $mnemonic }}</strong>
+  </summary>
+  <div class="hx:p-2 hx:overflow-hidden">
+
+<!-- Hidden heading: For TOC entry and permalink only -->
+### {{ $mnemonic }} {.hx:sr-only}
 
 > {{ $short }}
 
@@ -92,3 +103,6 @@ result is negative, zero, or positive.
 ```
 {{ $examples }}
 ```
+
+  </div>
+</details>