Merge 2fb6f63b41 into 1313415c8b

.devcontainer/devcontainer.json

@@ -3,7 +3,7 @@
   "features": {
     "ghcr.io/devcontainers/features/hugo:1": {
       "extended": true,
-      "version": "0.131.0"
+      "version": "0.124.1"
     },
     "ghcr.io/devcontainers/features/node:1": {}
   },

.github/FUNDING.yml

@@ -1,15 +0,0 @@
-# These are supported funding model platforms
-
-github: imfing
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
-polar: # Replace with a single Polar username
-buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
-thanks_dev: # Replace with a single thanks.dev username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/ISSUE_TEMPLATE/bug_report.md

@@ -17,8 +17,6 @@ assignees: ''
 2. 
 3. 
 
-<!-- Provide a minimal example or link to a repository that reproduces the bug -->
-
 **Expected Behavior**
 
 <!-- What should have happened? -->

.github/workflows/pages.yml

@@ -31,7 +31,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.138.0
+      HUGO_VERSION: 0.126.1
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -41,10 +41,10 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.23'
+          go-version: '1.22'
       - name: Setup Pages
         id: pages
-        uses: actions/configure-pages@v5
+        uses: actions/configure-pages@v4
       - name: Setup Hugo
         run: |
           wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
@@ -54,12 +54,11 @@ jobs:
           # For maximum backward compatibility with Hugo modules
           HUGO_ENVIRONMENT: production
           HUGO_ENV: production
-        # Use the latest release of the theme to build exampleSite
         run: |
-          cd exampleSite && rm go.mod
+          hugo \
-          hugo mod init github.com/imfing/hextra/exampleSite
+            --minify \
-          hugo mod get -u github.com/imfing/hextra
+            --themesDir=../.. --source=exampleSite \
-          hugo --minify --baseURL "${{ steps.pages.outputs.base_url }}/"
+            --baseURL "${{ steps.pages.outputs.base_url }}/"
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:

.prettierrc

@@ -1,7 +1,4 @@
 {
-  "plugins": [
-    "prettier-plugin-go-template"
-  ],
   "goTemplateBracketSpacing": true,
   "htmlWhitespaceSensitivity": "css",
   "printWidth": 200,

README.zh-cn.md

@@ -21,7 +21,7 @@
 - **响应式布局和深色模式支持** - 在任何设备上看起来都足够美观, 无论是手机, 平板电脑或者电脑. 深色模式的支持使 Hextra 可以应对各种照明环境.
 - **快速且轻量** - 由 Hugo 强力支持, Hugo 是一个快如闪电的静态站点生成器, 这一切都只需一个可执行文件, Hextra 始终保持最小化, 无需 Javascript 或者 Node.js.
 - **全文搜索** - 集成了 Flexsearch 的全文搜索, 无需额外的配置.
-- **功能齐全** - Markdown, 代码高亮, LaTex 数学公式, diagrams 图表和 Shortcodes 都可以用于丰富你的内容. 目录, 面包屑导航, 分页, 侧边栏等均由 Hextra 自动生成。
+- **网站中的瑞士军刀** - Markdown, 代码高亮, LaTex 数学公式, diagrams 图表和 Shortcodes 都可以用于丰富你的内容. 目录, 面包屑导航, 分页, 侧边栏等均由 Hextra 自动生成。
 - **多语言和 SEO Ready** - Hugo 的多语言模式使得构建多语言网站更简单. 具有 SEO tags, Open Graph, 和 Twitter Cards 等诸多开箱即用的功能.
 
 ## 快速开始

assets/css/components/badge.css

@@ -1,3 +0,0 @@
-.hextra-badge {
-  @apply hx-inline-flex hx-items-center;
-}

assets/css/components/cards.css

@@ -2,10 +2,6 @@
   grid-template-columns: repeat(auto-fill, minmax(max(250px, calc((100% - 1rem * 2) / var(--hextra-cards-grid-cols))), 1fr));
 }
 
-.hextra-card {
-  position: relative;
-}
-
 .hextra-card img {
   user-select: none;
 }
