elixir-toolkit-theme 4.2.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 140b7c66e0c04dfbbe10dc5492792c43c88d6a871f74f73a48f317ba7bcb80d6
-  data.tar.gz: 1dbd0f382dc4e151582c1bee5bbc596be339281a62b8d90fab3baf2ab79d1695
+  metadata.gz: 28d3405180b694d3008b2189a0bb9a16ee0ea46295d1d9e1f54b0c0615dc08c1
+  data.tar.gz: b84be0a971922c139d39379443cddd58f07514d5578c7d38364dc1361c63484f
 SHA512:
-  metadata.gz: 6d078fc983828cfd6744289648dd8f609d5364d8eb8eb80de04863879cb57840b73f988ed8500a9a0e14b3c3364b953552fe0182f396f2ffa75ac67af825f32b
-  data.tar.gz: 2563b4a109f9682e11bc96e550dd7c13e4ee5c6ad3404739d0f3ccf871cd995520a6d1914526a87fbda26890c01011f7803c15905f1f701ee6374863fad0f395
+  metadata.gz: e72c7d4ed2724a743f37e71223547bdfa2dbd472d050ecb4a8e130d6081bf3c4a1bd9fbd2d4136c58616484bd7bb189a472ca203953944a08f41914175e89180
+  data.tar.gz: 3effd307d58a441330ef53c2b76377d41dac38552bf881e0c87d4f1d844acdf21fc9e1130945ffbb6a8d0389c8a921b59dfe453f4948741de552c405d25c40a6

data/README.md

@@ -37,7 +37,7 @@ remote_theme: ELIXIR-Belgium/elixir-toolkit-theme
 You can lock it onto a specific version using:
 
 ```yaml
-remote_theme: ELIXIR-Belgium/elixir-toolkit-theme@4.1.0
+remote_theme: ELIXIR-Belgium/elixir-toolkit-theme@5.0.0
 ```
 
 ### Using Ruby Gems (alternative)
@@ -50,7 +50,7 @@ gem "elixir-toolkit-theme"
 You can lock it onto a specific version like this:
 
 ```ruby
-gem "elixir-toolkit-theme", "~> 4.1.0"
+gem "elixir-toolkit-theme", "~> 5.0.0"
 ```
 
 And add this line to your Jekyll site's `_config.yml`:
@@ -81,7 +81,7 @@ NOTE: This way of deploying does not support the tool-tag in the text of the mar
 Add an extra `.gitlab-ci.yml` file in the root of the repo with:
 
 ```yml
-image: ruby:2.7
+image: ruby:3.3
 
 variables:
   JEKYLL_ENV: production
@@ -131,6 +131,7 @@ pages:
     ```
     JEKYLL_ENV=production PAGES_REPO_NWO='USER_OR_ORGANISATION/REPO_NAME' bundle exec jekyll serve --baseurl ""
     ```
+Where `USER_OR_ORGANISATION/REPO_NAME` is the GitHub USER_OR_ORGANISATION/REPO_NAME (to be found in the url).
 
 1. To preview your site, in your web browser, navigate to `http://localhost:4000`.
    
