eclipsefdn-hugo-solstice-theme 2.1.0 → 3.0.1

package/exampleSite/config/_default/config.toml

@@ -15,8 +15,8 @@ baseURL = "https://webdev.eclipse.org/docs/hugo"
   keywords = ["hugo", "solstice", "eclipse foundation"]
 #  logo = "images/logo/eclipse-foundation-white.svg"
 #  favicon = "images/favicon.ico"
-  styles = "css/astro.css"
-  js = "js/astro.js"
+  styles = "css/neptune.css"
+  js = "js/neptune.js"
   gcse = "011805775785170369411:p3ec0igo0qq"
   gcse_result_url = "/search"
   # eclipse_search_icon = "<i data-feather=\"search\" stroke-width=\"1\"></i>"

package/exampleSite/config/_default/menus.en.toml

@@ -95,7 +95,7 @@
 [[main]]
     name = "Components"
     url = "/components/"
-    weight = 3
+    weight = 1
     identifier = "components"
 
 [[main]]
@@ -130,17 +130,31 @@
     identifier = "deprecated"
     pre = "<i class=\"fa-solid fa-ban\" aria-hidden></i>"
 
+[[main]]
+    name = "EclipseFdn Members List"
+    url = "/components/eclipsefdn_members_list/"
+    parent = "deprecated"
+
+[[main]]
+    name = "EclipseFdn Projects page"
+    url = "/components/eclipsefdn_projects_page/"
+    parent = "deprecated"
+
 [[main]]
     name = "Meeting Minutes"
     url = "/components/meeting_minutes/"
     weight = 3
     parent = "deprecated"
 
+[[main]]
+    name = "Newsroom News"
+    url = "/components/newsroom/news/"
+    parent = "deprecated"
+
 [[main]]
     name = "Membership"
     url = "/components/members/"
-    weight = 3
-    parent = "solstice"
+    parent = "deprecated"
 
 [[main]]
     name = "Taxonomy list"
@@ -178,24 +192,6 @@
     weight = 3
     parent = "solstice"
 
-[[main]]
-    name = "Featured Story"
-    url = "/components/featured_story/"
-    weight = 3
-    parent = "solstice"
-
-[[main]]
-    name = "EclipseFdn Projects page"
-    url = "/components/eclipsefdn_projects_page/"
-    weight = 3
-    parent = "solstice"
-
-[[main]]
-    name = "EclipseFdn Members List"
-    url = "/components/eclipsefdn_members_list/"
-    weight = 4
-    parent = "solstice"
-
 [[main]]
     name = "HTML Tables"
     url = "/components/tables/"
@@ -208,18 +204,6 @@
     weight = 3
     parent = "solstice"
 
-[[main]]
-    name = "Twitter Timeline"
-    url = "/components/twitter_timeline/"
-    weight = 3
-    parent = "solstice"
-
-[[main]]
-    name = "Twitter Buttons"
-    url = "/components/twitter_button/"
-    weight = 3
-    parent = "solstice"
-
 [[main]]
     name = "RSS Feed"
     url = "/components/rss/"
@@ -262,18 +246,6 @@
     weight = 3
     parent = "events"
 
-[[main]]
-    name = "Newsroom News"
-    url = "/components/newsroom/news/"
-    weight = 3
-    parent = "dynamic"
-
-[[main]]
-    name = "Newsroom Events"
-    url = "/components/newsroom/events/"
-    weight = 3
-    parent = "dynamic"
-
 [[main]]
     name = "Newsroom Resources"
     url = "/components/newsroom/resources/"
@@ -283,15 +255,34 @@
 [[main]]
     name = "News"
     url = "/components/news/"
-    weight = 2
     parent = "deprecated"
 
 [[main]]
     name = "Events"
     url = "/components/events/"
-    weight = 3
     parent = "deprecated"
 