@@ -22,7 +18,6 @@
 
 .hextra-card p {
   margin-top: 0.5rem;
-  position: relative;
 }
 
 .dark .hextra-card svg {
@@ -32,10 +27,3 @@
 .dark .hextra-card:hover svg {
   color: currentColor;
 }
-
-.hextra-card-tag {
-  position: absolute;
-  top: 5px;
-  right: 5px;
-  z-index: 10;
-}

assets/css/components/jupyter.css

@@ -1,17 +0,0 @@
-.hextra-jupyter-code-cell {
-  scrollbar-gutter: auto;
-
-  @apply hx-mt-6;
-
-  .hextra-jupyter-code-cell-outputs-container {
-    @apply hx-text-xs hx-overflow-hidden;
-
-    .hextra-jupyter-code-cell-outputs {
-      @apply hx-overflow-auto hx-max-h-[50vh];
-
-      pre {
-        @apply hx-text-xs hx-overflow-auto hx-max-w-full;
-      }
-    }
-  }
-}

assets/css/components/scrollbar.css

@@ -1,4 +1,4 @@
-.hextra-scrollbar, .hextra-scrollbar * {
+.hextra-scrollbar {
   scrollbar-width: thin; /* Firefox */
   scrollbar-color: oklch(55.55% 0 0 / 40%) transparent; /* Firefox */
 

assets/css/components/sidebar.css

@@ -1,5 +1,5 @@
 @media (max-width: 767px) {
-  .hextra-sidebar-container {
+  .sidebar-container {
     @apply hx-fixed hx-pt-[calc(var(--navbar-height))] hx-top-0 hx-w-full hx-bottom-0 hx-z-[15] hx-overscroll-contain hx-bg-white dark:hx-bg-dark;
     transition: transform 0.8s cubic-bezier(0.52, 0.16, 0.04, 1);
     will-change: transform, opacity;
@@ -8,7 +8,7 @@
   }
 }
 
-.hextra-sidebar-container {
+.sidebar-container {
   li > div {
     @apply hx-h-0;
   }
@@ -18,19 +18,4 @@
   li.open > a > span > svg > path {
     @apply hx-rotate-90;
   }
-
-  .hextra-sidebar-item-list {
-    @apply hx-relative hx-flex hx-flex-col hx-gap-1 before:hx-absolute before:hx-inset-y-1 before:hx-w-px before:hx-bg-gray-200 ltr:hx-ml-3 ltr:hx-pl-3 ltr:before:hx-left-0 rtl:hx-mr-3 rtl:hx-pr-3 rtl:before:hx-right-0 dark:before:hx-bg-neutral-800;
-  }
-
-  .hextra-sidebar-item-link {
-    @apply hx-flex hx-items-center hx-justify-between hx-gap-2 hx-cursor-pointer hx-rounded hx-px-2 hx-py-1.5 hx-text-sm hx-transition-colors;
-
-    &.active {
-      @apply hx-bg-primary-100 hx-font-semibold hx-text-primary-800 contrast-more:hx-border contrast-more:hx-border-primary-500 dark:hx-bg-primary-400/10 dark:hx-text-primary-600 contrast-more:dark:hx-border-primary-500;
-    }
-    &.inactive {
-      @apply hx-text-gray-500 hover:hx-bg-gray-100 hover:hx-text-gray-900 contrast-more:hx-border contrast-more:hx-border-transparent contrast-more:hx-text-gray-900 contrast-more:hover:hx-border-gray-900 dark:hx-text-neutral-400 dark:hover:hx-bg-primary-100/5 dark:hover:hx-text-gray-50 contrast-more:dark:hx-text-gray-50 contrast-more:dark:hover:hx-border-gray-50;
-    }
-  }
 }

assets/css/styles.css

@@ -10,8 +10,6 @@
 @import "components/scrollbar.css";
 @import "components/code-copy.css";
 @import "components/hextra/feature-grid.css";
-@import "components/jupyter.css";
-@import "components/badge.css";
 
 html {
   @apply hx-text-base hx-antialiased;
@@ -26,7 +24,6 @@ body {
 :root {
   --primary-hue: 212deg;
   --primary-saturation: 100%;
-  --primary-lightness: 50%;
   --navbar-height: 4rem;
   --menu-height: 3.75rem;
 }
@@ -34,5 +31,4 @@ body {
 .dark {
   --primary-hue: 204deg;
   --primary-saturation: 100%;
-  --primary-lightness: 50%;
 }

assets/js/flexsearch.js

@@ -200,7 +200,7 @@ document.addEventListener("DOMContentLoaded", function () {
       cache: 100,
       document: {
         id: 'id',
-        store: ['title', 'crumb'],
+        store: ['title'],
         index: "content"
       }
     });
@@ -210,7 +210,7 @@ document.addEventListener("DOMContentLoaded", function () {
       cache: 100,
       document: {
         id: 'id',
-        store: ['title', 'content', 'url', 'display', 'crumb'],
+        store: ['title', 'content', 'url', 'display'],
         index: "content",
         tag: 'pageId'
       }
@@ -222,30 +222,6 @@ document.addEventListener("DOMContentLoaded", function () {
     for (const route in data) {
       let pageContent = '';
       ++pageId;
-      const urlParts = route.split('/').filter(x => x != "" && !x.startsWith('#'));
-
-      let crumb = '';
-      let searchUrl = '/'
-      for (let i = 0; i < urlParts.length; i++) {
-        const urlPart = urlParts[i];
-        searchUrl += urlPart + '/'
-
-        const crumbData = data[searchUrl];
-        if (!crumbData) {
-          console.warn('Excluded page', searchUrl, '- will not be included for search result breadcrumb for', route);
-          continue;
-        }
-
-        let title = data[searchUrl].title;
-        if (title == "_index") {
-          title = urlPart.split("-").map(x => x).join(" ");
-        }
-        crumb += title;
-
-        if (i < urlParts.length - 1) {
-          crumb += ' > ';
-        }
-      }
 
       for (const heading in data[route].data) {
         const [hash, text] = heading.split('#');
@@ -259,7 +235,6 @@ document.addEventListener("DOMContentLoaded", function () {
           id: url,
           url,
           title,
-          crumb,
           pageId: `page_${pageId}`,
           content: title,
           ...(paragraphs[0] && { display: paragraphs[0] })
@@ -270,7 +245,6 @@ document.addEventListener("DOMContentLoaded", function () {
             id: `${url}_${i}`,
             url,
             title,
-            crumb,
             pageId: `page_${pageId}`,
             content: paragraphs[i]
           });
@@ -282,7 +256,6 @@ document.addEventListener("DOMContentLoaded", function () {
       window.pageIndex.add({
         id: pageId,
         title: data[route].title,
-        crumb,
         content: pageContent
       });
 
@@ -335,7 +308,7 @@ document.addEventListener("DOMContentLoaded", function () {
           _page_rk: i,
           _section_rk: j,
           route: url,
-          prefix: isFirstItemOfPage ? result.doc.crumb : undefined,
+          prefix: isFirstItemOfPage ? result.doc.title : undefined,
           children: { title, content }
         })
         isFirstItemOfPage = false

assets/js/menu.js

@@ -3,7 +3,7 @@
 document.addEventListener('DOMContentLoaded', function () {
   const menu = document.querySelector('.hamburger-menu');
   const overlay = document.querySelector('.mobile-menu-overlay');
-  const sidebarContainer = document.querySelector('.hextra-sidebar-container');
+  const sidebarContainer = document.querySelector('.sidebar-container');
 
   // Initialize the overlay
   const overlayClasses = ['hx-fixed', 'hx-inset-0', 'hx-z-10', 'hx-bg-black/80', 'dark:hx-bg-black/60'];

assets/js/sidebar.js

@@ -1,78 +1,12 @@
-/**
- * Check if the element is visible.
- * @param {Element} element Dom element
- * @returns boolean
- */
-function isVisible(element) {
-  return element.offsetWidth > 0 || element.offsetHeight > 0;
-}
-
 document.addEventListener("DOMContentLoaded", function () {
-  scrollToActiveItem();
-  enableCollapsibles();
-});
-
-function enableCollapsibles() {
   const buttons = document.querySelectorAll(".hextra-sidebar-collapsible-button");
   buttons.forEach(function (button) {
     button.addEventListener("click", function (e) {
       e.preventDefault();
       const list = button.parentElement.parentElement;
       if (list) {
-        list.classList.toggle("open");
+        list.classList.toggle("open")
       }
     });
   });
-
+});
-  const isCached = "{{- site.Params.page.sidebar.cache | default false -}}" === "true";
-  const currentPagePath = window.location.href;
-
-  if (isCached) {
-    // find the current page in the sidebar and open the parent lists
-    const sidebar = document.querySelector(".hextra-sidebar-container");
-    if (sidebar) {
-      // find a tags and compare href with current page path
-      const links = sidebar.querySelectorAll("a");
-      links.forEach(function (link) {
-        const linkPath = link.href;
-
-        if (currentPagePath === linkPath) {
-          // add active class to the link
-          link.classList.add("active");
-          link.classList.remove("inactive");
-
-          if (!isVisible(link)) {
-            return;
-          }
-          // recursively open parent lists
-          let parent = link.parentElement;
-          while (parent && !parent.classList.contains("hextra-sidebar-container")) {
-            if (parent.tagName === "LI" && parent.classList.contains("hextra-sidebar-item")) {
-              parent.classList.add("open");
-            }
-            parent = parent.parentElement;
-          }
-        }
-      });
-    }
-  }
-}
-
-function scrollToActiveItem() {
-  const sidebarScrollbar = document.querySelector("aside.sidebar-container > .hextra-scrollbar");
-  const activeItems = document.querySelectorAll(".sidebar-active-item");
-  const visibleActiveItem = Array.from(activeItems).find(function (activeItem) {
-    return activeItem.getBoundingClientRect().height > 0;
-  });
-
-  if (!visibleActiveItem) {
-    return;
-  }
-
-  const yOffset = visibleActiveItem.clientHeight;
-  const yDistance = visibleActiveItem.getBoundingClientRect().top - sidebarScrollbar.getBoundingClientRect().top;
-  sidebarScrollbar.scrollTo({
-    behavior: "instant",
-    top: yDistance - yOffset,
-  });
-}

assets/js/tabs.js

@@ -1,14 +1,14 @@
-document.querySelectorAll('.hextra-tabs-toggle').forEach(function (button) {
+document.querySelectorAll('.tabs-toggle').forEach(function (button) {
   button.addEventListener('click', function (e) {
     // set parent tabs to unselected
-    const tabs = Array.from(e.target.parentElement.querySelectorAll('.hextra-tabs-toggle'));
+    const tabs = Array.from(e.target.parentElement.querySelectorAll('.tabs-toggle'));
     tabs.map(tab => tab.dataset.state = '');
 
     // set current tab to selected
     e.target.dataset.state = 'selected';
 
     // set all panels to unselected
-    const panelsContainer = e.target.parentElement.parentElement.nextElementSibling;
+    const panelsContainer = e.target.parentElement.nextElementSibling;
     Array.from(panelsContainer.children).forEach(function (panel) {
       panel.dataset.state = '';
     });

data/icons.yaml

@@ -36,8 +36,6 @@ hugo-full: >
     <path fill="#fff" d="M1320.72 89.15c58.79 0 106.52 47.73 106.52 106.51 0 58.8-47.73 106.52-106.52 106.52-58.78 0-106.52-47.73-106.52-106.52 0-58.78 47.74-106.51 106.52-106.51zm0 39.57c36.95 0 66.94 30 66.94 66.94a66.97 66.97 0 0 1-66.94 66.94c-36.95 0-66.94-29.99-66.94-66.94a66.97 66.97 0 0 1 66.93-66.94h.01zm-283.8 65.31c0 47.18-8.94 60.93-26.81 80.58-17.87 19.65-41.57 27.57-71.1 27.57-27 0-48.75-9.58-67.61-26.23-20.88-18.45-36.08-47.04-36.08-78.95 0-31.37 11.72-58.48 32.49-78.67 18.22-17.67 45.34-29.18 73.3-29.18 33.77 0 68.83 15.98 90.44 47.53l-31.73 26.82c-13.45-25.03-32.94-33.46-60.82-34.26-30.83-.88-64.77 28.53-62.25 67.75 1.4 21.94 11.65 59.65 60.96 66.57 25.9 3.63 55.36-24.02 55.36-39.04H944.4v-37.5h92.5V194l.02.03zm-562.6-94.65h42.29v112.17c0 17.8.49 29.33 1.47 34.61 1.69 8.48 4.81 14.37 11.17 19.5 6.37 5.13 13.8 6.59 24.84 6.59 11.2 0 14.96-1.74 20.66-6.6 5.69-4.85 9.12-9.46 10.28-16.53 1.15-7.07 3.07-18.8 3.07-35.18V99.38h42.28v108.78c0 24.86-1.07 42.43-3.21 52.69-2.14 10.27-6.08 18.93-11.82 26-5.74 7.06-13.42 12.69-23.03 16.88-9.62 4.19-22.16 6.28-37.65 6.28-18.7 0-32.87-2.28-42.52-6.85-9.66-4.57-17.3-10.5-22.9-17.8-5.61-7.3-9.3-14.95-11.08-22.96-2.58-11.86-3.88-29.38-3.88-52.55V99.38h.03zM93.91 299.92V92.7h43.35v75.48h71.92V92.7h43.48v207.22h-43.48v-90.61h-71.92v90.61z"/>
   </svg>
 
-jupyter: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M7.157 22.201A1.784 1.799 0 0 1 5.374 24a1.784 1.799 0 0 1-1.784-1.799a1.784 1.799 0 0 1 1.784-1.799a1.784 1.799 0 0 1 1.783 1.799M20.582 1.427a1.415 1.427 0 0 1-1.415 1.428a1.415 1.427 0 0 1-1.416-1.428A1.415 1.427 0 0 1 19.167 0a1.415 1.427 0 0 1 1.415 1.427M4.992 3.336A1.047 1.056 0 0 1 3.946 4.39a1.047 1.056 0 0 1-1.047-1.055A1.047 1.056 0 0 1 3.946 2.28a1.047 1.056 0 0 1 1.046 1.056m7.336 1.517c3.769 0 7.06 1.38 8.768 3.424a9.36 9.36 0 0 0-3.393-4.547a9.24 9.24 0 0 0-5.377-1.728A9.24 9.24 0 0 0 6.95 3.73a9.36 9.36 0 0 0-3.394 4.547c1.713-2.04 5.004-3.424 8.772-3.424m.001 13.295c-3.768 0-7.06-1.381-8.768-3.425a9.36 9.36 0 0 0 3.394 4.547A9.24 9.24 0 0 0 12.33 21a9.24 9.24 0 0 0 5.377-1.729a9.36 9.36 0 0 0 3.393-4.547c-1.712 2.044-5.003 3.425-8.772 3.425Z" /></svg>
-
 warning: <svg xmlns="http://www.w3.org/2000/svg" fill="none" stroke="currentColor" stroke-width="1.5" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m-9.303 3.376c-.866 1.5.217 3.374 1.948 3.374h14.71c1.73 0 2.813-1.874 1.948-3.374L13.949 3.378c-.866-1.5-3.032-1.5-3.898 0L2.697 16.126zM12 15.75h.007v.008H12v-.008z"></path></svg>
 one: <svg xmlns="http://www.w3.org/2000/svg" fill="currentColor" viewBox="-1 0 19 19"><path d="M16.417 9.6A7.917 7.917 0 1 1 8.5 1.683 7.917 7.917 0 0 1 16.417 9.6zM9.666 6.508H8.248L6.09 8.09l.806 1.103 1.222-.945v4.816h1.547z"></path></svg>
 cards: <svg xmlns="http://www.w3.org/2000/svg" fill="none" stroke="currentColor" stroke-width="1.5" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" d="M6 6.878V6a2.25 2.25 0 0 1 2.25-2.25h7.5A2.25 2.25 0 0 1 18 6v.878m-12 0c.235-.083.487-.128.75-.128h10.5c.263 0 .515.045.75.128m-12 0A2.25 2.25 0 0 0 4.5 9v.878m13.5-3A2.25 2.25 0 0 1 19.5 9v.878m0 0a2.246 2.246 0 0 0-.75-.128H5.25c-.263 0-.515.045-.75.128m15 0A2.25 2.25 0 0 1 21 12v6a2.25 2.25 0 0 1-2.25 2.25H5.25A2.25 2.25 0 0 1 3 18v-6c0-.98.626-1.813 1.5-2.122"></path></svg>
@@ -289,4 +287,3 @@ youtube: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill=
 x-twitter: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><path fill="currentColor" d="M389.2 48h70.6L305.6 224.2 487 464H345L233.7 318.6 106.5 464H35.8L200.7 275.5 26.8 48H172.4L272.9 180.9 389.2 48zM364.4 421.8h39.1L151.1 88h-42L364.4 421.8z"/></svg>
 linkedin: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M20.447 20.452h-3.554v-5.569c0-1.328-.027-3.037-1.852-3.037c-1.853 0-2.136 1.445-2.136 2.939v5.667H9.351V9h3.414v1.561h.046c.477-.9 1.637-1.85 3.37-1.85c3.601 0 4.267 2.37 4.267 5.455v6.286zM5.337 7.433a2.062 2.062 0 0 1-2.063-2.065a2.064 2.064 0 1 1 2.063 2.065zm1.782 13.019H3.555V9h3.564v11.452zM22.225 0H1.771C.792 0 0 .774 0 1.729v20.542C0 23.227.792 24 1.771 24h20.451C23.2 24 24 23.227 24 22.271V1.729C24 .774 23.2 0 22.222 0h.003z"/></svg>
 slack: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="currentColor" d="M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52zm1.271 0a2.527 2.527 0 0 1 2.521-2.52a2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522zM8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52zm0 1.271a2.528 2.528 0 0 1 2.521 2.521a2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521zm10.122 2.521a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522zm-1.268 0a2.528 2.528 0 0 1-2.523 2.521a2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522zm-2.523 10.122a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522zm0-1.268a2.527 2.527 0 0 1-2.52-2.523a2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523z" /></svg>
-bluesky: <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 530"><path fill="currentColor" d="M136 44c66 50 138 151 164 205 26-54 98-155 164-205 48-36 126-64 126 25 0 18-10 149-16 170-21 74-96 93-163 81 117 20 147 86 82 153-122 125-176-32-189-72-3-8-4-11-4-8 0-3-1 0-4 8-13 40-67 197-189 72-65-67-35-133 82-153-67 12-142-7-163-81-6-21-16-152-16-170 0-89 78-61 126-25z"/></svg>

exampleSite/content/docs/advanced/customization.md

@@ -34,138 +34,15 @@ The color of text mixed with `other text` can customized with:
 
 ### Primary Color
 
-The primary color of the theme can be customized by setting the `--primary-hue`, `--primary-saturation` and `--primary-lightness` variables:
+The primary color of the theme can be customized by setting the `--primary-hue` and `--primary-saturation` variables:
 
 ```css {filename="assets/css/custom.css"}
 :root {
   --primary-hue: 100deg;
   --primary-saturation: 90%;
-  --primary-lightness: 50%;
 }
 ```
 
-### Further Theme Customization
-
-The theme can be further customized by overriding the default styles via the exposed css classes. An example for customizing the footer element:
-
-```css {filename="assets/css/custom.css"}
-.hextra-footer {
-  /* Styles will be applied to the footer element */
-}
-
-.hextra-footer:is(html[class~="dark"] *) {
-  /* Styles will be applied to the footer element in dark mode */
-}
-```
-
-The following classes can be used to customize various parts of the theme.
-
-#### General
-
-- `hextra-scrollbar` - The scrollbar element
-- `content` - Page content container
-
-#### Shortcodes
-
-##### Badge
-
-- `hextra-badge` - The badge element
-
-##### Card
-
-- `hextra-card` - The card element
-- `hextra-card-image` - The card image element
-- `hextra-card-icon` - The card icon element
-- `hextra-card-subtitle` - The card subtitle element
-
-##### Cards
-
-- `hextra-cards` - The cards grid container
-
-##### Jupyter Notebook
-
-- `hextra-jupyter-code-cell` - The Jupyter code cell container
-- `hextra-jupyter-code-cell-outputs-container` - The Jupyter code cell outputs container
-- `hextra-jupyter-code-cell-outputs` - The Jupyter code cell output div element
-
-##### PDF
-
-- `hextra-pdf` - The PDF container element
-
-##### Steps
-
-- `steps` - The steps container
-
-##### Tabs
-
-- `hextra-tabs-panel` - The tabs panel container
-- `hextra-tabs-toggle` - The tabs toggle button
-
-##### Filetree
-
-- `hextra-filetree` - The filetree container
-
-##### Folder
-
-- `hextra-filetree-folder` - The filetree folder container
-
-#### Navbar
-
-- `nav-container` - The navbar container
-- `nav-container-blur` - The navbar container in blur element
-- `hamburger-menu` - The hamburger menu button
-
-#### Footer
-
-- `hextra-footer` - The footer element
-- `hextra-custom-footer` - The custom footer section container
-
-#### Search
-
-- `search-wrapper` - The search wrapper container
-- `search-input` - The search input element
-- `search-results` - The search results list container
-
-#### Table of Contents
-
-- `hextra-toc` - The table of contents container
-
-#### Sidebar
-
-- `mobile-menu-overlay` - The overlay element for the mobile menu
-- `sidebar-container` - The sidebar container
-- `sidebar-active-item` - The active item in the sidebar
-
-#### Language Switcher
-
-- `language-switcher` - The language switcher button
-- `language-options` - The language options container
-
-#### Theme Toggle
-
-- `theme-toggle` - The theme toggle button
-
-#### Cody Copy Button
-
-- `hextra-code-copy-btn-container` - The code copy button container
-- `hextra-code-copy-btn` - The code copy button
-
-#### Code Block
-
-- `hextra-code-block` - The code block container
-
-#### Feature Card
-
-- `hextra-feature-card` - The feature card link element
-
-#### Feature Grid
-
-- `hextra-feature-grid` - The feature grid container
-
-#### Breadcrumbs
-
-No specific class is available for breadcrumbs.
-
 ### Syntax Highlighting
 
 List of available syntax highlighting themes are available at [Chroma Styles Gallery](https://xyproto.github.io/splash/docs/all.html). The stylesheet can be generated using the command:
@@ -184,28 +61,13 @@ You may add custom scripts to the end of the head for every page by adding the f
 layouts/partials/custom/head-end.html
 ```
 
-## Custom Extra Section in Footer
-
-You can add extra section in the footer by creating a file `layouts/partials/custom/footer.html` in your site.
-
-```html {filename="layouts/partials/custom/footer.html"}
-<!-- Your footer element here -->
-```
-
-The added section will be added before the copyright section in the footer.
-You can use [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML) and [Hugo template syntax](https://gohugo.io/templates/) to add your own content.
-
-Hugo variables available in the footer section are: `.switchesVisible` and `.copyrightVisible`.
-
 ## Custom Layouts
 
 The layouts of the theme can be overridden by creating a file with the same name in the `layouts` directory of your site.
 For example, to override the `single.html` layout for docs, create a file `layouts/docs/single.html` in your site.
 
-For further information, refer to the [Hugo Templates][hugo-template-docs].
+For further information, refer to the [Hugo Templates](https://gohugo.io/templates/).
 
 ## Further Customization
 
 Didn't find what you were looking for? Feel free to [open a discussion](https://github.com/imfing/hextra/discussions) or make a contribution to the theme!
-
-[hugo-template-docs]: https://gohugo.io/templates/

exampleSite/content/docs/guide/configuration.md

@@ -87,7 +87,7 @@ params:
 
 ### Main Sidebar
 
-By default, the main sidebar is automatically generated from the structure of the content directory.
+For the main sidebar, it is automatically generated from the structure of the content directory.
 See the [Organize Files](/docs/guide/organize-files) page for more details.
 
 To exclude a single page from the left sidebar, set the `sidebar.exclude` parameter in the front matter of the page:
@@ -119,33 +119,6 @@ menu:
       weight: 3
 ```
 
-### Sidebar from Data
-
-Alternatively, you can define the sidebar structure in the `data` directory. This gives you more flexibility to define sidebar differently than your content structure. To enable this, set the `params.sidebar.source` parameter in the config file to `data`:
-
-```yaml {filename="hugo.yaml"}
-params:
-  sidebar:
-    source: data
-```
-
-To define the sidebar data, create a file named `sidebar.yaml` in the `data` directory.
-
-```yaml {filename="data/sidebar.yaml"}
-docs:
-  - title: Documentation
-    link: /docs/
-  - title: Guide
-    link: /docs/guide/
-    open: false
-    items:
-      - title: Configuration
-        link: /docs/guide/configuration/
-  # ...
-```
-
-If your site is multilingual, you can define the sidebar data for each language, for example in `data/en/sidebar.yaml` file.
-
 ## Right Sidebar
 
 ### Table of Contents
@@ -213,10 +186,10 @@ To customize the [favicon](https://en.wikipedia.org/wiki/Favicon) for your site,
   {{< /filetree/folder >}}
 {{< /filetree/container >}}
 
-Include `favicon.ico`, `favicon.svg` and `favicon-dark.svg` files in your project to ensure your site's favicons display correctly.
+Include both `favicon.ico` and `favicon.svg` files in your project to ensure your site's favicons display correctly.
 
-While `favicon.ico` is generally for older browsers, `favicon.svg` and `favicon-dark.svg` are supported by modern browsers.
+While `favicon.ico` is generally for older browsers, `favicon.svg` is supported by modern ones. The optional `favicon-dark.svg` can be included for a tailored experience in dark mode.
-Use tools like [favicon.io](https://favicon.io/) or [favycon](https://github.com/ruisaraiva19/favycon) to generate such icons.
+Feel free to use tools like [favicon.io](https://favicon.io/) or [favycon](https://github.com/ruisaraiva19/favycon) to generate these icons.
 
 ### Theme Configuration
 

exampleSite/content/docs/guide/deploy-site.md

@@ -54,7 +54,7 @@ jobs:
   build:
     runs-on: ubuntu-latest
     env:
-      HUGO_VERSION: 0.138.0
+      HUGO_VERSION: 0.121.2
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -64,7 +64,7 @@ jobs:
       - name: Setup Go
         uses: actions/setup-go@v5
         with:
-          go-version: '1.22'
+          go-version: '1.21'
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v4
@@ -146,7 +146,7 @@ For more details, check out:
 3. If you are not using [hextra-starter-template][hextra-starter-template], configure the following manually:
    - Configure the Build command to `hugo --gc --minify`
    - Specify the Publish directory to `public`
-   - Add Environment variable `HUGO_VERSION` and set to `0.138.0`, or alternatively, set it in `netlify.toml` file
+   - Add Environment variable `HUGO_VERSION` and set to `0.119.0`
 4. Deploy!
 
 Check [Hugo on Netlify](https://docs.netlify.com/integrations/frameworks/hugo/) for more details.

exampleSite/content/docs/guide/markdown.fa.md

@@ -117,18 +117,18 @@ Hugo از سینتکس [مارک‌داون](https://en.wikipedia.org/wiki/Markd
 
 ### عکس‌ها
 
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 ```
 
 با توضیحات:
 
-![landscape](https://picsum.photos/800/600 "یک چشم‌انداز Unsplash")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "یک چشم‌انداز Unsplash")
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600 "یک چشم‌انداز Unsplash")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "یک چشم‌انداز Unsplash")
 ```
 
 ## پیکربندی

exampleSite/content/docs/guide/markdown.md

@@ -35,46 +35,6 @@ Blockquote with attribution
 [^1]: The above quote is excerpted from Rob Pike's [talk](https://www.youtube.com/watch?v=PAAkCSZUG1c) during Gopherfest, November 18, 2015.
 ```
 
-### Alerts
-
-{{< new-feature version="v0.9.0" >}}
-
-Alerts are a Markdown extension based on the blockquote syntax that you can use to emphasize critical information.
-[GitHub-style alerts](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) are supported.
-Please make sure you are using the latest version of Hextra and [Hugo v0.134.0](https://github.com/gohugoio/hugo/releases/tag/v0.134.0) or later.
-
-> [!NOTE]
-> Useful information that users should know, even when skimming content.
-
-> [!TIP]
-> Helpful advice for doing things better or more easily.
-
-> [!IMPORTANT]
-> Key information users need to know to achieve their goal.
-
-> [!WARNING]
-> Urgent info that needs immediate user attention to avoid problems.
-
-> [!CAUTION]
-> Advises about risks or negative outcomes of certain actions.
-
-```markdown {filename=Markdown}
-> [!NOTE]
-> Useful information that users should know, even when skimming content.
-
-> [!TIP]
-> Helpful advice for doing things better or more easily.
-
-> [!IMPORTANT]
-> Key information users need to know to achieve their goal.
-
-> [!WARNING]
-> Urgent info that needs immediate user attention to avoid problems.
-
-> [!CAUTION]
-> Advises about risks or negative outcomes of certain actions.
-```
-
 ### Tables
 
 Tables aren't part of the core Markdown spec, but Hugo supports them out-of-the-box.
@@ -157,18 +117,18 @@ Tables aren't part of the core Markdown spec, but Hugo supports them out-of-the-
 
 ### Images
 
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 ```
 
 With caption:
 
-![landscape](https://picsum.photos/800/600 "Unsplash Landscape")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "Unsplash Landscape")
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600 "Unsplash Landscape")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "Unsplash Landscape")
 ```
 
 ## Configuration

exampleSite/content/docs/guide/markdown.zh-cn.md

@@ -117,18 +117,18 @@ Hugo 支持 [Markdown](https://en.wikipedia.org/wiki/Markdown) 来书写内容
 
 ### 图片
 
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600)
+![landscape](https://source.unsplash.com/featured/800x600?landscape)
 ```
 
 带有标题：
 
-![landscape](https://picsum.photos/800/600 "Unsplash Landscape")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "Unsplash Landscape")
 
 ```markdown {filename=Markdown}
-![landscape](https://picsum.photos/800/600 "Unsplash Landscape")
+![landscape](https://source.unsplash.com/featured/800x600?landscape "Unsplash Landscape")
 ```
 
 ## 配置

exampleSite/content/docs/guide/organize-files.md

@@ -112,7 +112,7 @@ Documentation > Guide > Foo Bar
 
 ### Hiding Breadcrumbs
 
-You can hide breadcrumbs completely from a page by specifying `breadcrumbs: false` in its front matter:
+You can hide breadcrumbs completely from a page by specfying `breadcrumbs: false` in its front matter:
 
 ```yaml {filename="content/docs/guide/organize-files.md"}
 ---

exampleSite/content/docs/guide/organize-files.zh-cn.md

@@ -6,7 +6,7 @@ prev: /docs/guide
 
 ## 目录结构
 
-默认情况下，Hugo 在 `content` 目录中搜索 Markdown 文件，目录的结构决定了网站的最终输出结构。
+默认情况下，Hugo 在 `context` 目录中搜索 Markdown 文件，目录的结构决定了网站的最终输出结构。
 以示例网站为例：
 
 <!--more-->

exampleSite/content/docs/guide/shortcodes/_index.md

@@ -9,6 +9,7 @@ next: /docs/guide/shortcodes/callout
 
 Hextra provides a collection of beautiful shortcodes to enhance your content.
 
+
 {{< cards >}}
   {{< card link="callout" title="Callout" icon="warning" >}}
   {{< card link="cards" title="Cards" icon="card" >}}
@@ -18,12 +19,3 @@ Hextra provides a collection of beautiful shortcodes to enhance your content.
   {{< card link="steps" title="Steps" icon="one" >}}
   {{< card link="tabs" title="Tabs" icon="collection" >}}
 {{< /cards >}}
-
-<div style="padding-top:4rem"></div>
-
-Additional shortcodes provided by Hugo and Hextra:
-
-{{< cards >}}
-  {{< card link="jupyter" title="Jupyter Notebook" icon="jupyter" tag="alpha" >}}
-  {{< card link="others" title="Others" icon="view-grid" >}}
-{{< /cards >}}

exampleSite/content/docs/guide/shortcodes/callout.md

@@ -10,10 +10,6 @@ A built-in component to show important information to the reader.
 
 <!--more-->
 
-> [!NOTE]
-> [GitHub-style alerts](../../markdown#alerts) are supported since [v0.9.0](https://github.com/imfing/hextra/releases/tag/v0.9.0).
-> It leverages Markdown syntax to render the callout which ensures better portability and readability of the content.
-
 ## Example
 
 {{< callout emoji="👾">}}

exampleSite/content/docs/guide/shortcodes/cards.md

@@ -7,12 +7,11 @@ linkTitle: Cards
 
 {{< cards >}}
   {{< card link="../callout" title="Callout" icon="warning" >}}
-  {{< card link="../callout" title="Card with tag" icon="tag" tag="custom tag">}}
   {{< card link="/" title="No Icon" >}}
 {{< /cards >}}
 
 {{< cards >}}
-  {{< card link="/" title="Image Card" image="https://github.com/user-attachments/assets/71b7e3ec-1a8d-4582-b600-5425c6cc0407" subtitle="Internet Image" >}}
+  {{< card link="/" title="Image Card" image="https://source.unsplash.com/featured/800x600?landscape" subtitle="Unsplash Landscape" >}}
   {{< card link="/" title="Local Image" image="/images/card-image-unprocessed.jpg" subtitle="Raw image under static directory." >}}
   {{< card link="/" title="Local Image" image="images/space.jpg" subtitle="Image under assets directory, processed by Hugo." method="Resize" options="600x q80 webp" >}}
 {{< /cards >}}
@@ -22,7 +21,6 @@ linkTitle: Cards
 ```
 {{</* cards */>}}
   {{</* card link="../callout" title="Callout" icon="warning" */>}}
-  {{</* card link="../callout" title="Card with tag" icon="tag" tag= "A custom tag" */>}}
   {{</* card link="/" title="No Icon" */>}}
 {{</* /cards */>}}
 ```
@@ -37,15 +35,13 @@ linkTitle: Cards
 
 ## Card Parameters
 
-| Parameter  | Description                                                     |
+| Parameter  | Description                           |
-|----------- |-----------------------------------------------------------------|
+|----------- |---------------------------------------|
-| `link`     | URL (internal or external).                                     |
+| `link`     | URL (internal or external).           |
-| `title`    | Title heading for the card.                                     |
+| `title`    | Title heading for the card.           |
-| `subtitle` | Subtitle heading (supports Markdown).                           |
+| `subtitle` | Subtitle heading (supports Markdown). |
-| `icon`     | Name of the icon.                                               |
+| `icon`     | Name of the icon.                     |
-| `tag`      | Text in tag.                                                    |
+
-| `tagColor` | Color of the tag: `gray` (default), `yellow`, `red` and `blue`. |
-  
 ## Image Card
 
 Additionally, the card supports adding image and processing through these parameters:
@@ -66,51 +62,3 @@ Hextra auto-detects if image processing is needed during build and applies the `
 It currently supports these `method`: `Resize`, `Fit`, `Fill` and `Crop`.
 
 For more on Hugo's built in image processing commands, methods, and options see their [Image Processing Documentation](https://gohugo.io/content-management/image-processing/).
-
-## Tags
-
-Card supports adding tags which could be useful to show extra status information.
-
-{{< cards >}}
-  {{< card link="../callout" title="Card with default tag" tag="tag text" >}}
-  {{< card link="../callout" title="Card with error tag" tag="tag text" tagType="error" >}}
-  {{< card link="../callout" title="Card with info tag" tag="tag text" tagType="info" >}}
-  {{< card link="../callout" title="Card with warning tag" tag="tag text" tagType="warning" >}}
-  {{< card link="/" title="Image Card" image="https://github.com/user-attachments/assets/71b7e3ec-1a8d-4582-b600-5425c6cc0407" subtitle="Internet Image" tag="tag text" tagType="error" >}}
-{{< /cards >}}
-
-```
-{{</* cards */>}}
-  {{</* card link="../callout" title="Card with default tag color" tag="tag text" */>}}
-  {{</* card link="../callout" title="Card with default red tag" tag="tag text" tagType="error" */>}}
-  {{</* card link="../callout" title="Card with blue tag" tag="tag text" tagType="info" */>}}
-  {{</* card link="../callout" title="Card with yellow tag" tag="tag text" tagType="warning" */>}}
-{{</* /cards */>}}
-```
-
-## Columns
-
-You can specify the maximum number of columns for cards to span by passing the `cols` parameter to the `cards` shortcode. Note that columns will still be collapsed on smaller screens.
-
-{{< cards cols="1" >}}
-  {{< card link="/" title="Top Card" >}}
-  {{< card link="/" title="Bottom Card" >}}
-{{< /cards >}}
-
-{{< cards cols="2" >}}
-  {{< card link="/" title="Left Card" >}}
-  {{< card link="/" title="Right Card" >}}
-{{< /cards >}}
-
-```
-{{</* cards cols="1" */>}}
-  {{</* card link="/" title="Top Card" */>}}
-  {{</* card link="/" title="Bottom Card" */>}}
-{{</* /cards */>}}
-
-{{</* cards cols="2" */>}}
-  {{</* card link="/" title="Left Card" */>}}
-  {{</* card link="/" title="Right Card" */>}}
-{{</* /cards */>}}
-```
-

exampleSite/content/docs/guide/shortcodes/jupyter.md

@@ -1,79 +0,0 @@
----
-title: "Jupyter Notebook Component"
-linktitle: "Jupyter Notebook"
-math: true
-sidebar:
-  exclude: true
----
-
-{{< callout >}}Experimental feature to include Jupyter Notebooks via a shortcode. Note that not all cell types are supported.{{< /callout >}}
-
-[Jupyter Notebook](https://jupyter.org/) is a language-agnostic HTML notebook application for [Project Jupyter](https://jupyter.org/). It allows you to create and share documents that contain live code, equations, visualizations, and narrative text.
-
-<!--more-->
-
-## How to use
-
-### Using a local notebook
-
-To use the Jupyter Notebook shortcode, you need to have a Jupyter Notebook file in your project. Similar to how you would [add images](../../organize-files#add-images) to the project, you can add Jupyter Notebooks to the `assets` folder.
-
-{{< filetree/container >}}
-  {{< filetree/folder name="assets" >}}
-    {{< filetree/file name="notebook.ipynb" >}}
-  {{< /filetree/folder >}}
-  {{< filetree/folder name="content" >}}
-    {{< filetree/folder name="docs" >}}
-        {{< filetree/file name="my-page.md" >}}
-    {{< /filetree/folder >}}
-  {{< /filetree/folder >}}
-{{< /filetree/container >}}
-
-Include the Jupyter Notebook in the page using the `jupyter` shortcode:
-
-```markdown {filename="content/docs/my-page.md"}
----
-title: My Page
-math: true
----
-
-{{%/* jupyter "notebook.ipynb" */%}}
-```
-
-Alternatively, you can utilize the [page bundles][page-bundles] feature of Hugo to organize the Jupyter Notebooks together with the Markdown file.
-
-{{< filetree/container >}}
-  {{< filetree/folder name="content" >}}
-    {{< filetree/folder name="docs" >}}
-        {{< filetree/folder name="my-page" >}}
-            {{< filetree/file name="index.md" >}}
-            {{< filetree/file name="notebook.ipynb" >}}
-        {{< /filetree/folder >}}
-    {{< /filetree/folder >}}
-  {{< /filetree/folder >}}
-{{< /filetree/container >}}
-
-```markdown {filename="content/docs/my-page/index.md"}
----
-title: My Page
-math: true
----
-
-{{%/* jupyter "notebook.ipynb" */%}}
-```
-
-### Using a remote notebook
-
-You can also use a remote notebook by providing the URL to the notebook file. For example, to include [What is the Jupyter Notebook](https://github.com/jupyter/notebook/blob/main/docs/source/examples/Notebook/What%20is%20the%20Jupyter%20Notebook.ipynb) notebook in the page, you can use the following shortcode:
-
-```
-{{%/* jupyter "https://raw.githubusercontent.com/jupyter/notebook/main/docs/source/examples/Notebook/What%20is%20the%20Jupyter%20Notebook.ipynb" */%}}
-```
-
-## Example Notebook
-
-{{< callout type="info" >}}The following is an example of a notebook file that is included in the project assets folder.{{< /callout >}}
-
-{{% jupyter "example.ipynb" %}}
-
-[page-bundles]: https://gohugo.io/content-management/page-bundles/#leaf-bundles

exampleSite/content/docs/guide/shortcodes/others.md

@@ -1,77 +0,0 @@
----
-title: Other Shortcodes
-linkTitle: Others
-sidebar:
-  exclude: true
----
-
-{{< callout emoji="ℹ️" >}}
-  Some of these are Hugo built-in shortcodes.
-  These shortcodes are considered less stable and may be changed anytime.
-{{< /callout >}}
-
-## Badge
-
-```
-{{</* badge "Badge" */>}}
-```
-
-Result:
-
-{{< badge "Badge" >}}
-
-Variants:
-
-```
-{{</* badge content="info" type="info" */>}}
-{{</* badge content="warning" type="warning" */>}}
-{{</* badge content="error" type="error" */>}}
-```
-
-Result:
-
-{{< badge content="info" type="info" >}} &nbsp;
-{{< badge content="warning" type="warning" >}} &nbsp;
-{{< badge content="error" type="error" >}}
-
-With link and icon:
-
-```
-{{</* badge content="Releases" link="https://github.com/imfing/hextra/releases" icon="github" */>}}
-```
-
-Result:
-
-{{< badge content="Releases" link="https://github.com/imfing/hextra/releases" icon="github" >}}
-
-## YouTube
-
-Embed a YouTube video.
-
-```
-{{</* youtube VIDEO_ID */>}}
-```
-
-Result:
-
-{{< youtube id=dQw4w9WgXcQ loading=lazy >}}
-
-For more information, see [Hugo's YouTube Shortcode](https://gohugo.io/content-management/shortcodes/#youtube).
-
-## PDF
-
-With PDF shortcode, you can embed a PDF file in your content.
-
-```
-{{</* pdf "https://example.com/sample.pdf" */>}}
-```
-
-You can also place the PDF file in your project directory and use the relative path.
-
-```
-{{</* pdf "path/to/file.pdf" */>}}
-```
-
-Example:
-
-{{< pdf "https://upload.wikimedia.org/wikipedia/commons/1/13/Example.pdf" >}}

exampleSite/content/docs/guide/shortcodes/steps.md

@@ -25,11 +25,6 @@ This is the third step.
 
 ## Usage
 
-{{< callout emoji="ℹ️" >}}
-  Please note that this shortcode is intended **only for Markdown content**.
-  If you put HTML content or other shortcodes as step content, it may not render as expected.
-{{< /callout >}}
-
 Put Markdown h3 header within `steps` shortcode.
 
 ```

exampleSite/content/docs/guide/syntax-highlighting.md

@@ -40,24 +40,6 @@ def say_hello():
     print("Hello!")
 ```
 
-### Link to File
-
-{{< new-feature version="v0.9.2" >}}
-
-You can use the `base_url` attribute to provide a base URL that will be combined with the file name to generate a link.
-
-The file name can include a relative path if it specifies the file's location within the base path.
-
-````markdown {filename="Markdown"}
-```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
-go 1.20
-```
-````
-
-```go {base_url="https://github.com/imfing/hextra/blob/main/",filename="exampleSite/hugo.work"}
-go 1.20
-```
-
 ### Line Numbers
 
 To set line numbers, set attribute `linenos` to `table` and optionally set `linenostart` to the starting line number:
@@ -96,18 +78,11 @@ def main():
     say_hello()
 ```
 
+
 ### Copy Button
 
-By default, copy button is enabled for code blocks. Its behavior can changed by modifying the site configuration file:
+By default, copy button is enabled for code blocks.
 
-```yaml {linenos=table,linenostart=42,filename="hugo.yaml"}
-params:
-  highlight:
-    copy:
-      enable: true
-      # hover | always
-      display: hover
-```
 
 ## Supported Languages
 

exampleSite/content/showcase/index.md

@@ -12,33 +12,6 @@ Open source projects powered by Hextra
 </p>
 
 {{< cards >}}
-  {{< card
-        link="https://github.com/modelcontextprotocol/specification"
-        title="Model Context Protocol Specification"
-        image="https://github.com/user-attachments/assets/1bb4f952-b8fc-43b5-9cbd-cd7213c2ba90"
-        imageStyle="object-fit:cover; aspect-ratio:16/9;"
-  >}}
-
-  {{< card
-        link="https://github.com/jonaspleyer/cellular_raza"
-        title="cellular_raza"
-        image="https://github.com/user-attachments/assets/f24c6455-b70a-419b-b025-e3d60101b673"
-        imageStyle="object-fit:cover; aspect-ratio:16/9;"
-  >}}
-
-  {{< card
-        link="https://github.com/mightymoud/sidekick"
-        title="Sidekick"
-        image="https://github.com/user-attachments/assets/4ae2a9d7-77b6-42eb-a9d7-5c4599f0f812"
-        imageStyle="object-fit:cover; aspect-ratio:16/9;"
-  >}}
-
-  {{< card
-        link="https://github.com/welding-torch/installc"
-        title="Install C"
-        image="https://github.com/user-attachments/assets/c9a85327-c7e7-40f1-830a-b4190a5e47bd"
-        imageStyle="object-fit:cover; aspect-ratio:16/9;"
-  >}}
 
   {{< card
         link="https://github.com/axivo/website"
@@ -91,11 +64,11 @@ Open source projects powered by Hextra
         link="https://hoa.moe/"
         title="HITSZ OpenAuto"
         image="https://raw.githubusercontent.com/HITSZ-OpenAuto/hoa.moe/main/static/images/showcase-new.png"
-        imageStyle="object-fit:cover; aspect-ratio:16/9;"
+        imageStyle="object-fit:cover; aspect-ratio:16/9;" 
   >}}
 
   {{< card
-        link="https://github.com/remysheppard/lutheran-confessions"
+        link="https://lutheranconfessions.org/"
         title="LutheranConfessions"
         image="https://github.com/imfing/hextra/assets/5097752/ad6625e4-88cd-4cad-b102-5399997d0359"
         imageStyle="object-fit:cover; aspect-ratio:16/9;"

exampleSite/data/en/sidebar.yaml

@@ -1,49 +0,0 @@
-docs:
-  - title: Documentation
-    link: /docs/
-  - title: Getting Started
-    link: /docs/getting-started/
-  - title: Guide
-    link: /docs/guide/
-    open: false
-    items:
-      - title: Organize Files
-        link: /docs/guide/organize-files/
-      - title: Configuration
-        link: /docs/guide/configuration/
-      - title: Markdown
-        link: /docs/guide/markdown/
-      - title: Syntax Highlighting
-        link: /docs/guide/syntax-highlighting/
-      - title: LaTeX
-        link: /docs/guide/latex/
-      - title: Diagrams
-        link: /docs/guide/diagrams/
-      - title: Shortcodes
-        link: /docs/guide/shortcodes/
-        items:
-          - title: Callout
-            link: /docs/guide/shortcodes/callout/
-          - title: Cards
-            link: /docs/guide/shortcodes/cards/
-          - title: Details
-            link: /docs/guide/shortcodes/details/
-          - title: FileTree
-            link: /docs/guide/shortcodes/filetree/
-          - title: Icon
-            link: /docs/guide/shortcodes/icon/
-          - title: Steps
-            link: /docs/guide/shortcodes/steps/
-          - title: Tabs
-            link: /docs/guide/shortcodes/tabs/
-      - title: Deploy Site
-        link: /docs/guide/deploy-site/
-  - title: Advanced
-    link: /docs/advanced/
-    items:
-      - title: Multi-language
-        link: /docs/advanced/multi-language/
-      - title: Comments
-        link: /docs/advanced/comments/
-      - title: Customization
-        link: /docs/advanced/customization/

exampleSite/hugo.yaml

@@ -113,10 +113,6 @@ params:
     # full (100%), wide (90rem), normal (1280px)
     width: normal
 
-    # TODO: move one level up
-    sidebar:
-      source: data
-
   theme:
     # light | dark | system
     default: system
@@ -155,12 +151,6 @@ params:
       sortBy: date
       sortOrder: desc # or "asc"
 
-  highlight:
-    copy:
-      enable: true
-      # hover | always
-      display: hover
-
   comments:
     enable: false
     type: giscus
@@ -177,4 +167,3 @@ params:
       # emitMetadata: 0
       # inputPosition: top
       # lang: en
-      # theme: noborder_dark

exampleSite/hugo_stats.json

@@ -27,7 +27,6 @@
       "head",
       "hr",
       "html",
-      "iframe",
       "img",
       "input",
       "kbd",
@@ -69,36 +68,46 @@
       "[hyphens:auto]",
       "[transition:background-color_1.5s_ease]",
       "[word-break:break-word]",
-      "active",
       "active:hx-bg-gray-400/20",
       "active:hx-opacity-50",
       "active:hx-shadow-gray-200",
       "active:hx-shadow-sm",
       "before:hx-absolute",
       "before:hx-bg-glass-gradient",
+      "before:hx-bg-gray-200",
+      "before:hx-content-[\"\"]",
+      "before:hx-content-['#']",
       "before:hx-content-['']",
       "before:hx-inline-block",
       "before:hx-inset-0",
+      "before:hx-inset-y-1",
       "before:hx-mr-1",
+      "before:hx-opacity-25",
       "before:hx-pointer-events-none",
       "before:hx-transition-transform",
+      "before:hx-w-px",
       "chroma",
       "content",
+      "contrast-more:dark:hover:hx-border-gray-50",
       "contrast-more:dark:hx-border-current",
       "contrast-more:dark:hx-border-gray-50",
       "contrast-more:dark:hx-border-neutral-400",
+      "contrast-more:dark:hx-border-primary-500",
       "contrast-more:dark:hx-shadow-[0_0_0_1px_#fff]",
       "contrast-more:dark:hx-shadow-none",
       "contrast-more:dark:hx-text-current",
       "contrast-more:dark:hx-text-gray-100",
       "contrast-more:dark:hx-text-gray-300",
       "contrast-more:dark:hx-text-gray-50",
+      "contrast-more:hover:hx-border-gray-900",
       "contrast-more:hx-border",
       "contrast-more:hx-border-current",
       "contrast-more:hx-border-gray-800",
       "contrast-more:hx-border-gray-900",
       "contrast-more:hx-border-neutral-400",
+      "contrast-more:hx-border-primary-500",
       "contrast-more:hx-border-t",
+      "contrast-more:hx-border-transparent",
       "contrast-more:hx-font-bold",
       "contrast-more:hx-shadow-[0_0_0_1px_#000]",
       "contrast-more:hx-shadow-none",
@@ -108,6 +117,7 @@
       "contrast-more:hx-text-gray-900",
       "contrast-more:hx-underline",
       "copy-icon",
+      "dark:before:hx-bg-neutral-800",
       "dark:before:hx-invert",
       "dark:contrast-more:hx-border-neutral-400",
       "dark:focus:hx-bg-dark",
@@ -130,28 +140,23 @@
       "dark:hover:hx-text-gray-50",
       "dark:hover:hx-text-neutral-50",
       "dark:hover:hx-text-white",
-      "dark:hx-bg-amber-900/30",
       "dark:hx-bg-black/60",
       "dark:hx-bg-blue-900/30",
       "dark:hx-bg-dark",
       "dark:hx-bg-dark/50",
       "dark:hx-bg-gray-50/10",
-      "dark:hx-bg-green-900/30",
-      "dark:hx-bg-indigo-900/30",
       "dark:hx-bg-neutral-800",
       "dark:hx-bg-neutral-900",
       "dark:hx-bg-orange-400/20",
       "dark:hx-bg-primary-300/10",
+      "dark:hx-bg-primary-400/10",
       "dark:hx-bg-primary-600",
       "dark:hx-bg-red-900/30",
       "dark:hx-bg-yellow-700/30",
       "dark:hx-block",
-      "dark:hx-border-amber-200/30",
       "dark:hx-border-blue-200/30",
       "dark:hx-border-gray-100/20",
       "dark:hx-border-gray-400",
-      "dark:hx-border-green-200/30",
-      "dark:hx-border-indigo-200/30",
       "dark:hx-border-neutral-700",
       "dark:hx-border-neutral-800",
       "dark:hx-border-orange-400/30",
@@ -165,17 +170,16 @@
       "dark:hx-shadow-[0_-12px_16px_#111]",
       "dark:hx-shadow-[0_-1px_0_rgba(255,255,255,.1)_inset]",
       "dark:hx-shadow-none",
-      "dark:hx-text-amber-200",
       "dark:hx-text-blue-200",
       "dark:hx-text-gray-100",
       "dark:hx-text-gray-200",
       "dark:hx-text-gray-300",
       "dark:hx-text-gray-400",
       "dark:hx-text-gray-50",
-      "dark:hx-text-green-200",
-      "dark:hx-text-indigo-200",
       "dark:hx-text-neutral-200",
+      "dark:hx-text-neutral-400",
       "dark:hx-text-orange-300",
+      "dark:hx-text-primary-600",
       "dark:hx-text-red-200",
       "dark:hx-text-slate-100",
       "dark:hx-text-yellow-200",
@@ -183,12 +187,9 @@
       "dark:placeholder:hx-text-gray-400",
       "data-[state=closed]:hx-hidden",
       "data-[state=open]:hx-hidden",
-      "data-[state=selected]:dark:hx-border-primary-500",
-      "data-[state=selected]:dark:hx-text-primary-600",
       "data-[state=selected]:hx-block",
       "data-[state=selected]:hx-border-primary-500",
       "data-[state=selected]:hx-text-primary-600",
-      "dataframe",
       "filename",
       "first:hx-mt-0",
       "focus:hx-bg-white",
@@ -206,34 +207,21 @@
       "group-hover:hx-underline",
       "group-open:before:hx-rotate-90",
       "hamburger-menu",
-      "hextra-badge",
       "hextra-card",
       "hextra-card-icon",
       "hextra-card-image",
       "hextra-card-subtitle",
-      "hextra-card-tag",
       "hextra-cards",
       "hextra-code-block",
       "hextra-code-copy-btn",
       "hextra-code-copy-btn-container",
-      "hextra-custom-footer",
       "hextra-feature-card",
       "hextra-feature-grid",
       "hextra-filetree",
       "hextra-filetree-folder",
       "hextra-footer",
-      "hextra-jupyter-code-cell",
-      "hextra-jupyter-code-cell-outputs",
-      "hextra-jupyter-code-cell-outputs-container",
-      "hextra-pdf",
       "hextra-scrollbar",
       "hextra-sidebar-collapsible-button",
-      "hextra-sidebar-container",
-      "hextra-sidebar-item",
-      "hextra-sidebar-item-link",
-      "hextra-sidebar-item-list",
-      "hextra-tabs-panel",
-      "hextra-tabs-toggle",
       "hextra-toc",
       "highlight",
       "hover:dark:hx-bg-primary-500/10",
@@ -258,21 +246,18 @@
       "hover:hx-text-primary-600",
       "hx-absolute",
       "hx-align-[-2.5px]",
-      "hx-align-middle",
       "hx-align-text-bottom",
       "hx-appearance-none",
       "hx-aspect-auto",
-      "hx-bg-amber-100",
       "hx-bg-black/80",
       "hx-bg-black/[.05]",
       "hx-bg-blue-100",
       "hx-bg-clip-text",
       "hx-bg-gradient-to-r",
       "hx-bg-gray-100",
-      "hx-bg-green-100",
-      "hx-bg-indigo-100",
       "hx-bg-neutral-50",
       "hx-bg-orange-50",
+      "hx-bg-primary-100",
       "hx-bg-primary-400",
       "hx-bg-primary-600",
       "hx-bg-primary-700/5",
@@ -282,15 +267,12 @@
       "hx-bg-yellow-50",
       "hx-block",
       "hx-border",
-      "hx-border-amber-200",
       "hx-border-b",
       "hx-border-b-2",
       "hx-border-black/5",
       "hx-border-blue-200",
       "hx-border-gray-200",
       "hx-border-gray-500",
-      "hx-border-green-200",
-      "hx-border-indigo-200",
       "hx-border-orange-100",
       "hx-border-red-200",
       "hx-border-t",
@@ -344,6 +326,7 @@
       "hx-inset-y-0",
       "hx-items-center",
       "hx-items-start",
+      "hx-justify-between",
       "hx-justify-center",
       "hx-justify-end",
       "hx-justify-items-start",
@@ -409,9 +392,7 @@
       "hx-overflow-x-auto",
       "hx-overflow-x-hidden",
       "hx-overflow-y-auto",
-      "hx-overflow-y-hidden",
       "hx-overscroll-contain",
-      "hx-overscroll-x-contain",
       "hx-p-0.5",
       "hx-p-1",
       "hx-p-1.5",
@@ -433,7 +414,6 @@
       "hx-pt-8",
       "hx-px-1.5",
       "hx-px-2",
-      "hx-px-2.5",
       "hx-px-3",
       "hx-px-4",
       "hx-px-6",
@@ -472,10 +452,8 @@
       "hx-sticky",
       "hx-text-2xl",
       "hx-text-4xl",
-      "hx-text-[.65rem]",
       "hx-text-[10px]",
       "hx-text-[color:hsl(var(--primary-hue),100%,50%)]",
-      "hx-text-amber-900",
       "hx-text-base",
       "hx-text-blue-900",
       "hx-text-center",
@@ -487,11 +465,10 @@
       "hx-text-gray-700",
       "hx-text-gray-800",
       "hx-text-gray-900",
-      "hx-text-green-900",
-      "hx-text-indigo-900",
       "hx-text-left",
       "hx-text-lg",
       "hx-text-orange-800",
+      "hx-text-primary-800",
       "hx-text-red-900",
       "hx-text-slate-900",
       "hx-text-sm",
@@ -529,15 +506,16 @@
       "hx-z-20",
       "hx-z-[-1]",
       "icon",
-      "inactive",
       "language-options",
       "language-switcher",
       "last-of-type:hx-mb-0",
       "lntable",
       "lntd",
+      "ltr:before:hx-left-0",
       "ltr:hx--mr-4",
       "ltr:hx-border-l",
       "ltr:hx-ml-1",
+      "ltr:hx-ml-3",
       "ltr:hx-ml-auto",
       "ltr:hx-mr-auto",
       "ltr:hx-pl-12",
@@ -589,6 +567,7 @@
       "print:hx-bg-transparent",
       "print:hx-hidden",
       "rtl:-hx-rotate-180",
+      "rtl:before:hx-right-0",
       "rtl:before:hx-rotate-180",
       "rtl:hx--ml-4",
       "rtl:hx-border-r",
@@ -596,6 +575,7 @@
       "rtl:hx-left-3",
       "rtl:hx-ml-auto",
       "rtl:hx-mr-1",
+      "rtl:hx-mr-3",
       "rtl:hx-mr-auto",
       "rtl:hx-pl-2",
       "rtl:hx-pl-4",
@@ -612,6 +592,8 @@
       "search-input",
       "search-results",
       "search-wrapper",
+      "sidebar-active-item",
+      "sidebar-container",
       "sm:hx-block",
       "sm:hx-flex",
       "sm:hx-items-start",
@@ -621,6 +603,8 @@
       "steps",
       "subheading-anchor",
       "success-icon",
+      "tabs-panel",
+      "tabs-toggle",
       "theme-toggle",
       "xl:hx-block"
     ],

exampleSite/layouts/shortcodes/new-feature.html

@@ -1,11 +0,0 @@
-{{- $version := .Get "version" | default "" -}}
-{{- $icon := .Get "icon" | default "" -}}
-{{- $defaultLink := cond (eq $version "") "https://github.com/imfing/hextra/tree/main" (printf "https://github.com/imfing/hextra/releases/tag/%s" $version) -}}
-{{- $link := .Get "link" | default $defaultLink -}}
-{{- $content := cond (eq $version "") "New in main branch" (printf "New in %s" $version) -}}
-
-<div style="margin-top: 1rem; display: inline-flex;">
-  <a href="{{ $link }}" title="{{ $link | plainify }}" target="_blank">
-    {{- partial "shortcodes/badge" (dict "content" $content "border" true "icon" $icon) -}}
-  </a>
-</div>

i18n/de.yaml

@@ -4,11 +4,11 @@ changeTheme: "Darstellung ändern"
 copyCode: "Code kopieren"
 copyright: "© 2024 Hextra Project."
 dark: "Dunkel"
-editThisPage: "Diese Seite auf GitHub bearbeiten →"
+editThisPage: "Diese Seite auf Github bearbeiten →"
 lastUpdated: "Zuletzt aktualisiert am"
 light: "Hell"
 noResultsFound: "Keine Ergebnisse gefunden."
 onThisPage: "Auf dieser Seite"
 poweredBy: "Unterstützt durch Hextra"
 readMore: "Mehr lesen →"
-searchPlaceholder: "Suchen..."
+searchPlaceholder: "Suchen..."

i18n/ko.yaml

@@ -3,7 +3,7 @@ changeLanguage: "언어변경"
 changeTheme: "테마변경"
 copyright: "© 2024 Hextra Project."
 dark: "어두운 테마"
-editThisPage: "GitHub에서 편집하기 →"
+editThisPage: "Github에서 편집하기 →"
 lastUpdated: "마지막 수정일자"
 light: "밝은 테마"
 noResultsFound: "결과 없음"

i18n/ru.yaml

@@ -1,14 +0,0 @@
-backToTop: 'Прокрутить к началу'
-changeLanguage: 'Изменить язык'
-changeTheme: 'Изменить тему'
-copyCode: 'Скопировать код'
-copyright: '2024 Проект Hextra.'
-dark: 'Темная'
-editThisPage: 'Отредактировать страницу на GitHub →'
-lastUpdated: 'Последнее обновление'
-light: 'Светлая'
-noResultsFound: 'Ничего не найдено.'
-onThisPage: 'На этой странице'
-poweredBy: 'При поддержке Hextra'
-readMore: 'Читать далее →'
-searchPlaceholder: 'Поиск...'

i18n/uk.yaml

@@ -4,11 +4,11 @@ changeTheme: "Змінити тему"
 copyCode: "Скопіювати код"
 copyright: "2024 Проєкт Hextra."
 dark: "Темна"
-editThisPage: "Редагувати цю сторінку на GitHub →"
+editThisPage: "Редагувати цю сторінку на Github →"
 lastUpdated: "Востаннє оновлено"
 light: "Світла"
 noResultsFound: "Не знайдено результатів"
 onThisPage: "На цій сторінці"
 poweredBy: "Працює завдяки Hextra"
 readMore: "Читати більше →"
-searchPlaceholder: "Пошук..."
+searchPlaceholder: "Пошук..."

layouts/_default/_markup/render-blockquote-alert.html

@@ -1,9 +0,0 @@
-{{- if not (in (slice "note" "tip" "important" "warning" "caution") .AlertType) -}}
-  {{- warnf "Alert type %s is not supported" .AlertType -}}
-{{- end -}}
-
-{{- $content := .Text -}}
-{{- $alertType := .AlertType -}}
-{{- $alertTitle := .AlertTitle -}}
-
-{{- partial "components/github-style-alert.html" (dict "content" $content "alertType" $alertType "alertTitle" $alertTitle) -}}

layouts/_default/_markup/render-blockquote-regular.html

@@ -1,3 +0,0 @@
-<blockquote>
-  {{ .Text }}
-</blockquote>

layouts/_default/_markup/render-codeblock.html

@@ -1,13 +1,12 @@
 {{- $class := .Attributes.class | default "" -}}
 {{- $filename := .Attributes.filename | default "" -}}
-{{- $base_url := .Attributes.base_url | default "" -}}
 {{- $lang := .Attributes.lang | default .Type -}}
 
 
 <div class="hextra-code-block hx-relative hx-mt-6 first:hx-mt-0 hx-group/code">
-  {{- partial "components/codeblock" (dict "filename" $filename "lang" $lang "base_url" $base_url "content" .Inner "options" .Options) -}}
+  {{ partial "components/codeblock" (dict "filename" $filename "lang" $lang "content" .Inner "options" .Options) }}
 
-  {{- if or (eq site.Params.highlight.copy.enable nil) (site.Params.highlight.copy.enable) -}}
+  {{- if or (eq site.Params.highlight.copy.enable nil) (site.Params.highlight.copy.enable) }}
-    {{- partialCached "components/codeblock-copy-button" (dict "filename" $filename) $filename -}}
+    {{- partialCached "components/codeblock-copy-button" (dict "filename" $filename) $filename }}
-  {{- end -}}
+  {{ end }}
 </div>

layouts/_default/list.html

@@ -1,13 +1,11 @@
 {{ define "main" }}
   <div class='hx-mx-auto hx-flex {{ partial "utils/page-width" . }}'>
-    {{- if not (in (slice "taxonomy" "term") .Kind) -}}
+    {{ partial "sidebar.html" (dict "context" .) }}
-      {{- partial "sidebar.html" (dict "context" .) -}}
-    {{- end -}}
     {{ partial "toc.html" . }}
     <article class="hx-w-full hx-break-words hx-flex hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-justify-center hx-pb-8 hx-pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         <div class="content">
-          {{ if .Title }}<h1>{{ .Title }}</h1>{{ end }}
+          <h1>{{ .Title }}</h1>
           {{ .Content }}
         </div>
         <div class="hx-mt-16"></div>
@@ -16,4 +14,4 @@
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/_default/single.html

@@ -5,7 +5,7 @@
     <article class="hx-w-full hx-break-words hx-flex hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-justify-center hx-pb-8 hx-pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         <br class="hx-mt-1.5 hx-text-sm" />
-        {{ if .Title }}<h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>{{ end }}
+        <h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>
         <div class="hx-mb-16"></div>
         <div class="content">
           {{ .Content }}
@@ -15,4 +15,4 @@
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/_default/wide.html

@@ -3,10 +3,10 @@
     {{ partial "sidebar.html" (dict "context" . "disableSidebar" true "displayPlaceholder" false) }}
     <article class="hx-w-full hx-break-words hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-pt-4 hx-pb-8 hx-pl-[max(env(safe-area-inset-left),1.5rem)] hx-pr-[max(env(safe-area-inset-left),1.5rem)]">
       <br class="hx-mt-1.5 hx-text-sm" />
-      {{ if .Title }}<h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>{{ end }}
+      <h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>
       <div class="content">
         {{ .Content }}
       </div>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/blog/list.html

@@ -5,7 +5,7 @@
     <article class="hx-w-full hx-break-words hx-flex hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-justify-center hx-pb-8 hx-pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         <br class="hx-mt-1.5 hx-text-sm" />
-        {{ if .Title }}<h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>{{ end }}
+        <h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>
         <div class="content">{{ .Content }}</div>
         {{- $pages := partial "utils/sort-pages" (dict "page" . "by" site.Params.blog.list.sortBy "order" site.Params.blog.list.sortOrder) -}}
         {{- range $pages }}
@@ -31,4 +31,4 @@
     </article>
     <div class="max-xl:hx-hidden hx-h-0 hx-w-64 hx-shrink-0"></div>
   </div>
-{{- end -}}
+{{- end -}}

layouts/blog/single.html

@@ -5,7 +5,7 @@
     <article class="hx-w-full hx-break-words hx-flex hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-justify-center hx-pb-8 hx-pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         {{ partial "breadcrumb.html" . }}
-        {{ if .Title }}<h1 class="hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>{{ end }}
+        <h1 class="hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>
         <div class="hx-mt-4 hx-mb-16 hx-text-gray-500 hx-text-sm hx-flex hx-items-center hx-flex-wrap hx-gap-y-2">
           {{- with $date := .Date }}<span class="hx-mr-1">{{ partial "utils/format-date" $date }}</span>{{ end -}}
           {{- $lazyLoading := site.Params.enableImageLazyLoading | default true -}}
@@ -45,4 +45,4 @@
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/docs/list.html

@@ -6,7 +6,7 @@
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         {{ partial "breadcrumb.html" . }}
         <div class="content">
-          {{ if .Title }}<h1>{{ .Title }}</h1>{{ end }}
+          <h1>{{ .Title }}</h1>
           {{ .Content }}
         </div>
         {{ partial "components/last-updated.html" . }}
@@ -15,4 +15,4 @@
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/docs/single.html

@@ -6,7 +6,7 @@
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
         {{ partial "breadcrumb.html" . }}
         <div class="content">
-          {{ if .Title }}<h1>{{ .Title }}</h1>{{ end }}
+          <h1>{{ .Title }}</h1>
           {{ .Content }}
         </div>
         {{ partial "components/last-updated.html" . }}
@@ -15,4 +15,4 @@
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/index.html

@@ -4,11 +4,11 @@
     {{ partial "toc.html" . }}
     <article class="hx-w-full hx-break-words hx-flex hx-min-h-[calc(100vh-var(--navbar-height))] hx-min-w-0 hx-justify-center hx-pb-8 hx-pr-[calc(env(safe-area-inset-right)-1.5rem)]">
       <main class="hx-w-full hx-min-w-0 hx-max-w-6xl hx-px-6 hx-pt-4 md:hx-px-12">
-        {{ if .Title }}<h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>{{ end }}
+        <h1 class="hx-text-center hx-mt-2 hx-text-4xl hx-font-bold hx-tracking-tight hx-text-slate-900 dark:hx-text-slate-100">{{ .Title }}</h1>
         <div class="content">
           {{ .Content }}
         </div>
       </main>
     </article>
   </div>
-{{ end }}
+{{ end }}

layouts/partials/components/codeblock.html

@@ -1,27 +1,11 @@
 {{ $filename := .filename | default "" -}}
-{{ $base_url := .base_url | default "" -}}
 {{ $lang := .lang | default "" }}
 {{ $content := .content }}
 {{ $options := .options | default (dict) }}
 
 {{- if $filename -}}
-  <div class="filename not-prose" dir="auto">
+  <div class="filename" dir="auto">{{ $filename }}</div>
-    {{- if $base_url -}}
-
-      {{- $base_url = strings.TrimSuffix "/" $base_url -}}
-      {{- $filename = strings.TrimPrefix "/" $filename -}}
-      {{- $file_url := urls.JoinPath $base_url $filename -}}
-
-      <a class="hx-no-underline hx-inline-flex hx-items-center hx-gap-1" href="{{ $file_url }}" target="_blank" rel="noopener noreferrer">
-          <span>{{- $filename -}}</span>
-          {{- partial "utils/icon" (dict "name" "external-link" "attributes" "height=1em") -}}
-      </a>
-    {{- else -}}
-      {{- $filename -}}
-    {{- end -}}
-  </div>
 {{- end -}}
-
 {{- if transform.CanHighlight $lang -}}
   <div>{{- highlight $content $lang $options -}}</div>
 {{- else -}}

layouts/partials/components/giscus.html

@@ -8,17 +8,8 @@
    * This solution was created with reference to:
    * https://github.com/giscus/giscus/issues/336#issuecomment-1214366281
   */
-  function getHugoTheme() {
-    return localStorage.getItem("color-theme");
-  }
-  
   function getGiscusTheme() {
-    let giscusTheme = "{{ (string .theme) | default `light` }}";
+    return localStorage.getItem("color-theme");
-    if(getHugoTheme() == 'light') {
-      return giscusTheme.replace('dark', 'light');
-    } else {
-      return giscusTheme.replace('light', 'dark');
-    }
   }
 
   function setGiscusTheme() {

layouts/partials/components/github-style-alert.html

@@ -1,42 +0,0 @@
-{{- $content := .content -}}
-{{- $alertType := .alertType -}}
-{{- $alertTitle := .alertTitle -}}
-
-{{- $icons := dict
-  "note" "information-circle"
-  "tip" "light-bulb"
-  "important" "information-circle"
-  "warning" "exclamation"
-  "caution" "exclamation-circle"
--}}
-
-{{- $icon := index $icons $alertType -}}
-{{- $title := or $alertTitle (or (i18n $alertType) (title $alertType)) -}}
-
-{{- $defaultClass := "hx-border-orange-100 hx-bg-orange-50 hx-text-orange-800 dark:hx-border-orange-400/30 dark:hx-bg-orange-400/20 dark:hx-text-orange-300" }}
-
-{{- $alertClasses := dict
-  "note" "hx-border-blue-200 hx-bg-blue-100 hx-text-blue-900 dark:hx-border-blue-200/30 dark:hx-bg-blue-900/30 dark:hx-text-blue-200"
-  "tip" "hx-border-green-200 hx-bg-green-100 hx-text-green-900 dark:hx-border-green-200/30 dark:hx-bg-green-900/30 dark:hx-text-green-200"
-  "important" "hx-border-indigo-200 hx-bg-indigo-100 hx-text-indigo-900 dark:hx-border-indigo-200/30 dark:hx-bg-indigo-900/30 dark:hx-text-indigo-200"
-  "warning" "hx-border-amber-200 hx-bg-amber-100 hx-text-amber-900 dark:hx-border-amber-200/30 dark:hx-bg-amber-900/30 dark:hx-text-amber-200"
-  "caution" "hx-border-red-200 hx-bg-red-100 hx-text-red-900 dark:hx-border-red-200/30 dark:hx-bg-red-900/30 dark:hx-text-red-200"
--}}
-
-{{- $class := index $alertClasses $alertType | default $defaultClass -}}
-
-
-<div class="hx-overflow-x-auto hx-mt-6 hx-flex hx-flex-col hx-rounded-lg hx-border hx-py-4 hx-px-4 contrast-more:hx-border-current contrast-more:dark:hx-border-current {{ $class }}">
-  <p class="hx-flex hx-items-center hx-font-medium">
-    {{- with $icon -}}
-      {{- partial "utils/icon.html" (dict "name" . "attributes" `height=16px class="hx-inline-block hx-align-middle hx-mr-2"`) -}}
-    {{- end -}}
-    {{- $title -}}
-  </p>
-
-  <div class="hx-w-full hx-min-w-0 hx-leading-7">
-    <div class="hx-mt-6 hx-leading-7 first:hx-mt-0">
-      {{- $content -}}
-    </div>
-  </div>
-</div>

layouts/partials/components/sidebar/bottom.html

@@ -1,12 +0,0 @@
-{{- range site.Menus.sidebar }}
-  {{- $name := or (T .Identifier) .Name }}
-  {{- if eq .Params.type "separator" }}
-    <li class="[word-break:break-word] hx-mt-5 hx-mb-2 hx-px-2 hx-py-1.5 hx-text-sm hx-font-semibold hx-text-gray-900 first:hx-mt-0 dark:hx-text-gray-100">
-      <span class="hx-cursor-default">{{ $name }}</span>
-    </li>
-  {{- else }}
-    <li>
-      {{- partial "components/sidebar/item-link" (dict "active" false "title" $name "link" (.URL | relLangURL)) -}}
-    </li>
-  {{- end }}
-{{- end -}}

layouts/partials/components/sidebar/collapsible-button.html

@@ -1,5 +0,0 @@
-<span class="hextra-sidebar-collapsible-button">
-  <svg fill="none" viewBox="0 0 24 24" stroke="currentColor" class="hx-h-[18px] hx-min-w-[18px] hx-rounded-sm hx-p-0.5 hover:hx-bg-gray-800/5 dark:hover:hx-bg-gray-100/5">
-    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" class="hx-origin-center hx-transition-transform rtl:-hx-rotate-180"></path>
-  </svg>
-</span>

layouts/partials/components/sidebar/generate-mobile-data.html

@@ -1,35 +0,0 @@
-{{/* Generate mobile navigation data based on main menu */}}
-
-{{- $context := . -}}
-
-{{- $data := slice -}}
-
-{{- range .Site.Menus.main -}}
-  {{- if not (eq .Params.type "search") -}}
-    {{- $title := or (T .Identifier) .Name -}}
-    {{- $link := .URL -}}
-    {{- $external := strings.HasPrefix $link "http" -}}
-    {{- with .PageRef -}}
-      {{- if hasPrefix . "/" -}}
-        {{- $link = relLangURL (strings.TrimPrefix "/" .) -}}
-      {{- end -}}
-    {{- end -}}
-
-    {{- with .Page -}}
-      {{- $page := . -}}
-
-      {{- if and $page.IsSection (eq $page.Type "docs") -}}
-        {{- $page = (partial "utils/translated-page" (dict "page" $page "lang" site.Language.LanguageCode)) -}}
-        {{- $sectionData := (partial "components/sidebar/generate-section-data" $page) | unmarshal -}}
-        {{- $data = $data | append (dict "title" $title "link" $link "items" $sectionData) -}}
-      {{- else -}}
-        {{- $data = $data | append (dict "title" $title "link" $link) -}}
-      {{- end -}}
-    {{- else -}}
-      {{/* TODO: handle other cases like external links */}}
-      {{- $data = $data | append (dict "title" $title "link" $link) -}}
-    {{- end -}}
-  {{- end -}}
-{{- end -}}
-
-{{- return ($data | jsonify (dict "noHTMLEscape" true)) -}}

layouts/partials/components/sidebar/generate-section-data.html

@@ -1,51 +0,0 @@
-{{- $context := . -}}
-
-{{- $pages := union .RegularPages .Sections -}}
-{{- $pages = where $pages "Params.sidebar.exclude" "!=" true -}}
-
-{{- $data := slice -}}
-
-{{- range $pages.ByWeight -}}
-  {{ $structure := (partial "sidebar/section-walk" .) | unmarshal -}}
-  {{ $data = $data | append $structure -}}
-{{ end -}}
-
-{{- define "partials/sidebar/section-walk" -}}
-  {{- with . -}}
-  {
-    "title": "{{ partial "utils/title" . }}",
-    "link": "{{ .RelPermalink }}",
-    "toc": {{ partial "sidebar/section-page-toc" . }},
-    "open": {{ .Params.sidebar.open | default false }}
-    {{- if .IsSection }},
-    "items": [
-      {{ $pages := union .RegularPages .Sections -}}
-      {{ $pages = where $pages "Params.sidebar.exclude" "!=" true -}}
-      {{ range $index, $page := $pages.ByWeight -}}
-        {{ partial "sidebar/section-walk" . }}{{ if not (ge $index (sub (len $pages) 1)) }},{{ end -}}
-      {{ end -}}
-    ]
-    {{ end -}}
-  }
-  {{- end }}
-{{- end -}}
-
-{{- define "partials/sidebar/section-page-toc" -}}
-  {{/* Get level 2 headings list used mainly for mobile navigation */}}
-  [
-    {{- with .Fragments.Headings -}}
-      {{/* Loop over level 1 headings */}}
-      {{- range . }}
-        {{- with .Headings }}
-          {{ $headings := . }}
-          {{- range $index, $heading := $headings }}
-            {{ $heading.Title | jsonify (dict "noHTMLEscape" true) }}
-            {{- if not (ge $index (sub (len $headings) 1)) }},{{ end -}}
-          {{ end -}}
-        {{- end -}}
-      {{ end -}}
-    {{- end -}}
-  ]
-{{- end -}}
-
-{{ return ($data | jsonify (dict "noHTMLEscape" true)) }}

layouts/partials/components/sidebar/get-section-data.html

@@ -1,20 +0,0 @@
-{{/* Get section sidebar config from Hugo `data` directory
-
-  If the site is multilingual, the sidebar data is stored in a language-specific
-  directory. For example, the English sidebar data is stored in `data/en/sidebar.yaml`.
-*/}}
-{{ $data := "" }}
-{{ $section := .Section | default "index" }}
-{{ $filename := "sidebar" }}
-
-{{ if hugo.IsMultilingual }}
-  {{ with (index site.Data site.Language.Lang $filename $section) }}
-    {{ $data = . }}
-  {{ end }}
-{{ else }}
-  {{ with (index site.Data $filename $section) }}
-    {{ $data = . }}
-  {{ end }}
-{{ end }}
-
-{{ return $data }}

layouts/partials/components/sidebar/item-link.html

@@ -1,18 +0,0 @@
-{{- $external := strings.HasPrefix .link "http" -}}
-
-{{- $activeClass := cond (.active) "active" "inactive" -}}
-
-
-<a
-  class="hextra-sidebar-item-link {{ $activeClass }} [-webkit-tap-highlight-color:transparent] [-webkit-touch-callout:none] [word-break:break-word]"
-  href="{{ .link }}"
-  {{ if $external }}target="_blank" rel="noreferer"{{ end }}
->
-  {{- .title -}}
-  {{- with .context }}
-    {{- if or .RegularPages .Sections }}
-      {{- partialCached "components/sidebar/collapsible-button" . }}
-    {{- end }}
-  {{ end -}}
-  {{- with .items }}{{- partialCached "components/sidebar/collapsible-button" site.Home }}{{ end -}}
-</a>

layouts/partials/components/sidebar/render-data.html

@@ -1,16 +0,0 @@
-{{- $page := .page -}}
-{{- $pageLink :=  $page.RelPermalink -}}
-{{- $cached := .cached | default false }}
-
-{{- range .data -}}
-  {{- $active := and (not $cached) (or (eq $pageLink .link) (eq (strings.TrimSuffix "/" $pageLink) .link)) -}}
-  {{- $containsPage := hasPrefix $pageLink .link -}}
-  {{- $shouldOpen := or (.open) $containsPage $active | default false -}}
-
-  <li class="hextra-sidebar-item {{ if $shouldOpen }}open{{ end }}">
-    {{- partial "components/sidebar/item-link" (dict "active" $active "title" .title "link" .link "items" .items) -}}
-    {{- if .items -}}
-      {{- partial "components/sidebar/render-items" (dict "items" .items "link" $pageLink "cached" $cached) -}}
-    {{- end -}}
-  </li>
-{{ end }}

layouts/partials/components/sidebar/render-items.html

@@ -1,21 +0,0 @@
-{{- $items := .items -}}
-{{- $pageLink := .link -}}
-{{- $cached := .cached | default false }}
-
-
-<div class="ltr:hx-pr-0 hx-overflow-hidden">
-  <ul class="hextra-sidebar-item-list">
-    {{- range $items }}
-      {{- $active := and (not $cached) (or (eq $pageLink .link) (eq (strings.TrimSuffix "/" $pageLink) .link)) -}}
-      {{- $containsPage := hasPrefix $pageLink .link -}}
-      {{- $shouldOpen := or (.open) $containsPage $active | default false -}}
-
-      <li class="hextra-sidebar-item hx-flex hx-flex-col {{ if $shouldOpen }}open{{ end }}">
-        {{- partial "components/sidebar/item-link" (dict "active" $active "title" .title "link" .link "items" .items) -}}
-        {{- if .items -}}
-          {{- partial "components/sidebar/render-items" (dict "items" .items "link" $pageLink "cached" $cached) -}}
-        {{- end -}}
-      </li>
-    {{- end -}}
-  </ul>
-</div>

layouts/partials/footer.html

@@ -1,7 +1,5 @@
 {{- $enableFooterSwitches := .Scratch.Get "enableFooterSwitches" | default false -}}
 {{- $displayThemeToggle := site.Params.theme.displayToggle | default true -}}
-{{- $footerSwitchesVisible := and $enableFooterSwitches (or hugo.IsMultilingual $displayThemeToggle) -}}
-{{- $copyrightSectionVisible := or (.Site.Params.footer.displayPoweredBy | default true) .Site.Params.footer.displayCopyright -}}
 
 {{- $copyright := (T "copyright") | default "© 2024 Hextra." -}}
 {{- $poweredBy := (T "poweredBy") | default "Powered by Hextra" -}}
@@ -17,7 +15,7 @@
 
 
 <footer class="hextra-footer hx-bg-gray-100 hx-pb-[env(safe-area-inset-bottom)] dark:hx-bg-neutral-900 print:hx-bg-transparent">
-  {{- if $footerSwitchesVisible -}}
+  {{- if $enableFooterSwitches -}}
     <div class="hx-mx-auto hx-flex hx-gap-2 hx-py-2 hx-px-4 {{ $footerWidth }}">
       {{- partial "language-switch.html" (dict "context" .) -}}
       {{- with $displayThemeToggle }}{{ partial "theme-toggle.html" }}{{ end -}}
@@ -26,21 +24,14 @@
       <hr class="dark:hx-border-neutral-800" />
     {{- end -}}
   {{- end -}}
-    <div
+  <div
-      class="hextra-custom-footer {{ $footerWidth }} hx-pl-[max(env(safe-area-inset-left),1.5rem)] hx-pr-[max(env(safe-area-inset-right),1.5rem)] hx-text-gray-600 dark:hx-text-gray-400"
+    class="{{ $footerWidth }} hx-mx-auto hx-flex hx-justify-center hx-py-12 hx-pl-[max(env(safe-area-inset-left),1.5rem)] hx-pr-[max(env(safe-area-inset-right),1.5rem)] hx-text-gray-600 dark:hx-text-gray-400 md:hx-justify-start"
-    >
+  >
-      {{- partial "custom/footer.html" (dict "context" . "switchesVisible" $footerSwitchesVisible "copyrightVisible" $copyrightSectionVisible) -}}
+    <div class="hx-flex hx-w-full hx-flex-col hx-items-center sm:hx-items-start">
+      {{- if (.Site.Params.footer.displayPoweredBy | default true) }}<div class="hx-font-semibold">{{ template "theme-credit" $poweredBy }}</div>{{ end }}
+      {{- if .Site.Params.footer.displayCopyright }}<div class="hx-mt-6 hx-text-xs">{{ $copyright | markdownify }}</div>{{ end }}
     </div>
-    {{- if $copyrightSectionVisible -}}
+  </div>
-      <div
-        class="{{ $footerWidth }} hx-mx-auto hx-flex hx-justify-center hx-py-12 hx-pl-[max(env(safe-area-inset-left),1.5rem)] hx-pr-[max(env(safe-area-inset-right),1.5rem)] hx-text-gray-600 dark:hx-text-gray-400 md:hx-justify-start"
-      >
-        <div class="hx-flex hx-w-full hx-flex-col hx-items-center sm:hx-items-start">
-            {{- if (.Site.Params.footer.displayPoweredBy | default true) }}<div class="hx-font-semibold">{{ template "theme-credit" $poweredBy }}</div>{{- end -}}
-            {{- if .Site.Params.footer.displayCopyright }}<div class="hx-mt-6 hx-text-xs">{{ $copyright | markdownify }}</div>{{- end -}}
-        </div>
-      </div>
-    {{- end -}}
 </footer>
 
 {{- define "theme-credit" -}}

layouts/partials/google-analytics.html

@@ -1,4 +1,10 @@
-{{- with site.Config.Services.GoogleAnalytics.ID }}
+{{/* site.GoogleAnalytics is deprecated in Hugo v0.120.0 */}}
+{{/* it will be removed in a future version */}}
+{{- $gtagID := "" -}}
+{{- with site.GoogleAnalytics -}}{{ $gtagID = . }}{{- end -}}
+{{- with site.Config.Services.GoogleAnalytics.ID -}}{{ $gtagID = . }}{{- end -}}
+
+{{- with $gtagID }}
   <!-- Global site tag (gtag.js) - Google Analytics -->
   <script async src="https://www.googletagmanager.com/gtag/js?id={{ . }}"></script>
   <script>

layouts/partials/head-css.html

@@ -1,6 +1,6 @@
 {{- if and (not hugo.IsProduction) (eq hugo.Environment "theme") }}
   {{- $styles := resources.Get "css/styles.css" }}
-  {{- $styles = $styles | postCSS (dict "inlineImports" true) }}
+  {{- $styles = $styles | resources.PostCSS (dict "inlineImports" true) }}
   <link href="{{ $styles.RelPermalink }}" rel="stylesheet" />
 {{- else }}
   {{- $styles := resources.Get "css/compiled/main.css" -}}

layouts/partials/head.html

@@ -6,7 +6,7 @@
   {{ else -}}
     <meta name="robots" content="noindex, nofollow" />
   {{ end -}}
-  {{ partialCached "favicons.html" . -}}
+  {{ partialCached "favicons.html" . }}
   <title>
     {{- if .IsHome -}}
       {{ .Site.Title -}}
@@ -17,24 +17,25 @@
   </title>
   <meta name="description" content="{{ partial "utils/page-description.html" . }}" />
 
-  {{- with .Params.canonical -}}
+  {{ with .Params.canonical }}
     <link rel="canonical" href="{{ . }}" itemprop="url" />
-  {{- else -}}
+  {{ else }}
     <link rel="canonical" href="{{ .Permalink }}" itemprop="url" />
-  {{- end -}}
+  {{ end }}
 
-  {{- partial "opengraph.html" . -}}
+  {{ partial "opengraph.html" . }}
-  {{- template "_internal/schema.html" . -}}
+  {{ template "_internal/schema.html" . -}}
-  {{- template "_internal/twitter_cards.html" . -}}
+  {{ template "_internal/twitter_cards.html" . -}}
 
-  {{- partialCached "head-css.html" . -}}
+  {{ partialCached "head-css.html" . }}
 
 
-<!-- Google Analytics -->
+  <!-- Google Analytics -->
-{{- if and (eq hugo.Environment "production") .Site.Config.Services.GoogleAnalytics.ID }}
+  {{- if and (eq hugo.Environment "production") (or .Site.GoogleAnalytics .Site.Config.Services.GoogleAnalytics.ID) }}
-  <link rel="preconnect" href="https://www.googletagmanager.com" crossorigin />
+    <link rel="preconnect" href="https://www.googletagmanager.com" crossorigin />
-  {{ partial "google-analytics.html" . }}
+    {{ partial "google-analytics.html" . }}
-{{- end }}
+  {{- end }}
+
 
   <script>
     /* Initialize light/dark mode */

layouts/partials/navbar.html

@@ -42,7 +42,7 @@
 
         {{/* Display icon menu item */}}
         {{- if .Params.icon -}}
-          {{- $rel := cond (eq .Params.icon "mastodon") "noreferrer me" "noreferrer" }}
+          {{- $rel := cond (eq .Params.icon "mastodon") "noreferer me" "noreferer" }}
           <a class="hx-p-2 hx-text-current" {{ if $external }}target="_blank" rel="{{ $rel }}"{{ end }} href="{{ $link }}" title="{{ or (T .Identifier) .Name | safeHTML }}">
             {{- partial "utils/icon.html" (dict "name" .Params.icon "attributes" "height=24") -}}
             <span class="hx-sr-only">{{ or (T .Identifier) .Name | safeHTML }}</span>
@@ -53,7 +53,7 @@
           <a
             title="{{ or (T .Identifier) .Name | safeHTML }}"
             href="{{ $link }}"
-            {{ if $external }}target="_blank" rel="noreferrer"{{ end }}
+            {{ if $external }}target="_blank" rel="noreferer"{{ end }}
             class="hx-text-sm contrast-more:hx-text-gray-700 contrast-more:dark:hx-text-gray-100 hx-relative -hx-ml-2 hx-hidden hx-whitespace-nowrap hx-p-2 md:hx-inline-block {{ $activeClass }}"
           >
             <span class="hx-text-center">{{ or (T .Identifier) .Name | safeHTML }}</span>

layouts/partials/scripts.html

@@ -4,7 +4,7 @@
 {{- $jsLang := resources.Get "js/lang.js" -}}
 {{- $jsCodeCopy := resources.Get "js/code-copy.js" -}}
 {{- $jsFileTree := resources.Get "js/filetree.js" -}}
-{{- $jsSidebar := resources.Get "js/sidebar.js" | resources.ExecuteAsTemplate "sidebar.js" . -}}
+{{- $jsSidebar := resources.Get "js/sidebar.js" -}}
 {{- $jsBackToTop := resources.Get "js/back-to-top.js" -}}
 
 {{- $scripts := slice $jsTheme $jsMenu $jsCodeCopy $jsTabs $jsLang $jsFileTree $jsSidebar $jsBackToTop | resources.Concat "js/main.js" -}}
@@ -37,32 +37,9 @@
   {{- $mermaidJS := resources.Get "lib/mermaid/mermaid.min.js" | fingerprint -}}
   <script defer src="{{ $mermaidJS.RelPermalink }}" integrity="{{ $mermaidJS.Data.Integrity }}"></script>
   <script>
-    document.addEventListener("DOMContentLoaded", () => {
+    document.addEventListener("DOMContentLoaded", function () {
-      // Store original mermaid code for each diagram
-      document.querySelectorAll(".mermaid").forEach(el => {
-        el.dataset.original = el.innerHTML;
-      });
-
       const theme = document.documentElement.classList.contains("dark") ? "dark" : "default";
       mermaid.initialize({ startOnLoad: true, theme: theme });
-
-      let timeout;
-      new MutationObserver(() => {
-        clearTimeout(timeout);
-        timeout = setTimeout(() => {
-          const theme = document.documentElement.classList.contains("dark") ? "dark" : "default";
-          document.querySelectorAll(".mermaid").forEach(el => {
-            // Reset to original content, preserving HTML
-            el.innerHTML = el.dataset.original;
-            el.removeAttribute("data-processed");
-          });
-          mermaid.initialize({ startOnLoad: true, theme: theme });
-          mermaid.init();
-        }, 150);
-      }).observe(document.documentElement, {
-        attributes: true,
-        attributeFilter: ["class"]
-      });
     });
   </script>
 {{- end -}}
@@ -83,18 +60,12 @@
   {{- end -}}
   <script>
     // TODO: make render options configurable
-    // Reference: https://katex.org/docs/autorender#api
     document.addEventListener("DOMContentLoaded", function () {
       renderMathInElement(document.body, {
         delimiters: [
           { left: "$$", right: "$$", display: true },
           { left: "$", right: "$", display: false },
           { left: "\\(", right: "\\)", display: false },
-          { left: "\\begin{equation}", right: "\\end{equation}", display: true },
-          {left: "\\begin{align}", right: "\\end{align}", display: true},
-          {left: "\\begin{alignat}", right: "\\end{alignat}", display: true},
-          {left: "\\begin{gather}", right: "\\end{gather}", display: true},
-          {left: "\\begin{CD}", right: "\\end{CD}", display: true},
           { left: "\\[", right: "\\]", display: true },
         ],
         throwOnError: false,

layouts/partials/shortcodes/badge.html

@@ -1,20 +0,0 @@
-{{- $content := .content -}}
-{{- $type := .type -}}
-{{- $class := .class | default "" -}}
-{{- $border := .border | default false -}}
-{{- $icon := .icon | default "" -}}
-
-{{- $defaultClass := "hx-text-gray-600 hx-bg-gray-100 dark:hx-bg-neutral-800 dark:hx-text-neutral-200 hx-border-gray-200 dark:hx-border-neutral-700" -}}
-{{- $warningClass := "hx-border-yellow-100 hx-bg-yellow-50 hx-text-yellow-900 dark:hx-border-yellow-200/30 dark:hx-bg-yellow-700/30 dark:hx-text-yellow-200" -}}
-{{- $infoClass := "hx-border-blue-200 hx-bg-blue-100 hx-text-blue-900 dark:hx-border-blue-200/30 dark:hx-bg-blue-900/30 dark:hx-text-blue-200" -}}
-{{- $errorClass := "hx-border-red-200 hx-bg-red-100 hx-text-red-900 dark:hx-border-red-200/30 dark:hx-bg-red-900/30 dark:hx-text-red-200" -}}
-
-{{- $borderClass := cond (eq $border true) "hx-border" "" -}}
-{{- $badgeClass := cond (eq $type "info") $infoClass (cond (eq $type "warning") $warningClass (cond (eq $type "error") $errorClass $defaultClass)) -}}
-<div class="hextra-badge {{ $class }}">
-  <div class="hx-inline-flex hx-gap-1 hx-items-center hx-rounded-full hx-px-2.5 hx-leading-6 hx-text-[.65rem] {{ $borderClass }} {{ $badgeClass }}">
-    {{- with $icon -}}{{- partial "utils/icon" (dict "name" . "attributes" "height=12") -}}{{- end -}}
-    {{- $content -}}
-  </div>
-</div>
-{{- /* Strip trailing newline. */ -}}

layouts/partials/shortcodes/callout.html

@@ -1,28 +0,0 @@
-{{- $content := .content -}}
-{{- $emoji := .emoji -}}
-{{- $icon := .icon -}}
-
-{{- $defaultClass := "hx-border-orange-100 hx-bg-orange-50 hx-text-orange-800 dark:hx-border-orange-400/30 dark:hx-bg-orange-400/20 dark:hx-text-orange-300" -}}
-
-{{- $class := .class | default $defaultClass -}}
-
-
-<div class="hx-overflow-x-auto hx-mt-6 hx-flex hx-rounded-lg hx-border hx-py-2 ltr:hx-pr-4 rtl:hx-pl-4 contrast-more:hx-border-current contrast-more:dark:hx-border-current {{ $class }}">
-  <div class="ltr:hx-pl-3 ltr:hx-pr-2 rtl:hx-pr-3 rtl:hx-pl-2">
-    {{- with $emoji -}}
-      <div class="hx-select-none hx-text-xl" style="font-family: 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';">
-        {{- . -}}
-      </div>
-    {{- else -}}
-      {{- with $icon -}}
-        {{ partial "utils/icon.html" (dict "name" . "attributes" `height=1.2em class="hx-inline-block hx-align-middle"`) -}}
-      {{- end -}}
-    {{- end -}}
-  </div>
-
-  <div class="hx-w-full hx-min-w-0 hx-leading-7">
-    <div class="hx-mt-6 hx-leading-7 first:hx-mt-0">
-      {{- $content -}}
-    </div>
-  </div>
-</div>

layouts/partials/shortcodes/card.html

@@ -7,8 +7,6 @@
 {{- $width := .width -}}
 {{- $height := .height -}}
 {{- $imageStyle := .imageStyle -}}
-{{- $tag := .tag -}}
-{{- $tagType := .tagType -}}
 
 {{ $linkClass := "hover:hx-border-gray-300 hx-bg-transparent hx-shadow-sm dark:hx-border-neutral-800 hover:hx-bg-slate-50 hover:hx-shadow-md dark:hover:hx-border-neutral-700 dark:hover:hx-bg-neutral-900" }}
 {{- with $image -}}
@@ -52,15 +50,5 @@
   {{- with $subtitle -}}
     <div class="hextra-card-subtitle hx-line-clamp-3 hx-text-sm hx-font-normal hx-text-gray-500 dark:hx-text-gray-400 hx-px-4 hx-mb-4 hx-mt-2">{{- $subtitle | markdownify -}}</div>
   {{- end -}}
-
-  {{- if $tag }}
-    {{- partial "shortcodes/badge.html" (dict
-      "content" $tag
-      "type" $tagType
-      "class" "hextra-card-tag"
-      "border" true
-      )
-    -}}
-  {{- end -}}
 </a>
 {{- /* Strip trailing newline. */ -}}

layouts/partials/shortcodes/cards.html

@@ -1,6 +0,0 @@
-{{- $cols := .cols | default 3 -}}
-{{- $content := .content -}}
-
-<div class="hextra-cards hx-mt-4 hx-gap-4 hx-grid not-prose" style="--hextra-cards-grid-cols: {{ $cols }};">
-  {{- $content -}}
-</div>

layouts/partials/sidebar.html

@@ -3,83 +3,48 @@
 {{- $disableSidebar := .disableSidebar | default false -}}
 {{- $displayPlaceholder := .displayPlaceholder | default false -}}
 
-{{/* EXPERIMENTAL - allow hiding sidebar on a per-page basis */}}
-{{- if $context.Params.sidebar.hide -}}
-  {{- $disableSidebar = true -}}
-  {{- $displayPlaceholder = true -}}
-{{- end -}}
-
 {{- $sidebarClass := cond $disableSidebar (cond $displayPlaceholder "md:hx-hidden xl:hx-block" "md:hx-hidden") "md:hx-sticky" -}}
 
 {{- $navRoot := cond (eq site.Home.Type "docs") site.Home $context.FirstSection -}}
 {{- $pageURL := $context.RelPermalink -}}
 
-{{- $data := slice -}}
+{{/* EXPERIMENTAL */}}
-{{- $dataMobile := (partialCached "components/sidebar/generate-mobile-data" site.Home site.Home) | unmarshal -}}
+{{- if .context.Params.sidebar.hide -}}
-
+  {{- $disableSidebar = true -}}
-{{- if (eq site.Params.page.sidebar.source "data") -}}
+  {{- $displayPlaceholder = true -}}
-  {{/* Get sidebar data from Hugo `data` directory */}}
-  {{- $data = partialCached "components/sidebar/get-section-data" $context $context.Section -}}
-{{- else -}}
-  {{/* Generate and cache sidebar data in memory */}}
-  {{- $data = (partialCached "components/sidebar/generate-section-data" $navRoot $navRoot) | unmarshal -}}
 {{- end -}}
 
-{{/* Cache rendered sidebar */}}
-{{- $shouldCache := site.Params.page.sidebar.cache | default false -}}
 
 <div class="mobile-menu-overlay [transition:background-color_1.5s_ease] hx-fixed hx-inset-0 hx-z-10 hx-bg-black/80 dark:hx-bg-black/60 hx-hidden"></div>
-
+<aside class="sidebar-container hx-flex hx-flex-col print:hx-hidden md:hx-top-16 md:hx-shrink-0 md:hx-w-64 md:hx-self-start max-md:[transform:translate3d(0,-100%,0)] {{ $sidebarClass }}">
-<aside class="hextra-sidebar-container hx-flex hx-flex-col print:hx-hidden md:hx-top-16 md:hx-shrink-0 md:hx-w-64 md:hx-self-start max-md:[transform:translate3d(0,-100%,0)] {{ $sidebarClass }}">
+  <!-- Search bar on small screen -->
-  {{/* Search bar on small screen */}}
+  <div class="hx-px-4 hx-pt-4 md:hx-hidden">
-  {{- partialCached "components/sidebar/mobile-search" . -}}
+    {{ partial "search.html" }}
+  </div>
   <div class="hextra-scrollbar hx-overflow-y-auto hx-overflow-x-hidden hx-p-4 hx-grow md:hx-h-[calc(100vh-var(--navbar-height)-var(--menu-height))]">
-    {{/* Mobile Navigation */}}
     <ul class="hx-flex hx-flex-col hx-gap-1 md:hx-hidden">
-      {{- with $dataMobile -}}{{- partial "components/sidebar/render-data" (dict "data" . "page" $context) -}}{{- end -}}
+      <!-- Nav -->
+      {{ template "sidebar-main" (dict "context" site.Home "pageURL" $pageURL "page" $context "toc" true) -}}
+      {{ template "sidebar-footer" }}
     </ul>
 
-    {{/* Sidebar on large screen */}}
+    <!-- Sidebar on large screen -->
     {{- if $disableSidebar -}}
       {{- if $displayPlaceholder }}<div class="max-xl:hx-hidden hx-h-0 hx-w-64 hx-shrink-0"></div>{{ end -}}
       {{ .context.Scratch.Set "enableFooterSwitches" true }}
     {{- else -}}
       <ul class="hx-flex hx-flex-col hx-gap-1 max-md:hx-hidden">
-        {{- with $data -}}
+        {{ template "sidebar-main" (dict "context" $navRoot "page" $context  "pageURL" $pageURL) }}
-          {{- if $shouldCache -}}
+        {{ template "sidebar-footer" }}
-            {{- partialCached "components/sidebar/render-data" (dict "data" . "page" $context "cached" $shouldCache) $navRoot -}}
-          {{- else -}}
-            {{- partial "components/sidebar/render-data" (dict "data" . "page" $context "cached" $shouldCache) -}}
-          {{- end -}}
-        {{- end -}}
-        {{- partialCached "components/sidebar/bottom" $context site.Home -}}
       </ul>
     {{ end -}}
-  <div style="position: absolute; top: 10px; right: 0; font-size: 10px; color: #888;">new</div>
   </div>
-  {{- partial "components/sidebar/switches" (dict "context" $context "disableSidebar" $disableSidebar) -}}
-</aside>
-
-{{- define "partials/components/sidebar/mobile-search" -}}
-  <div class="hx-px-4 hx-pt-4 md:hx-hidden">
-    {{- partialCached "search.html" . -}}
-  </div>
-{{- end -}}
-
-{{- define "partials/components/sidebar/switches" -}}
-  {{- $context := .context -}}
-  {{- $disableSidebar := .disableSidebar -}}
   {{/* Hide theme switch when sidebar is disabled */}}
   {{ $switchesClass := cond $disableSidebar "md:hx-hidden" "" -}}
   {{ $displayThemeToggle := (site.Params.theme.displayToggle | default true) -}}
 
   {{ if or hugo.IsMultilingual $displayThemeToggle }}
-    <div
+    <div class="{{ $switchesClass }} {{ with hugo.IsMultilingual }}hx-justify-end{{ end }} hx-sticky hx-bottom-0 hx-bg-white dark:hx-bg-dark hx-mx-4 hx-py-4 hx-shadow-[0_-12px_16px_#fff] hx-flex hx-items-center hx-gap-2 dark:hx-border-neutral-800 dark:hx-shadow-[0_-12px_16px_#111] contrast-more:hx-border-neutral-400 contrast-more:hx-shadow-none contrast-more:dark:hx-shadow-none hx-border-t" data-toggle-animation="show">
-      class="{{ $switchesClass }} {{ with hugo.IsMultilingual -}}
-        hx-justify-end
-      {{- end }} hx-sticky hx-bottom-0 hx-bg-white dark:hx-bg-dark hx-mx-4 hx-py-4 hx-shadow-[0_-12px_16px_#fff] hx-flex hx-items-center hx-gap-2 dark:hx-border-neutral-800 dark:hx-shadow-[0_-12px_16px_#111] contrast-more:hx-border-neutral-400 contrast-more:hx-shadow-none contrast-more:dark:hx-shadow-none hx-border-t"
-      data-toggle-animation="show"
-    >
       {{- with hugo.IsMultilingual -}}
         {{- partial "language-switch" (dict "context" $context "grow" true) -}}
         {{- with $displayThemeToggle }}{{ partial "theme-toggle" (dict "hideLabel" true) }}{{ end -}}
@@ -90,4 +55,124 @@
       {{- end -}}
     </div>
   {{- end -}}
+</aside>
+
+{{- define "sidebar-main" -}}
+  {{ template "sidebar-tree" (dict "context" .context "level" 0 "page" .page "pageURL" .pageURL "toc" (.toc | default false)) }}
+{{- end -}}
+
+{{- define "sidebar-tree" -}}
+  {{- if ge .level 4 -}}
+    {{- return -}}
+  {{- end -}}
+
+  {{- $context := .context -}}
+  {{- $page := .page }}
+  {{- $pageURL := .page.RelPermalink -}}
+  {{- $level := .level -}}
+  {{- $toc := .toc | default false -}}
+
+  {{- with $items := union .context.RegularPages .context.Sections -}}
+    {{- $items = where $items "Params.sidebar.exclude" "!=" true -}}
+    {{- if eq $level 0 -}}
+      {{- range $items.ByWeight }}
+        {{- if .Params.sidebar.separator -}}
+          <li class="[word-break:break-word] hx-mt-5 hx-mb-2 hx-px-2 hx-py-1.5 hx-text-sm hx-font-semibold hx-text-gray-900 first:hx-mt-0 dark:hx-text-gray-100">
+            <span class="hx-cursor-default">{{ partial "utils/title" . }}</span>
+          </li>
+        {{- else -}}
+          {{- $active := eq $pageURL .RelPermalink -}}
+          {{- $shouldOpen := or (.Params.sidebar.open) (.IsAncestor $page) $active | default true }}
+          <li class="{{ if $shouldOpen }}open{{ end }}">
+            {{- $linkTitle := partial "utils/title" . -}}
+            {{- template "sidebar-item-link" dict "context" . "active" $active "title" $linkTitle "link" .RelPermalink -}}
+            {{- if and $toc $active -}}
+              {{- template "sidebar-toc" dict "page" . -}}
+            {{- end -}}
+            {{- template "sidebar-tree" dict "context" . "page" $page "pageURL" $pageURL "level" (add $level 1) "toc" $toc -}}
+          </li>
+        {{- end -}}
+      {{- end -}}
+    {{- else -}}
+      <div class="ltr:hx-pr-0 hx-overflow-hidden">
+        <ul class='hx-relative hx-flex hx-flex-col hx-gap-1 before:hx-absolute before:hx-inset-y-1 before:hx-w-px before:hx-bg-gray-200 before:hx-content-[""] ltr:hx-ml-3 ltr:hx-pl-3 ltr:before:hx-left-0 rtl:hx-mr-3 rtl:hx-pr-3 rtl:before:hx-right-0 dark:before:hx-bg-neutral-800'>
+          {{- range $items.ByWeight }}
+            {{- $active := eq $pageURL .RelPermalink -}}
+            {{- $shouldOpen := or (.Params.sidebar.open) (.IsAncestor $page) $active | default true }}
+            {{- $linkTitle := partial "utils/title" . -}}
+            <li class="hx-flex hx-flex-col {{ if $shouldOpen }}open{{ end }}">
+              {{- template "sidebar-item-link" dict "context" . "active" $active "title" $linkTitle "link" .RelPermalink -}}
+              {{- if and $toc $active -}}
+                {{ template "sidebar-toc" dict "page" . }}
+              {{- end }}
+              {{ template "sidebar-tree" dict "context" . "page" $page "pageURL" $pageURL "level" (add $level 1) "toc" $toc }}
+            </li>
+          {{- end -}}
+        </ul>
+      </div>
+    {{- end -}}
+  {{- end }}
+{{- end -}}
+
+{{- define "sidebar-toc" -}}
+  {{ $page := .page }}
+  {{ with $page.Fragments.Headings }}
+    <ul class='hx-flex hx-flex-col hx-gap-1 hx-relative before:hx-absolute before:hx-inset-y-1 before:hx-w-px before:hx-bg-gray-200 before:hx-content-[""] dark:before:hx-bg-neutral-800 ltr:hx-pl-3 ltr:before:hx-left-0 rtl:hx-pr-3 rtl:before:hx-right-0 ltr:hx-ml-3 rtl:hx-mr-3'>
+      {{- range . }}
+        {{- with .Headings }}
+          {{- range . -}}
+            <li>
+              <a
+                href="#{{ anchorize .ID }}"
+                class="hx-flex hx-rounded hx-px-2 hx-py-1.5 hx-text-sm hx-transition-colors [word-break:break-word] hx-cursor-pointer [-webkit-tap-highlight-color:transparent] [-webkit-touch-callout:none] contrast-more:hx-border hx-gap-2 before:hx-opacity-25 before:hx-content-['#'] hx-text-gray-500 hover:hx-bg-gray-100 hover:hx-text-gray-900 dark:hx-text-neutral-400 dark:hover:hx-bg-primary-100/5 dark:hover:hx-text-gray-50 contrast-more:hx-text-gray-900 contrast-more:dark:hx-text-gray-50 contrast-more:hx-border-transparent contrast-more:hover:hx-border-gray-900 contrast-more:dark:hover:hx-border-gray-50"
+              >
+                {{- .Title -}}
+              </a>
+            </li>
+          {{ end -}}
+        {{ end -}}
+      {{ end -}}
+    </ul>
+  {{ end }}
+{{- end -}}
+
+{{- define "sidebar-footer" -}}
+  {{- range site.Menus.sidebar -}}
+    {{- $name := or (T .Identifier) .Name -}}
+    {{ if eq .Params.type "separator" }}
+      <li class="[word-break:break-word] hx-mt-5 hx-mb-2 hx-px-2 hx-py-1.5 hx-text-sm hx-font-semibold hx-text-gray-900 first:hx-mt-0 dark:hx-text-gray-100">
+        <span class="hx-cursor-default">{{ $name }}</span>
+      </li>
+    {{ else }}
+      <li>{{ template "sidebar-item-link" dict "active" false "title" $name "link" (.URL | relLangURL) }}</li>
+    {{ end }}
+  {{- end -}}
+{{- end -}}
+
+{{- define "sidebar-item-link" -}}
+  {{- $external := strings.HasPrefix .link "http" -}}
+  {{- $open := .open | default true -}}
+  <a
+    class="hx-flex hx-items-center hx-justify-between hx-gap-2 hx-cursor-pointer hx-rounded hx-px-2 hx-py-1.5 hx-text-sm hx-transition-colors [-webkit-tap-highlight-color:transparent] [-webkit-touch-callout:none] [word-break:break-word]
+    {{- if .active }}
+      sidebar-active-item hx-bg-primary-100 hx-font-semibold hx-text-primary-800 contrast-more:hx-border contrast-more:hx-border-primary-500 dark:hx-bg-primary-400/10 dark:hx-text-primary-600 contrast-more:dark:hx-border-primary-500
+    {{- else }}
+      hx-text-gray-500 hover:hx-bg-gray-100 hover:hx-text-gray-900 contrast-more:hx-border contrast-more:hx-border-transparent contrast-more:hx-text-gray-900 contrast-more:hover:hx-border-gray-900 dark:hx-text-neutral-400 dark:hover:hx-bg-primary-100/5 dark:hover:hx-text-gray-50 contrast-more:dark:hx-text-gray-50 contrast-more:dark:hover:hx-border-gray-50
+    {{- end -}}"
+    href="{{ .link }}"
+    {{ if $external }}target="_blank" rel="noreferer"{{ end }}
+  >
+    {{- .title -}}
+    {{- with .context }}
+      {{- if or .RegularPages .Sections }}
+        <span class="hextra-sidebar-collapsible-button">
+          {{- template "sidebar-collapsible-button" -}}
+        </span>
+      {{- end }}
+    {{ end -}}
+  </a>
+{{- end -}}
+
+{{- define "sidebar-collapsible-button" -}}
+  <svg fill="none" viewBox="0 0 24 24" stroke="currentColor" class="hx-h-[18px] hx-min-w-[18px] hx-rounded-sm hx-p-0.5 hover:hx-bg-gray-800/5 dark:hover:hx-bg-gray-100/5"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" class="hx-origin-center hx-transition-transform rtl:-hx-rotate-180"></path></svg>
 {{- end -}}

layouts/partials/toc.html

@@ -38,7 +38,7 @@
               {{- $editURL = urls.JoinPath $editURL $sourceDir $path -}}
             {{- end -}}
           {{- end -}}
-          <a class="hx-text-xs hx-font-medium hx-text-gray-500 hover:hx-text-gray-900 dark:hx-text-gray-400 dark:hover:hx-text-gray-100 contrast-more:hx-text-gray-800 contrast-more:dark:hx-text-gray-50" href="{{ $editURL }}" target="_blank" rel="noreferrer">{{ $editThisPage }}</a>
+          <a class="hx-text-xs hx-font-medium hx-text-gray-500 hover:hx-text-gray-900 dark:hx-text-gray-400 dark:hover:hx-text-gray-100 contrast-more:hx-text-gray-800 contrast-more:dark:hx-text-gray-50" href="{{ $editURL }}" target="_blank" rel="noreferer">{{ $editThisPage }}</a>
         {{- end -}}
         {{/* Scroll To Top */}}
         <button aria-hidden="true" id="backToTop" onClick="scrollUp();" class="hx-transition-all hx-duration-75 hx-opacity-0 hx-text-xs hx-font-medium hx-text-gray-500 hover:hx-text-gray-900 dark:hx-text-gray-400 dark:hover:hx-text-gray-100 contrast-more:hx-text-gray-800 contrast-more:dark:hx-text-gray-50">

layouts/partials/utils/translated-page.html

@@ -1,17 +0,0 @@
-{{/*
-  Utility to retrieve a translated page given a page and a language code.
-
-  If the page is not translated, it returns the original page.
-*/}}
-{{- $page := .page -}}
-{{- $lang := .lang -}}
-
-{{- if $page.IsTranslated -}}
-  {{- range $page.AllTranslations -}}
-    {{- if eq .Language.LanguageCode $lang -}}
-      {{- $page = . -}}
-    {{- end -}}
-  {{- end -}}
-{{- end -}}
-
-{{- return $page -}}

layouts/shortcodes/badge.html

@@ -1,36 +0,0 @@
-{{- if .IsNamedParams -}}
-  {{- $content := .Get "content" -}}
-  {{- $type := .Get "type" | default "" -}}
-  {{- $class := .Get "class" | default "" -}}
-  {{- $link := .Get "link" | default "" -}}
-  {{- $icon := .Get "icon" | default "" -}}
-
-  {{- if $link -}}
-    <a href="{{ $link }}" title="{{ $content | plainify }}" target="_blank">
-      {{- partial "shortcodes/badge.html" (dict
-        "content" $content 
-        "type" $type
-        "class" $class
-        "border" true
-        "icon" $icon
-        )
-      -}}
-    </a>
-  {{- else -}}
-    {{- partial "shortcodes/badge.html" (dict
-      "content" $content 
-      "type" $type
-      "class" $class
-      "border" true
-      "icon" $icon
-      )
-    -}}
-  {{- end -}}
-{{- else -}}
-  {{- $content := .Get 0 -}}
-  {{- partial "shortcodes/badge.html" (dict
-    "content" $content 
-    "border" true
-    )
-  -}}
-{{- end -}}

layouts/shortcodes/callout.html

@@ -1,19 +1,37 @@
-{{- $calloutEmojiDict := dict "info" "ℹ️" "warning" "⚠️" "error" "🚫" -}}
+{{ $calloutEmojiDict := dict "info" "ℹ️" "warning" "⚠️" "error" "🚫" }}
-{{- $type := .Get "type" | default "default" -}}
+{{ $type := .Get "type" | default "default" }}
 {{/* If emoji is not set, use the emoji from dict */}}
-{{- $emoji := .Get "emoji" -}}
+{{ $emoji := .Get "emoji" }}
-{{- if eq $emoji "" -}}
+{{ if eq $emoji "" }}
-  {{- $emoji = index $calloutEmojiDict $type -}}
+  {{ $emoji = index $calloutEmojiDict $type }}
-{{- end -}}
+{{ end }}
 {{/* Also allow using "icon" */}}
-{{- $icon := .Get "icon" -}}
+{{ $icon := .Get "icon" }}
-{{- $content := .InnerDeindent | markdownify -}}
 
-{{- $defaultClass := "hx-border-orange-100 hx-bg-orange-50 hx-text-orange-800 dark:hx-border-orange-400/30 dark:hx-bg-orange-400/20 dark:hx-text-orange-300" -}}
+{{ $defaultClass := "hx-border-orange-100 hx-bg-orange-50 hx-text-orange-800 dark:hx-border-orange-400/30 dark:hx-bg-orange-400/20 dark:hx-text-orange-300" }}
-{{- $infoClass := "hx-border-blue-200 hx-bg-blue-100 hx-text-blue-900 dark:hx-border-blue-200/30 dark:hx-bg-blue-900/30 dark:hx-text-blue-200" -}}
+{{ $infoClass := "hx-border-blue-200 hx-bg-blue-100 hx-text-blue-900 dark:hx-border-blue-200/30 dark:hx-bg-blue-900/30 dark:hx-text-blue-200" }}
-{{- $warningClass := "hx-border-yellow-100 hx-bg-yellow-50 hx-text-yellow-900 dark:hx-border-yellow-200/30 dark:hx-bg-yellow-700/30 dark:hx-text-yellow-200" -}}
+{{ $warningClass := "hx-border-yellow-100 hx-bg-yellow-50 hx-text-yellow-900 dark:hx-border-yellow-200/30 dark:hx-bg-yellow-700/30 dark:hx-text-yellow-200" }}
-{{- $errorClass := "hx-border-red-200 hx-bg-red-100 hx-text-red-900 dark:hx-border-red-200/30 dark:hx-bg-red-900/30 dark:hx-text-red-200" -}}
+{{ $errorClass := "hx-border-red-200 hx-bg-red-100 hx-text-red-900 dark:hx-border-red-200/30 dark:hx-bg-red-900/30 dark:hx-text-red-200" }}
 
-{{- $class := cond (eq $type "info") $infoClass (cond (eq $type "warning") $warningClass (cond (eq $type "error") $errorClass $defaultClass)) -}}
+{{ $class := cond (eq $type "info") $infoClass (cond (eq $type "warning") $warningClass (cond (eq $type "error") $errorClass $defaultClass)) }}
 
-{{- partial "shortcodes/callout.html" (dict "content" $content "emoji" $emoji "icon" $icon "class" $class) -}}
+
+<div class="hx-overflow-x-auto hx-mt-6 hx-flex hx-rounded-lg hx-border hx-py-2 ltr:hx-pr-4 rtl:hx-pl-4 contrast-more:hx-border-current contrast-more:dark:hx-border-current {{ $class }}">
+  <div class="ltr:hx-pl-3 ltr:hx-pr-2 rtl:hx-pr-3 rtl:hx-pl-2">
+    {{- with $emoji -}}
+      <div class="hx-select-none hx-text-xl" style="font-family: 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol';">
+        {{ . }}
+      </div>
+    {{- else -}}
+      {{- with $icon }}
+        {{ partial "utils/icon.html" (dict "name" . "attributes" `height=1.2em class="hx-inline-block hx-align-middle"`) -}}
+      {{- end -}}
+    {{- end -}}
+  </div>
+
+  <div class="hx-w-full hx-min-w-0 hx-leading-7">
+    <div class="hx-mt-6 hx-leading-7 first:hx-mt-0">
+      {{ .InnerDeindent | markdownify }}
+    </div>
+  </div>
+</div>

layouts/shortcodes/card.html

@@ -7,8 +7,6 @@
 {{- $width := 0 -}}
 {{- $height := 0 -}}
 {{- $imageStyle := .Get "imageStyle" -}}
-{{- $tag := .Get "tag" -}}
-{{- $tagType := .Get "tagType" -}}
 
 {{/* Image processing options */}}
 {{- $method := .Get "method" | default "Resize" | humanize -}}
@@ -50,7 +48,5 @@
   "width"       $width
   "height"      $height
   "imageStyle"  $imageStyle
-  "tag"         $tag
-  "tagType"     $tagType
   )
 -}}

layouts/shortcodes/cards.html

@@ -1,3 +1,5 @@
 {{- $cols := .Get "cols" | default 3 -}}
 
-{{- partial "shortcodes/cards" (dict "cols" $cols "content" .Inner) -}}
+<div class="hextra-cards hx-mt-4 hx-gap-4 hx-grid not-prose" style="--hextra-cards-grid-cols: {{ $cols }};">
+  {{- .Inner -}}
+</div>

layouts/shortcodes/hextra/hero-section.html

@@ -1,10 +0,0 @@
-{{- $style := .Get "style" -}}
-{{- $heading := int (strings.TrimPrefix "h" (.Get "heading" | default "h2")) -}}
-{{- $size := cond (ge $heading 4) "xl" (cond (eq $heading 3) "2xl" "4xl") -}}
-
-<h{{ $heading }}
-  class="not-prose hx-text-{{ $size }} hx-font-bold hx-leading-none hx-tracking-tighter md:hx-text-3xl hx-py-2 hx-bg-clip-text hx-text-transparent hx-bg-gradient-to-r hx-from-gray-900 hx-to-gray-600 dark:hx-from-gray-100 dark:hx-to-gray-400"
-  {{ with $style }}style="{{ . | safeCSS }}"{{ end }}
->
-  {{ .Inner | markdownify }}
-</h{{ $heading }}>

layouts/shortcodes/include.html

@@ -5,7 +5,7 @@ Renders the page using the RenderShortcode method on the Page object.
 
 You must call this shortcode using the {{% %}} notation.
 
-@param {string} (positional parameter 0) The path to the page, relative to the content directory.
+@param {string} (postional parameter 0) The path to the page, relative to the content directory.
 @returns template.HTML
 
 @example {{% include "functions/_common/glob-patterns" %}}

layouts/shortcodes/jupyter.html

@@ -1,81 +0,0 @@
-{{/* Render Jupyter Notebook */}}
-{{- $path := .Get 0 -}}
-{{- $data := "" -}}
-{{- $page := .Page -}}
-
-{{- $isLocal := not (urls.Parse $path).Scheme -}}
-{{- $isPage := and (eq .Page.Kind "page") (not .Page.BundleType) -}}
-
-{{/* https://gohugo.io/functions/transform/unmarshal/ */}}
-{{- if (not $isLocal) -}}
-  {{- with resources.GetRemote $path -}}
-    {{- with unmarshal .Content -}}{{- $data = . -}}{{- end -}}
-  {{- else -}}
-    {{- errorf "Remote resource not found: %s" $path -}}
-  {{- end -}}
-{{- else if (not $isPage) -}}
-  {{- with .Page.Resources.Get $path -}}
-    {{- with unmarshal .Content -}}{{- $data = . -}}{{- end -}}
-  {{- else -}}
-    {{- errorf "Local resource not found: %s" $path -}}
-  {{- end -}}
-{{- else -}}
-  {{- with resources.Get $path -}}
-    {{- with unmarshal .Content -}}{{- $data = . -}}{{- end -}}
-  {{- else -}}
-    {{- errorf "Local resource not found: %s" $path -}}
-  {{- end -}}
-{{- end -}}
-
-{{- $language := index $data "metadata" "language_info" "name" | default "python" -}}
-
-{{- with index $data "cells" -}}
-  {{- range $cell := . -}}
-    {{- if eq (index $cell "cell_type") "code" -}}
-      {{- $source := index $cell "source" -}}
-      {{- $sourceContent := (cond (reflect.IsSlice $source) (delimit $source "") $source) -}}
-{{- with ($sourceContent | strings.Chomp) -}}
-{{ (printf "\n\n```%s\n%s\n```\n" $language .) | safeHTML -}}
-{{- end -}}
-
-      <div class="hextra-jupyter-code-cell hextra-scrollbar">
-        {{- $outputs := index $cell "outputs" -}}
-        {{- with $outputs -}}
-          <div class="hextra-jupyter-code-cell-outputs-container">
-            <div class="hextra-jupyter-code-cell-outputs">
-              {{- range $output := . -}}
-                {{- if eq (index $output "output_type") "display_data" -}}
-                  {{- $data := index $output "data" -}}
-                  {{- $image := index $data "image/png" -}}
-                  {{- if $image -}}
-                    <img src="data:image/png;base64,{{- $image -}}" alt="image" />
-                  {{- end -}}
-                {{- else if eq (index $output "output_type") "stream" -}}
-                  {{- $text := index $output "text" -}}
-                  {{- $textContent := (cond (reflect.IsSlice $text) (delimit $text "") $text) -}}
-                  <pre class="not-prose">{{- $textContent -}}</pre>
-                {{- else if eq (index $output "output_type") "execute_result" -}}
-                  {{- $data := index $output "data" -}}
-                  {{- $text := index $data "text/plain" -}}
-                  {{- $textContent := (cond (reflect.IsSlice $text) (delimit $text "") $text) -}}
-                  <pre class="not-prose">{{- $textContent -}}</pre>
-                  {{- $html := index $data "text/html" -}}
-                  {{- if $html -}}
-                    {{- $htmlText := delimit $html "" -}}
-                    <div>
-                      {{- $htmlText | safeHTML -}}
-                    </div>
-                  {{- end -}}
-                {{- end -}}
-              {{- end -}}
-            </div>
-          </div>
-        {{- end -}}
-      </div>
-    {{- else if eq (index $cell "cell_type") "markdown" -}}
-        {{- $source := index $cell "source" }}
-        {{- $sourceContent := (cond (reflect.IsSlice $source) (delimit $source "") $source) }}
-{{ (printf "\n%s\n" $sourceContent) | safeHTML }}
-    {{- end -}}
-  {{- end -}}
-{{- end -}}

layouts/shortcodes/tab.html

@@ -1,12 +1,11 @@
 {{- $defaultIndex := int ((.Parent.Get "defaultIndex") | default "0") -}}
 
 <div
-  class="hextra-tabs-panel hx-rounded hx-pt-6 hx-hidden data-[state=selected]:hx-block"
+  class="tabs-panel hx-rounded hx-pt-6 hx-hidden data-[state=selected]:hx-block"
   id="tabs-panel-{{ .Ordinal }}"
   role="tabpanel"
-  {{- if eq .Ordinal $defaultIndex }} tabindex="0" {{ end -}}
+  {{ if eq .Ordinal $defaultIndex }}tabindex="0"{{ end }}
-  {{- if eq .Ordinal $defaultIndex }} data-state="selected" {{ end -}}
+  {{ if eq .Ordinal $defaultIndex }}data-state="selected"{{ end }}
 >
-  {{- .InnerDeindent | markdownify -}}
+  {{ .InnerDeindent | markdownify }}
 </div>
-{{- /* Drop trailing newlines */ -}}

layouts/shortcodes/tabs.html

@@ -5,24 +5,22 @@
   {{ errorf "no items provided" }}
 {{- end -}}
 
-<div class="hextra-scrollbar hx-overflow-x-auto hx-overflow-y-hidden hx-overscroll-x-contain">
+
-  <div class="hx-mt-4 hx-flex hx-w-max hx-min-w-full hx-border-b hx-border-gray-200 hx-pb-px dark:hx-border-neutral-800">
+<div class="hx-mt-4 hx-flex hx-w-max hx-min-w-full hx-border-b hx-border-gray-200 hx-pb-px dark:hx-border-neutral-800">
-    {{- range $i, $item := $items -}}
+  {{- range $i, $item := $items -}}
-      <button
+    <button
-        class="hextra-tabs-toggle data-[state=selected]:hx-border-primary-500 data-[state=selected]:hx-text-primary-600 data-[state=selected]:dark:hx-border-primary-500 data-[state=selected]:dark:hx-text-primary-600 hx-mr-2 hx-rounded-t hx-p-2 hx-font-medium hx-leading-5 hx-transition-colors -hx-mb-0.5 hx-select-none hx-border-b-2 hx-border-transparent hx-text-gray-600 hover:hx-border-gray-200 hover:hx-text-black dark:hx-text-gray-200 dark:hover:hx-border-neutral-800 dark:hover:hx-text-white"
+      class="tabs-toggle data-[state=selected]:hx-border-primary-500 data-[state=selected]:hx-text-primary-600 hx-mr-2 hx-rounded-t hx-p-2 hx-font-medium hx-leading-5 hx-transition-colors -hx-mb-0.5 hx-select-none hx-border-b-2 hx-border-transparent hx-text-gray-600 hover:hx-border-gray-200 hover:hx-text-black dark:hx-text-gray-200 dark:hover:hx-border-neutral-800 dark:hover:hx-text-white"
-        role="tab"
+      role="tab"
-        type="button"
+      type="button"
-        aria-controls="tabs-panel-{{ $i }}"
+      aria-controls="tabs-panel-{{ $i }}"
-        {{- if eq $i $defaultIndex }} aria-selected="true" {{ end -}}
+      {{ if eq $i $defaultIndex }}aria-selected="true"{{ end }}
-        {{- if eq $i $defaultIndex }} tabindex="0" {{ end -}}
+      {{ if eq $i $defaultIndex }}tabindex="0"{{ end }}
-        {{- if eq $i $defaultIndex }} data-state="selected"{{ end -}}
+      {{ if eq $i $defaultIndex }}data-state="selected"{{ end }}
-      >
+    >
-        {{- $item -}}
+      {{- $item -}}
-      </button>
+    </button>
-    {{- end -}}
+  {{- end -}}
-  </div>
 </div>
 <div>
-  {{- .Inner -}}
+  {{ .Inner }}
 </div>
-{{- /* Drop trailing newlines */ -}}

netlify.toml

@@ -7,6 +7,6 @@ command = "cd exampleSite && hugo --gc --minify --themesDir ../.. -b ${DEPLOY_PR
 ignore = "false"
 
 [build.environment]
-HUGO_VERSION = "0.138.0"
+HUGO_VERSION = "0.126.1"
 GO_VERSION = "1.22.3"
 NODE_VERSION = "22.2.0"

tailwind.config.js

@@ -3,18 +3,10 @@ const colors = require('tailwindcss/colors')
 const makePrimaryColor =
   l =>
     ({ opacityValue }) => {
-      let result = "hsl(var(--primary-hue) var(--primary-saturation) ";
+      return (
-        if (l <= 50) {
+        `hsl(var(--primary-hue) var(--primary-saturation) ${l}%` +
-          // Interpolate between lower values
+        (opacityValue ? ` / ${opacityValue})` : ')')
-          result+= `calc(calc(var(--primary-lightness) / 50) * ${l})`;
+      )
-        }
-        else {
-          // Interpolate between higher values
-          result+= `calc(var(--primary-lightness) + calc(calc(100% - var(--primary-lightness)) / 50) * ${l - 50})`;
-        }
-
-      result += (opacityValue ? ` / ${opacityValue})` : ')');
-      return result;
     }
 
 /** @type {import('tailwindcss').Config} */
@@ -61,11 +53,8 @@ module.exports = {
       neutral: colors.neutral,
       red: colors.red,
       orange: colors.orange,
-      green: colors.green,
-      indigo: colors.indigo,
       blue: colors.blue,
       yellow: colors.yellow,
-      amber: colors.amber,
       primary: {
         50: makePrimaryColor(97),
         100: makePrimaryColor(94),

taskfile.yaml

@@ -25,4 +25,4 @@ tasks:
       - curl -o assets/lib/katex/katex.min.css https://cdn.jsdelivr.net/npm/katex@latest/dist/katex.min.css
       - curl -o assets/lib/katex/auto-render.min.js https://cdn.jsdelivr.net/npm/katex@0.16.10/dist/contrib/auto-render.min.js
       - curl -o assets/lib/katex/mhchem.min.js https://cdn.jsdelivr.net/npm/katex@0.16.10/dist/contrib/mhchem.min.js
-      - curl -o assets/lib/mermaid/mermaid.min.js https://cdn.jsdelivr.net/npm/mermaid@11.3.0/dist/mermaid.min.js
+      - curl -o assets/lib/mermaid/mermaid.min.js https://cdn.jsdelivr.net/npm/mermaid@10.9.0/dist/mermaid.min.js