@@ -169,6 +170,9 @@ This will start the docker container and serve the website locally. Make sure th
 - [FAIRDOM-SEEK Documentation](https://docs.seek4science.org/) (SEEK community)
 - [FAIR Lesson Plan Handbook](https://elixir-europe-training.github.io/ELIXIR-TrP-FAIR-Converge/)  (ELIXIR Training platform)
 - [Data Steward Handbook](https://elixir-uk.github.io/elixir-ds-handbook) (ELIXIR RDM Community)
+- [Fed-A-Crate](https://elixir-europe.github.io/fed-a-crate/how-to-contribute) (ELIXIR Fed-A-Crate project)
+- [Federated Learning toolkit (FLkit)](https://uhasselt-biomedicaldatasciences.github.io/federated-learning-toolkit/) (UHasselt)
+- [mTeSS-X](https://elixirtess.github.io/mTeSS-X/) (OSCARS project)
 - Want your instance here? [Open an issue](https://github.com/ELIXIR-Belgium/elixir-toolkit-theme/issues)
 
 ## Dependencies

data/_includes/contributor-carousel-selection.html

@@ -1,3 +1,4 @@
+{%- assign carousel_counter = carousel_counter | plus: 1 %}
 {%- assign contributors = site.data.CONTRIBUTORS %}
 {%- assign allcontrstr = nil %}
 {%- assign nr = include.col | default: 5 %}
@@ -39,7 +40,7 @@
 {%- assign allcontributors = allcontributors | sort %}
 {%- endunless %}
 {%- unless allcontributors.size == 0 %}
-<div id="contributors-carousel" class="carousel carousel-dark slide my-4" data-ride="carousel" data-bs-interval="7000">
+<div id="contributors-carousel-{{carousel_counter}}" class="carousel carousel-dark slide my-4" data-ride="carousel" data-bs-interval="7000">
     <div class="carousel-inner">
         {%- assign counter = 0 %}
         {%- for contributor in allcontributors %}
@@ -111,11 +112,11 @@
         </div>
         {%- endif %}
         {%- endfor %}
-        <button class="carousel-control-prev" type="button" data-bs-target="#contributors-carousel" data-bs-slide="prev">
+        <button class="carousel-control-prev" type="button" data-bs-target="#contributors-carousel-{{carousel_counter}}" data-bs-slide="prev">
             <span class="carousel-control-prev-icon" aria-hidden="true"></span>
             <span class="visually-hidden">Previous</span>
         </button>
-        <button class="carousel-control-next" type="button" data-bs-target="#contributors-carousel" data-bs-slide="next">
+        <button class="carousel-control-next" type="button" data-bs-target="#contributors-carousel-{{carousel_counter}}" data-bs-slide="next">
             <span class="carousel-control-next-icon" aria-hidden="true"></span>
             <span class="visually-hidden">Next</span>
         </button>

data/_includes/contributor-minitiles-page.html

@@ -1,8 +1,11 @@
-{%- if page.contributors and page.contributors.size != 0 %}
+{%- assign EMPTY = "" | split: "" -%}
+{%- assign contrib_list = page.contributors | default: EMPTY -%}
+{%- assign coord_list  = page.coordinators | default: EMPTY -%}
+{%- if contrib_list.size > 0 or coord_list.size > 0 -%}
 <span class="d-block h2-like fs-2">{{site.theme_variables.contributor-minitiles-page | default: 'Contributors' }}</span>
 <div class="p-4 rounded mt-4 page-contributors d-flex flex-wrap gap-2">
     {%- assign contributors = site.data.CONTRIBUTORS %}
-    {%- assign page_contributors = page.contributors %}
+    {%- assign page_contributors = contrib_list | concat: coord_list | uniq %}
     {%- unless include.sort == false %}
     {%- assign page_contributors = page_contributors | sort %}
     {%- endunless %}
@@ -35,9 +38,7 @@
           <div>
               {{ contributor }}
           </div>
-        {%- if page.coordinators %}
-        {%- for coordinator in page.coordinators %}
-        {%- if coordinator == contributor %}
+        {%- if page.coordinators.size != 0 and page.coordinators contains contributor %}
         <div class="position-absolute top-0 start-100 translate-middle">
             <div class="rounded-circle coordinator-crown">
               <a data-bs-toggle="tooltip" data-bs-original-title="Coordinator of the {{page.title}} page.">
@@ -46,8 +47,6 @@
             </div>
         </div>
         {%- endif %}
-        {%- endfor %}
-        {%- endif %}
       </button>
         <div class="dropdown-menu shadow p-0 border-0 contributor-cards">
 

data/_includes/events.html

@@ -2,7 +2,7 @@
   {%- if include.title == true%}
   <h2>{{include.event_type | replace: "_", " " | capitalize}}s</h2>
   {%- endif %}
-  {%- assign events = site.data.events %}
+  {%- assign events = site.data.events | sort: "startDate" | reverse %}
   {%- assign count = 0 %}
   <ul class="list-unstyled mt-3">
     {%- for event in events %}

data/_includes/footer.html

@@ -1,5 +1,12 @@
+{%- assign EMPTY = "" | split: "" %}
+{%- assign footer_columns = site.data.footer.columns | default: EMPTY %}
+{%- assign footer_copyright = site.data.footer.copyright %}
+{%- assign footer_extra_line = site.data.footer.extra_line %}
+{%- if footer_columns != EMPTY or footer_copyright or footer_extra_line %}
 <footer id="footer">
+    {%- if footer_columns != EMPTY or footer_extra_line %}
     <div class="container py-4 g-lg-5">
+        {%- if footer_columns != EMPTY %}
         <div class="row g-4 d-flex justify-content-between">
             {%- for column in site.data.footer.columns %}
             {%- if column.type == "image" %}
@@ -32,19 +39,21 @@
             {%- endif %}
             {%- endfor %}
         </div>
-        {%- unless site.data.footer.extra_line == nil %}
+        {%- endif %}
+        {%- if footer_extra_line %}
         <div class="row">
             <div class="text-center pt-4 mb-0">
-                {{site.data.footer.extra_line | markdownify }}
+                {{footer_extra_line | markdownify }}
             </div>
         </div>
-        {%- endunless %}
+        {%- endif %}
     </div>
+    {%- endif %}
     <div class="copyright py-4">
         <div class="container g-lg-5 d-flex justify-content-between flex-column flex-lg-row">
-            {%- unless site.data.footer.copyright == nil %}
-            <div class="d-flex align-items-center mb-3 mb-lg-0 mx-auto mx-lg-0 text-center">{{ site.data.footer.copyright | markdownify }}</div>
-            {%- endunless %}
+            {%- if footer_copyright %}
+            <div class="d-flex align-items-center mb-3 mb-lg-0 mx-auto mx-lg-0 text-center">{{ footer_copyright | markdownify }}</div>
+            {%- endif %}
             <div class="d-flex align-items-center mx-auto ms-lg-4 me-lg-0">
                 <a id="ett-logo" class="text-nowrap me-lg-5 me-xxlg-0" href="https://elixir-belgium.github.io/elixir-toolkit-theme">Built with
                     <svg data-name="ETT logo" xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 77.2 77.12">
@@ -72,3 +81,4 @@
         </div>
     </div>
 </footer>
+{%- endif %}

data/_includes/github-buttons.html

@@ -1,20 +1,16 @@
 {%- assign show_github_edit_button = site.theme_variables.github_buttons.edit_me | default: true %}
 {%- assign show_github_history_button = site.theme_variables.github_buttons.history | default: true %}
 {%- assign show_github_open_issue_button = site.theme_variables.github_buttons.open_issue | default: true %}
-
 {%- if show_github_edit_button or show_github_history_button or show_github_open_issue_button %}
 <div id="edit-me" class="btn-group">
     {% if show_github_edit_button %}
-    {% assign repo_url = page.custom_repo_url | default: site.github.repository_url %}
-    {% if page.custom_editme %}
-    {% assign file_path = page.custom_editme %}
-    {% else %}
-    {% assign file_path = page.custom_file_path | default: page.path %}
-    {% endif %}
+    {% assign repo_url = page.github.repository_url | default: site.github.repository_url %}
+    {% assign repo_branch = page.github.branch | default: site.github.source.branch %}
+    {% assign file_path = page.github.file_path | default: page.path %}
     <a role="button" data-bs-toggle="tooltip"
         title="Propose changes to the content of this page on {{site.theme_variables.git_host | default: 'GitHub' }}"
-        href="{{repo_url}}/blob/{{site.github.source.branch}}/{{file_path}}"
-        class="btn btn-sm hover-primary text-primary"><i class="fa-solid fa-pencil-alt"></i></a>
+        href="{{repo_url}}/blob/{{repo_branch}}/{{file_path}}" class="btn btn-sm hover-primary text-primary"><i
+            class="fa-solid fa-pencil-alt"></i></a>
     {%- endif %}
     {%- if show_github_open_issue_button %}
     <a role="button" data-bs-toggle="tooltip" title="Report an issue"
@@ -23,8 +19,8 @@
     {%- endif %}
     {%- if show_github_history_button %}
     <a role="button" data-bs-toggle="tooltip" title="Check out the history of this page"
-        href="{{repo_url}}/commits/{{site.github.source.branch}}/{{file_path}}"
-        class="btn btn-sm hover-primary text-primary"><i class="fa-solid fa-history"></i></a>
+        href="{{repo_url}}/commits/{{repo_branch}}/{{file_path}}" class="btn btn-sm hover-primary text-primary"><i
+            class="fa-solid fa-history"></i></a>
     {%- endif %}
 </div>
 {%- endif %}

data/_includes/head.html

@@ -1,38 +1,42 @@
+{%- capture keywords %}
+{%- if page.related_pages %}
+{%- for section in page.related_pages %}
+{%- unless section[1].size == 0 %}
+{%- for keywordstr in section[1] %}
+{%- assign keywordpage = site.pages | where: "page_id", keywordstr | first  %}
+{%- if allkeywords %}
+{%- assign allkeywords = allkeywords | append: ", " | append: keywordstr | append: ", " | append: keywordpage.title %}
+{%- else %}
+{%- assign allkeywords = allkeywords | append: keywordstr | append: ", " | append: keywordpage.title %}
+{%- endif %}
+{%- endfor %}
+{%- endunless %}
+{%- endfor %}{{allkeywords}}
+{%- endif %}
+{%- endcapture %}
+{%- if page.type %}
+{%- assign subtitle = page.type | replace: "_", " " %}
+{%- endif %}
+{%- capture title %}{% if page.url == "/" %}{{site.title}}{% elsif page.title %}{% if subtitle %}{{subtitle}}: {% endif %}{{ page.title }} | {{ site.title }}{%- else %}{{ site.title }}{% endif %}{% endcapture %}
+{%- capture description %}{% if page.url == "/" %}{{site.description}}{% elsif page.description %}{{ page.description | strip_html | replace: '\n', ' ' | truncatewords: 30, '...' }}{% elsif page.summary %}{{ page.summary | strip_html | replace: '\n', ' ' | truncatewords: 30, '...' }}{% else %}{{ page.content | strip_html | replace: '\n', ' ' | truncatewords: 30, '...' }}{% endif %}{% endcapture %}
 <head>
     <meta charset="utf-8">
     <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <title>{{title}}</title>
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <meta name="description" content="{% if page.description %}{{ page.description | strip_html | strip_newlines | truncate: 160 }}{% else %}{{ site.description }}{% endif %}">
-    {%- capture keywords %}
-    {%- if page.related_pages %}
-    {%- for section in page.related_pages %}
-    {%- unless section[1].size == 0 %}
-    {%- for keywordstr in section[1] %}
-    {%- assign keywordpage = site.pages | where: "page_id", keywordstr | first  %}
-    {%- if allkeywords %}
-    {%- assign allkeywords = allkeywords | append: ", " | append: keywordstr | append: ", " | append: keywordpage.title %}
-    {%- else %}
-    {%- assign allkeywords = allkeywords | append: keywordstr | append: ", " | append: keywordpage.title %}
-    {%- endif %}
-    {%- endfor %}
-    {%- endunless %}
-    {%- endfor %}{{allkeywords}}
-    {%- endif %}
-    {%- endcapture %}
+    <meta name="description" content="{{description}}">
     <meta name="keywords" content="{{keywords}}">
-    <meta property="og:title" content="{{ site.title }}" />
-    <meta property="og:description" content="{{ site.description }}" />
+    <meta property="og:title" content="{{title}}" />
+    <meta property="og:description" content="{{description}}" />
+    <meta property="og:type" content="article">
+    <meta property="og:url" content="{{ page.url | absolute_url }}">
     <meta property="og:image" content="//{{site.github.url | remove: 'https://' | remove: 'http://'}}/assets/img/apple-touch-icon.png" />
-    <meta name="apple-mobile-web-app-title" content="{{site.title}}">
+    <meta name="apple-mobile-web-app-title" content="{{title}}">
     <meta name="msapplication-TileColor" content="#{{site.theme_variables.theme_color | default: 0d6efd }}">
     <meta name="theme-color" content="#{{site.theme_variables.theme_color | default: 0d6efd }}">
     {%- if page.no_robots %}
     <meta name="robots" content="noindex" />
     {%- endif %}
-    {%- if page.type %}
-    {%- assign subtitle = page.type | replace: "_", " " | capitalize %}
-    {%- endif %}
-    <title>{% if page.title %}{% if subtitle %}{{subtitle}}: {% endif %}{{ page.title }} | {{ site.title }}{%- else %}{{ site.title }}{% endif %}</title>
     <!-- Syntax highlighting  -->
     <link rel="stylesheet" href="{{ 'assets/css/syntax.css' | relative_url }}">
     <!-- Country flags  -->
@@ -69,11 +73,12 @@
     <script type="text/javascript" charset="utf8" src="{{ 'assets/js/dataTables.dateTime.min.js' | relative_url }}"></script>
     <script type="text/javascript" charset="utf8" src="{{ 'assets/js/searchBuilder.bootstrap5.min.js' | relative_url }}"></script>
     {%- endif %}
+    {%- assign pagelength = site.theme_variables.datatables.pagelength | default: 10 %}
     <script type="text/javascript">
         $(document).ready(function () {
             $('table.display').each(function() {
                 $(this).DataTable({
-                    lengthMenu: [[10, 25, 50, 100, -1], [10, 25, 50, 100, "All"]],
+                    lengthMenu: [[{{ pagelength }}, {{ pagelength | times: 2 }}, {{ pagelength | times: 5 }}, {{ pagelength | times: 10 }}, -1], [{{ pagelength }}, {{ pagelength | times: 2 }}, {{ pagelength | times: 5 }}, {{ pagelength | times: 10 }}, "All"]],
                     stateSave: true,
                     searching: true,
                     {%- if site.theme_variables.datatables.searchbuilder %}
@@ -82,13 +87,13 @@
                     },
                     {%- endif %}
                     info: true,
-                    pageLength: 10,
+                    pageLength: {{ pagelength }},
                     language: {
                         searchPlaceholder: "Type here..."
                     },
                     "drawCallback": function ( settings ){
                         var tableId = settings.nTable.id;
-                        if(settings.fnRecordsTotal() < 10){     
+                        if(settings.fnRecordsTotal() < {{ pagelength }}){     
                             $('#'+tableId+'_wrapper .dt-length').hide();
                             $('#'+tableId+'_wrapper .dt-paging').hide();
                             $('#'+tableId+'_wrapper .dt-search').hide();
@@ -101,6 +106,7 @@
         });
     </script>
     {%- endif %}
+    <script src="{{ 'assets/js/custom.js' | relative_url }}?{{site.time | date: '%s'}}"></script>
     <!-- favicon -->
     <link rel="apple-touch-icon" sizes="180x180" href="{{ 'assets/img/apple-touch-icon.png' | relative_url }}">
     <link rel="icon" type="image/png" sizes="32x32" href="{{ 'assets/img/favicon-32x32.png' | relative_url }}">

data/_includes/news.html

@@ -8,7 +8,7 @@
     {%- for new in news reversed%}
     <li>
       <span class="title mb-1">{{ new.name | escape }}</span>
-      <p class="text-muted"><i class="far fa-calendar me-2"></i><time>{{ new.date | date_to_long_string }}</time>{% if new.linked_pr %} - <i class="fa-solid fa-code-branch me-2"></i><a href="{{ site.github.repository_url | append: '/pull/' | append: new.linked_pr }}">{{new.linked_pr }}</a>{% endif %}</p>
+      <p class="text-muted"><i class="far fa-calendar me-2"></i><time>{{ new.date | date_to_long_string }}</time>{% if new.linked_pr %} - <i class="fa-solid fa-code-branch me-2"></i><a href="{{ site.github.repository_url | append: '/pull/' | append: new.linked_pr }}"><span>{{new.linked_pr }}</span></a>{% endif %}</p>
       {%- if new.description %}
       {%- assign word_count = new.description | split: " " | size %}
       {%- if include.truncate == true and word_count > 40 %}

data/_includes/pageids-overview.html

@@ -1,6 +1,6 @@
 {%- assign sidebar = site.data.sidebars[include.sidebar]['subitems'] -%}
 {%- for sections in sidebar %}
-{%- assign section = sections.title | downcase | replace: " ", "_" %}
+{%- assign section = sections.title | replace: " ", "_" %}
 {%- assign section_pages = site.pages | where:"type", section | where_exp: "item", "item.search_exclude != true" | where_exp: "item", "item.page_id != nil"   %}
 {%- unless section_pages.size == 0 %}
 <h2>{{sections.title}}</h2>

data/_includes/related-pages.html

@@ -23,7 +23,7 @@
                     <img src="{{page_hit.type_img | relative_url}}" class="type-icon me-2" alt="{{page_hit.type}} icon">
                     {%- endif %}
                     {%- if page_hit.type %}
-                    <span class=""><small>{{page_hit.type | replace: "_", " " | capitalize }}</small></span>
+                    <span class=""><small>{{page_hit.type | replace: "_", " " }}</small></span>
                     {%- endif %}
                 </div>
                 <a class="stretched-link section-title" aria-label="Go to the {{page_hit.title}} page" href="{{ page_hit.url | relative_url }}">

data/_includes/resource-table-all.html

@@ -92,7 +92,7 @@
                 {%- for tag in tool.related_pages %}
                 {%- unless tag == page.page_id %}
                 {%- assign related_page = site.pages | where:"page_id",tag | first %}
-                <a href="{{related_page.url | relative_url }}" data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' | capitalize }}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
+                <a href="{{related_page.url | relative_url }}" data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' }}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
                 {%- endunless %}
                 {%- endfor %}
                 {%- endcapture %}

data/_includes/resource-table-page.html

@@ -47,7 +47,7 @@
                 {%- for tag in section[1] %}
                 {%- unless tag == page.page_id %}
                 {%- assign related_page = site.pages | where:"page_id",tag | first %}
-                <a class="nohover" href="{{related_page.url | relative_url }}"  data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' | capitalize}}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
+                <a class="nohover" href="{{related_page.url | relative_url }}"  data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' }}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
                 {%- endunless %}
                 {%- endfor %}
                 {%- endunless %}
@@ -126,7 +126,7 @@
                 {%- for tag in tool.related_pages %}
                 {%- unless tag == page.page_id %}
                 {%- assign related_page = site.pages | where:"page_id",tag | first %}
-                <a href="{{related_page.url | relative_url }}"  data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' | capitalize}}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
+                <a href="{{related_page.url | relative_url }}"  data-bs-toggle="tooltip" title="{{related_page.type | replace: '_', ' ' }}"><span class="badge default-badge">{{ related_page.title | truncate: 25 }}</span></a>
                 {%- endunless %}
                 {%- endfor %}
                 {%- endcapture %}

data/_includes/section-navigation-tiles.html

@@ -37,7 +37,7 @@
     <div class="col">
         <div class="input-group">
             <span class="input-group-text" id="search-label-tiles"><i class="fa-solid fa-magnifying-glass"></i></span>
-            <input type="text" id="title-search" class="form-control" onkeyup="StartSearch();" placeholder="Find your page..." aria-label="{{page.type | replace: '_', ' ' |}}" aria-describedby="search-label-tiles">
+            <input type="text" id="title-search" class="form-control" onkeyup="StartSearch();" placeholder="Find your page..." aria-label="{{page.type | replace: '_', ' ' }}" aria-describedby="search-label-tiles">
             <button class="btn btn-primary" title="Button to clear search" type="button" id="clearsearch">
                 <i class="fa-solid fa-backspace"></i>
             </button>
@@ -90,7 +90,7 @@
                     <img src="{{current_page.type_img | relative_url}}" class="type-icon me-2" alt="{{current_page.type}} icon">
                     {%- endif %}
                     {%- if current_page.type %}
-                    <span class=""><small>{{current_page.type | replace: "_", " " | capitalize }}</small></span>
+                    <span class=""><small>{{current_page.type | replace: "_", " " }}</small></span>
                     {%- endif %}
                 </div>
                 <a class="stretched-link section-title" aria-label="Go to the {{current_page.title}} page" href="{{ current_page.url | relative_url }}">

data/_layouts/page.html

@@ -8,7 +8,7 @@ layout: default
         {%- endif %}
         {%- if page.title %}
         {%- if page.type and site.theme_variables.breadcrumb != true %}
-        {%- assign subtitle = page.type | replace: "_", " " | capitalize %}
+        {%- assign subtitle = page.type | replace: "_", " " %}
         <h1 class="has-subtitle order-1 order-md-0"><span class="d-block text-secondary fs-4 ff-body">{{subtitle}}</span><span class="visually-hidden">:</span> {{ page.title }}
         {%- else %}
         <h1>{{ page.title }}

data/assets/css/main.scss

@@ -98,33 +98,34 @@ body img {
     font-family: $font-family-theme !important;
 }
 
+// Add external link icon to all urls
+#content a:is([href^="http"], [href^="//"]):not([href^="{{ site.url }}"]):not([href^="mailto:"]):not([href^="tel:"]):not(:has(> span:only-child)):not(:has(> img)):not(.btn):not(.no-ext-icon)::after {
+    content: "\f35d";
+    font-family: "Font Awesome 6 Free";
+    font-weight: 900;
+    display: inline-block;
+    margin-left: .4em;
+    font-size: .60em;
+    line-height: 1;
+    text-rendering: auto;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+    pointer-events: none;
+    vertical-align: middle;
+}
+
 /*-----Layout-----*/
 
 #main {
     grid-area: main;
 }
 
-@include media-breakpoint-up(md) {
-    #main {
-        display: grid;
-        grid-template-areas:
-            "intro"
-            "toc"
-            "content";
-        grid-template-rows: auto auto 1fr;
-    }
+#intro {
+    grid-area: intro;
 }
-@include media-breakpoint-up(xl) {
-    #main {
-        grid-template-areas:
-            "intro toc"
-            "content toc";
-        grid-template-rows: auto 1fr;
-    }
 
-    .add-grid {
-        grid-template-columns: 5fr 2fr;
-    }
+#sidebar {
+    grid-area: sidebar;
 }
 
 #toc {
@@ -141,8 +142,36 @@ body img {
     }
 }
 
+@include media-breakpoint-up(md) {
+    #main {
+        display: grid;
+        grid-template-areas:
+            "intro"
+            "toc"
+            "content";
+        grid-template-rows: auto auto 1fr;
+    }
+}
+
+
+@include media-breakpoint-up(lg) {
+    #layout {
+        display: grid;
+        grid-template-areas: "sidebar main";
+        grid-template-columns: 3fr 9fr;
+    }
+}
+
 @include media-breakpoint-up(xl) {
-    #toc {
+    #main.add-grid {
+        grid-template-areas:
+            "intro toc"
+            "content toc";
+        grid-template-rows: auto 1fr;
+        grid-template-columns: 5fr 2fr;
+    }
+
+    #main.add-grid #toc {
         top: $spacer * 3;
         right: 0;
         z-index: 2;
@@ -150,15 +179,12 @@ body img {
         overflow-y: auto;
         margin-left: $spacer * 3;
     }
-}
 
-#intro {
-    grid-area: intro;
+    #layout {
+        grid-template-columns: 2fr 9fr;
+    }
 }
 
-#sidebar {
-    grid-area: sidebar;
-}
 
 #content {
     grid-area: content;
@@ -169,19 +195,6 @@ body img {
     }
 }
 
-@include media-breakpoint-up(lg) {
-    #layout {
-        display: grid;
-        grid-template-areas: "sidebar main";
-        grid-template-columns: 3fr 9fr;
-    }
-}
-
-@include media-breakpoint-up(xl) {
-    #layout {
-        grid-template-columns: 2fr 9fr;
-    }
-}
 
 /*-----Blockquote-----*/
 