+[[main]]
+    name = "Newsroom Events"
+    url = "/components/newsroom/events/"
+    parent = "deprecated"
+
+[[main]]
+    name = "X Timeline"
+    url = "/components/twitter_timeline/"
+    parent = "deprecated"
+
+[[main]]
+    name = "X Buttons"
+    url = "/components/twitter_button/"
+    parent = "deprecated"
+
+[[main]]
+    name = "Changelog"
+    url = "/changelog/"
+    weight = 3
+    identifier = "changelog"
+
 [[sidebar]]
     name = "Hugo Solstice Theme"
     url = "/"

package/exampleSite/content/changelog/index.md

@@ -0,0 +1,9 @@
+---
+title: "Changelog"
+date: 2026-04-01T00:00:00Z
+hide_page_title: true
+hide_sidebar: true
+type: "changelog"
+---
+
+

package/exampleSite/data/doc_params.yml

@@ -93,18 +93,7 @@ items:
     values:
       - "true"
     ref: /components/featured_footer/
-  - 
-    name: show_featured_story
-    description: Shows the featured story section at the top of the page if set to true, otherwise is ignored.
-    values:
-      - "true"
-    ref: /components/featured_story/
-  - 
-    name: subtitle
-    description: Used in the jumbotron, set in a second level header under the headline. Ignored if headline is not set.
-    values:
-      - Any string value
-  - 
+  -
     name: Summary
     description: Built in Hugo document parameter. Used in the head meta description if the Description parameter is not set.
     values:
@@ -146,23 +135,13 @@ items:
     values:
       - Any string value
 
-  -
-    name: format_title
-    description: Formats the page title in headings and breadcrumbs to title case. If there is no value set, will default to true.
-    values:
-      - "false"
-
   -
     name: sidebar
     description: Target specific menu identifiers. Used when a page or sub-section uses different sidebar content than the rest of the section it's in. Each identifier must have a corresponding "menu.sidebar" entry in the site's "config" file. If this parameter is omitted, the default sidebar for the section is used.
     values:
       - An array of string values
-  - 
+  -
     name: body_class
     description: Add classes to the body element.
     values:
       - Any string value
-    name: format_title
-    description: Formats the page title in headings and breadcrumbs to title case. If there is no value set, will default to true.
-    values:
-      - "false"

package/exampleSite/data/site_params.yml

@@ -23,13 +23,7 @@ items:
     description: Description of the overall site, used in a pages meta description if no page level description is set.
     values:
       - Any string value
-  - 
-    name: facebook_url
-    description: URL to the Facebook page for the site. If there is no value set, will default to Eclispe Foundation page.
-    deprecated: "0.1.7"
-    values:
-      - Absolute link to Facebook profile
-  - 
+  -
     name: favicon
     description: URL to the favicon image for the site.
     values:
@@ -54,17 +48,7 @@ items:
     description:  Used in the jumbotron.html layout file. Allow you to change the default value of col-md-20 col-md-offset-2 col-sm-18 col-sm-offset-3. Can be set at the site or page level.
     values:
       - Any string value
-  - 
-    name: jumbotron_tagline_class
-    description:  Used in the jumbotron.html layout file. Allow you to change the default value of col-sm-18 col-sm-offset-3. Can be set at the site or page level.
-    values:
-      - Any string value
-  - 
-    name: jumbotron_btn_class
-    description:  Used in the jumbotron.html layout file. Allow you to change the default value of btn btn-primary. Can be set at the site or page level.
-    values:
-      - Any string value
-  - 
+  -
     name: main_content_class
     description:  Used in the main_prefix.html layout file. Allow you to change the default value of col-md-18 padding-bottom-30 is overriten. Can be set at the site or page level.
     values:
@@ -84,12 +68,7 @@ items:
     description: Hides the CFA button site-wide.
     value:
       - "true"
-  - 
-    name: hide_cfa_same_page
-    description: Attempt to hide CFA on the page it links to 
-    values:
-      - "true"
-  - 
+  -
     name: js
     description: URL to the main javascript to be used on the site. This does not affect any scripts added in custom sctions of the site. Defaults to <a href="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/main.min.js">main.min.js</a>
     values:
@@ -100,19 +79,7 @@ items:
     values:
       - Array of strings
     example: '["tag1", "tag2", "tag3"]'
-  - 
-    name: linkedin_url
-    description: URL to the linkedin page for the site. If there is no value set, will default to Eclispe Foundation page.
-    deprecated: "0.1.7"
-    values:
-      - Absolute link to linkedin profile
-  - 
-    name: bluesky_url
-    description: URL to the Bluesky page for the site. If there is no value set, will default to Eclispe Foundation page.
-    deprecated: "0.1.7"
-    values:
-      - Absolute link to Bluesky profile
-  - 
+  -
     name: logo
     description: URL to the logo image for the site. If there is no other image set in page or site parameters, this image is used as the sharing image for social media links.
     values:
@@ -137,19 +104,7 @@ items:
     description: URL to the stylesheet to be used on the site. This does not affect any stylesheets added in custom sctions of the site. Defaults to <a href="https://eclipse.org/eclipse.org-common/themes/solstice/public/stylesheets/quicksilver.min.css">quicksilver.min.css</a>
     values:
       - Absolute link or fully qualified URL to a CSS file
-  - 
-    name: twitter_url
-    description: URL to the Twitter page for the site. If there is no value set, will default to Eclispe Foundation page.
-    deprecated: "0.1.7"
-    values:
-      - Absolute link to Twitter profile
-  - 
-    name: youtube_url
-    description: URL to the YouTube page for the site. If there is no value set, will default to Eclispe Foundation page.
-    deprecated: "0.1.7"
-    values:
-      - Absolute link to YouTube profile
-  - 
+  -
     name: hide_breadcrumb
     description: Hides the breadcrumb on all pages if set to true, otherwise ignored.
     values:

package/exampleSite/layouts/changelog/single.html

@@ -0,0 +1,43 @@
+{{ define "main" }}
+  {{ $changelog_url := "https://gitlab.eclipse.org/eclipsefdn/software-dev/frameworks-and-tools/hugo-solstice-theme/-/raw/main/CHANGELOG.md?ref_type=heads" }}
+  {{ with try (resources.GetRemote $changelog_url) }}
+    {{ with .Err }}
+      {{ errorf "%s" . }}
+    {{ else with .Value }}
+        {{ $changelog := .Content }}
+        {{ $changelog | markdownify }}
+        <script>
+          document.querySelector('h1').innerText = 'Changelog';
+          document.querySelectorAll('main li').forEach(li => {
+            const commitHashPattern = /([a-f0-9]{7}):/i;
+            li.childNodes.forEach(node => {
+              if (node.nodeType === Node.TEXT_NODE) {
+                // Check if the text node contains a commit hash pattern
+                const match = node.textContent.match(commitHashPattern);
+                if (match) {
+                  const hash = match[1];
+                  const url = `https://gitlab.eclipse.org/eclipsefdn/software-dev/frameworks-and-tools/hugo-solstice-theme/-/commit/${hash}`;
+
+                  // Create a link element
+                  const a = document.createElement('a');
+                  a.href = url;
+                  a.target = '_blank';
+                  a.rel = 'noopener noreferrer';
+                  a.textContent = match[0];
+
+                  // Replace the text node with the link
+                  const parts = node.textContent.split(match[0]);
+                  const frag = document.createDocumentFragment();
+                  frag.append(parts[0], a, parts[1]);
+
+                  node.replaceWith(frag);
+                }
+              }
+            });
+          });
+        </script>
+    {{ else }}
+      {{ errorf "Unable to get remote resource %q" $changelog_url }}
+    {{ end }}
+  {{ end }}
+{{ end }}

package/layouts/_default/baseof.html

@@ -19,7 +19,6 @@
 </head>
 <body {{ with .Page.Params.body_class -}}class="{{ . }}"{{- end }}>
   {{ block "header" . }}{{ partial "header.html" . }}{{ end }}