data/assets/js/toc.js

@@ -5,85 +5,114 @@
       title: '<i>Jump to...</i>',
       minimumHeaders: 3,
       headers: 'h1, h2, h3, h4, h5, h6',
-      listType: 'ol', // values: [ol|ul]
-      showEffect: 'show', // values: [show|slideDown|fadeIn|none]
-      showSpeed: 'slow', // set to 0 to deactivate effect
+      listType: 'ol',       // values: [ol|ul]
+      showEffect: 'show',   // values: [show|slideDown|fadeIn|none]
+      showSpeed: 'slow',    // set to 0 to deactivate effect
       classes: {
         list: '',
         item: '',
         link: '',
         toc: ''
       }
-    },
-    settings = $.extend(defaults, options);
+    };
+
+    // Do not mutate defaults; merge into a fresh object
+    var settings = $.extend({}, defaults, options);
 
+    // Encode fragment identifiers safely (e.g., handle !'()*)
     function fixedEncodeURIComponent(str) {
       return encodeURIComponent(str).replace(/[!'()*]/g, function (c) {
         return '%' + c.charCodeAt(0).toString(16);
       });
     }
 
+    // Build an <a> for a given header; ensure it has an id
     function createLink(header) {
-      var innerText = header.textContent || header.innerText;
-      return "<a class='" + settings.classes.link + "' href='#" + fixedEncodeURIComponent(header.id) + "'>" + innerText + "</a>";
+      var innerText = header.textContent || header.innerText || '';
+      if (!header.id) {
+        header.id = innerText.trim()
+          ? innerText.trim().replace(/\s+/g, '-').toLowerCase()
+          : ('heading-' + Math.random().toString(36).slice(2, 8)); // fallback id
+      }
+      return "<a class='" + settings.classes.link + "' href='#" +
+             fixedEncodeURIComponent(header.id) + "'>" + innerText + "</a>";
     }
 
+    // Collect headers and ensure they have IDs (filter out those that still don't)
     var headers = $(settings.headers).filter(function () {
-      // Ensure headers have IDs
       if (!this.id) {
-        this.id = $(this).text().trim().replace(/\s+/g, '-').toLowerCase();
+        var text = $(this).text().trim();
+        this.id = text ? text.replace(/\s+/g, '-').toLowerCase() : '';
       }
       return this.id;
     });
 
-    var output = $(this);
+    var output = $(this);          // the TOC container (e.g., #toc-contents)
+    var $main  = $('#main');   
 
-    // Check if there are any headers
-    if (!$('#page-img .page-img-lg').length ) {
-      if ( !headers.length || headers.length < settings.minimumHeaders || !output.length ) {
-        $('#main').removeClass("add-grid");
-        $("#toc").hide();
-        return;  // Exit early if there are no headers
-      }
+    // Prevents calling get_level(headers[0]) on undefined and collapses layout/space.
+    if (!headers.length || headers.length < settings.minimumHeaders || !output.length) {
+      $main.removeClass('add-grid'); // collapse layout (your existing side-effect + our flag)
+      output.empty().hide();                 // hide/clear inner TOC container
+      return;
     }
 
-    if (settings.showSpeed === 0) {
-      settings.showEffect = 'none';
-    }
+    // If speed is 0, disable visual effect
+    if (settings.showSpeed === 0) settings.showEffect = 'none';
 
-    $(this).addClass(settings.classes.toc);
+    // Optional extra class on the container
+    output.addClass(settings.classes.toc);
 
     var render = {
-      show: function () { output.hide().html(html).show(settings.showSpeed); },
+      show:      function () { output.hide().html(html).show(settings.showSpeed); },
       slideDown: function () { output.hide().html(html).slideDown(settings.showSpeed); },
-      fadeIn: function () { output.hide().html(html).fadeIn(settings.showSpeed); },
-      none: function () { output.html(html); }
+      fadeIn:    function () { output.hide().html(html).fadeIn(settings.showSpeed); },
+      none:      function () { output.html(html); }
+    };
+
+    // Resilient parser of header levels (H1..H6 → 1..6). Returns NaN if invalid.
+    var get_level = function (ele) {
+      return (ele && ele.nodeName) ? parseInt(ele.nodeName.replace(/H/i, ''), 10) : NaN;
     };
 
-    var get_level = function (ele) { return parseInt(ele.nodeName.replace("H", ""), 10); };
-    var highest_level = headers.map(function (_, ele) { return get_level(ele); }).get().sort()[0];
-    var level = get_level(headers[0]), this_level;
+    // Validate first level before proceeding
+    var level = get_level(headers[0]);
+    if (!isFinite(level)) {
+      output.hide().empty();
+      return;
+    }
+
+    var this_level;
     var html = settings.title + " <" + settings.listType + " class=\"" + settings.classes.list + "\">";
 
+    // Build nested list based on header levels
     headers.each(function (_, header) {
       this_level = get_level(header);
-      if (this_level === level) { // same level as before; same indenting
+      if (!isFinite(this_level)) return; // skip anything unexpected
+
+      if (this_level === level) { // same level; same indent
         html += "<li class=\"" + settings.classes.item + "\">" + createLink(header);
-      } else if (this_level <= level) { // higher level than before; end parent ol
+      } else if (this_level <= level) { // moving up; close lists
         for (var i = this_level; i < level; i++) {
-          html += "</li></" + settings.listType + ">"
+          html += "</li></" + settings.listType + ">";
         }
         html += "<li class=\"" + settings.classes.item + "\">" + createLink(header);
-      } else if (this_level > level) { // lower level than before; expand the previous to contain a ol
-        for (i = this_level; i > level; i--) {
+      } else { // moving down; open nested lists
+        for (var j = this_level; j > level; j--) {
           html += "<" + settings.listType + " class=\"" + settings.classes.list + "\">" +
-            "<li class=\"" + settings.classes.item + "\">"
+                  "<li class=\"" + settings.classes.item + "\">";
         }
         html += createLink(header);
       }
-      level = this_level; // update for the next one
+      level = this_level; // update for next header
     });
+
     html += "</" + settings.listType + ">";
-    render[settings.showEffect]();
+
+    // Render with the selected effect
+    (render[settings.showEffect] || render.none)();
+
+    // Add grid + flag on #main (if your layout uses it), and flag #toc so CSS applies margin.
+    $main.addClass('add-grid');
   };
 })(jQuery);

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: elixir-toolkit-theme
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 5.0.0
 platform: ruby
 authors:
 - bedroesb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-18 00:00:00.000000000 Z
+date: 2025-08-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -503,6 +503,7 @@ files:
 - assets/js/bootstrap.bundle.min.js
 - assets/js/bootstrap.bundle.min.js.map
 - assets/js/clipboard.min.js
+- assets/js/custom.js
 - assets/js/dataTables.bootstrap5.min.js
 - assets/js/dataTables.dateTime.min.js
 - assets/js/dataTables.searchBuilder.min.js