-  {{ block "featured_story" . }}{{ partial "featured_story.html" . }}{{ end }}
   {{ block "main_prefix" . }}{{ partial "main_prefix.html" . }}{{ end }}
   {{ block "main" . }}{{ .Content }}{{ end }}
   {{ block "main_suffix" . }}{{ partial "main_suffix.html" . }}{{ end }}

package/layouts/partials/breadcrumbs.html

@@ -1,43 +1,35 @@
-{{/*
-  Copyright (c) 2018, 2023 Eclipse Foundation, Inc.
+<!-- 
+  Copyright (c) 2025 Eclipse Foundation AISBL
+
   This program and the accompanying materials are made available under the
   terms of the Eclipse Public License v. 2.0 which is available at
   http://www.eclipse.org/legal/epl-2.0.
 
-  Contributors:
-    Christopher Guindon <chris.guindon@eclipse-foundation.org>
-    Olivier Goulet <olivier.goulet@eclipse-foundation.org>
-
   SPDX-License-Identifier: EPL-2.0
-*/}}
-
-{{ $breadcrumb_container := "" }}
+-->
 
-{{ if strings.Contains .Params.container "container-fluid" }}
-  {{ $breadcrumb_container = "container" }}
+{{ if not .Page.Params.hide_breadcrumb }}
+    <nav aria-label="Breadcrumb">
+      <div class="container">
+        <ol class="breadcrumb">
+          {{ template "breadcrumb-links" (dict "p1" . "p2" .) }}
+        </ol>
+      </div>
+    </nav>
 {{ end }}
 
-<div class="default-breadcrumbs hidden-print" id="breadcrumb">
-  <div class="{{ $breadcrumb_container }}">
-    <div class="row">
-      <div class="col-sm-24">
-        <ol aria-label="Breadcrumb" class="breadcrumb">
-          {{ template "breadcrumbnav" (dict "p1" . "p2" . "site_params" $.Site.Params) }}
-          </ol>
-          {{ define "breadcrumbnav" }}
-            {{ if .p1.Parent }}
-              {{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 "site_params" .site_params)  }}
-            {{ else if not .p1.IsHome }}
-              {{ template "breadcrumbnav" (dict "p1" .p1.Site.Home "p2" .p2 "site_params" .site_params)  }}
-            {{ end }}
-            <li {{ if eq .p1 .p2 }} class="active" aria-current="page"{{ end }}>
-              {{ $breadcrumb_title := .p1.Params.breadcrumb_title | default .p1.Title }}
-              <a href="{{ .p1.Permalink }}">{{ if eq (.p1.Params.format_title | default .site_params.format_title) false }}{{ $breadcrumb_title | safeHTML }}{{ else }}{{ $breadcrumb_title | safeHTML | title }}{{ end }}</a>
-            </li>
-          {{ end }}
-        </div>
-    </div>
-  </div>
-</div>
-
+{{ define "breadcrumb-links" }}
+  {{ $max_length := 32 }}
 
+  {{ if .p1.Parent }}
+    {{ template "breadcrumb-links" (dict "p1" .p1.Parent "p2" .p2 )  }}
+  {{ else if not .p1.IsHome }}
+    {{ template "breadcrumb-links" (dict "p1" .p1.Site.Home "p2" .p2 )  }}
+  {{ end }}
+  {{ $is_current_page := eq .p1.Permalink .p2.Permalink }}
+  {{ if $is_current_page }}
+    <li class="active">{{ (.p1.Params.breadcrumb_title | default .p1.Title) | safeHTML | truncate $max_length }}</li>
+  {{ else }}
+    <li><a href="{{ .p1.Permalink }}">{{ (.p1.Params.breadcrumb_title | default .p1.Title) | safeHTML | truncate $max_length }}</a></li>
+  {{ end }}
+{{ end }}

package/layouts/partials/featured_story_popup.html

@@ -6,4 +6,10 @@
     publishtarget="{{ $publish_target }}"
     type="popup"
   ></efsc-featured-story-popup>
+  <style>
+    :root {
+      /* Due to neptune's footer arch we need to add an offset so that the popup doesn't feels just cropped */
+      --efsc-popup-bottom-offset: 18rem;
+    }
+  </style>
 {{ end }}

package/layouts/partials/footer.html

@@ -1,32 +1,73 @@
-{{/* 
-  Copyright (c) 2023 Eclipse Foundation, Inc.
+<!-- 
+  Copyright (c) 2025 Eclipse Foundation AISBL
+
   This program and the accompanying materials are made available under the
   terms of the Eclipse Public License v. 2.0 which is available at
   http://www.eclipse.org/legal/epl-2.0.
 
-  Contributors:
-    Olivier Goulet <olivier.goulet@eclipse-foundation.org>
-
   SPDX-License-Identifier: EPL-2.0
-*/}}
+-->
 
-<p id="back-to-top">
-  <a class="visible-xs" href="#">{{ i18n "navigation-back-to-top" }}</a>
-</p>
-<footer class="footer" id="footer">
+{{ $footer_class := .Page.Params.footer_class }}
+<footer class="footer {{- with $footer_class }} {{ . }}{{ end }}">
   <div class="container">
-    {{ partial "footer_prefix.html" . }}
-    <div class="footer-sections row equal-height-md font-bold">
-        {{ partial "footer_links/prefix.html" . }}
-        <div class="col-md-15">
-          <div class="row">
-            {{ partial "footer_links/links.html" . }}
+    <div class="footer-inner">
+      <section class="links-section">
+        {{ range $.Site.Menus.footer }}
+          <ul>
+            <li>{{ .Name }}</li>
+            <li>
+              <ul>
+                {{ range .Children }}
+                  <li>
+                    {{ if .URL }}
+                      <a href="{{ .URL }}" {{ with .Params.class -}} class="{{ . }}" {{- end }}>{{ .Name }}</a>
+                    {{ else }}
+                      <button type="button" class="btn btn-link {{ with .Params.class -}} {{ . }} {{- end }}">{{ .Name }}</button>
+                    {{ end }}
+                  </li>
+                {{ end }}
+              </ul>
+            </li>
+          </ul>
+        {{ end }}
+      </section>
+      <section class="social-media-section">
+        <p class="subheading text-tertiary">See what we're up to</p>
+        {{ partial "socials.html" . }}
+      </section>
+      <section class="newsletter-section">
+        <p class="subheading text-tertiary">Stay up to date</p>
+        <h2>Subscribe to our newsletter</h2>
+        <form 
+          class="newsletter-form margin-top-40"
+          id="mc-embedded-subscribe-form" 
+          action="https://eclipse.us6.list-manage.com/subscribe/post?u=eaf9e1f06f194eadc66788a85&amp;id=e7538485cd&amp;f_id=00f9c2e1f0" 
+          method="post" 
+          novalidate 
+          target="_blank"
+        >
+          <div class="text-field-outlined">
+            <input name="EMAIL" type="email" placeholder="Your email">
+            <button class="newsletter-form-submit" type="submit" name="subscribe" id="mc-embedded-subscribe" aria-label="Submit">
+              <i class="fa-solid fa-arrow-right" aria-hidden="true"></i>
+            </button>
           </div>
+        </form>
+      </section>
+      <section class="footer-bottom-section">
+        <img class="img-responsive logo" src="https://www.eclipse.org/eclipse.org-common/themes/solstice/public/images/logo/eclipse-foundation-white.svg" alt="Eclipse Foundation">
+        <div class="legal-information">
+          <p>Copyright &copy; Eclipse Foundation AISBL. All rights reserved.</p>
+          <ul class="legal-links">
+            <li><a href="https://www.eclipse.org/legal/privacy/">Privacy policy</a></li>
+            <li><a href="https://www.eclipse.org/legal/terms-of-use/">Terms of use</a></li>
+            <li><a href="https://www.eclipse.org/legal/compliance/">Compliance</a></li>
+            <li><a href="https://www.eclipse.org/legal/">Legal</a></li>
+          </ul>
         </div>
-        {{ partial "footer_links/suffix.html" . }}
+      </section>
     </div>
-    {{ partial "footer_links/footer-copyright.html" . }}
-    <a href="#" class="scrollup">{{ i18n "navigation-back-to-top" }}</a>
   </div>
 </footer>
 

package/layouts/partials/footer_js.html

@@ -1,6 +1,6 @@
 <div id="footer-js">
   <!-- Placed at the end of the document so the pages load faster -->
-  {{- $default_js := "https://www.eclipse.org/eclipse.org-common/themes/solstice/public/javascript/astro.min.js" -}}
+  {{- $default_js := "https://www.eclipse.org/public/js/neptune/main.js" -}}
   {{- with .Site.Params.js | default $default_js }}
   <script src="{{ . | relURL }}?v={{ now.Unix }}"></script>
   {{ end }}

package/layouts/partials/head.html

@@ -75,16 +75,16 @@
 <link rel="alternate" href="{{ .RelPermalink }}" type="application/rss+xml" title="">
 {{ end }}
 {{ if ne .Page.Params.disable_css "true" }}
-  {{- $default_css := "https://www.eclipse.org/public/css/astro.css" -}}
-  {{- with .Site.Params.styles | default $default_css }}
-  <link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
-  {{- end }}
-  {{- with .Site.Params.style_overrides }}
-  <link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
-  {{- end }}
-  {{- with .Page.Params.page_css_file }}
-  <link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
-  {{- end }}
+{{- $default_css := "https://www.eclipse.org/public/css/neptune.css" -}}
+{{- with .Site.Params.styles | default $default_css }}
+<link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
+{{- end }}
+{{- with .Site.Params.style_overrides }}
+<link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
+{{- end }}
+{{- with .Page.Params.page_css_file }}
+<link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}">
+{{- end }}
 {{- end }}
 {{- partial "google_tag_manager.html" . }}
 {{- partial "head_variables.html" . }}

package/layouts/partials/header.html

@@ -1,24 +1,24 @@
-{{/*
-  Copyright (c) 2023 Eclipse Foundation, Inc.
+<!-- 
+  Copyright (c) 2025 Eclipse Foundation AISBL
 
   This program and the accompanying materials are made available under the
   terms of the Eclipse Public License v. 2.0 which is available at
   http://www.eclipse.org/legal/epl-2.0.
 
-  Contributors:
-    Olivier Goulet <olivier.goulet@eclipse-foundation.org>
-
   SPDX-License-Identifier: EPL-2.0
-*/}}
+-->
 
 {{ $header_wrapper_class := .Params.header_wrapper_class | default .Site.Params.header_wrapper_class }}
 
 {{ partial "google_tag_manager_no_script.html" . }}
-<a class="sr-only" href="#content">{{ i18n "navigation-content-skip" }}</a>
+<a href="#main" class="skip-link">Skip to content</a>
+{{ if or (ne .Page.Params.hide_featured_story_banner true) (ne $.Site.Params.hide_featured_story_banner) }}
+  {{ $publish_target := .Page.Params.featured_content_publish_target | default .Site.Params.featured_content_publish_target | default "eclipse_org" }}
+  <div class="eclipsefdn-featured-story-banner" data-publish-target="{{ $publish_target }}"></div>
+{{ end }} 
 <header class="header-wrapper {{ $header_wrapper_class }}" id="header">
   {{ partial "toolbar.html" . }}
   {{ partial "navbar.html" . }}
   {{ partial "mobile_menu.html" . }}
   {{ partial "mega_menu.html" . }}
-  {{ partial "jumbotron.html" . }}
 </header>