eclipsefdn-hugo-solstice-theme 3.0.0 → 3.1.0

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.2/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # eclipsefdn-hugo-solstice-theme
 
+## 3.1.0
+
+### Minor Changes
+
+- 2e7f59d: [Params] Add support for an array of styles & scripts with ESM support in site config
+
+## 3.0.1
+
+### Patch Changes
+
+- 611ee9c: Fix `seo_title_suffix` not having a fallback which caused strange
+  output in title tags
+- 4b531a5: Update eclipse.org menu's explore projects link
+- e2a7ae1: Fix featured story popup not using the `publish_target` parameter
+
+## 3.0.0
+
+### Major Changes
+
+- d95247d: Extract Neptune into its own package
+
+### Minor Changes
+
+- 297c5d9: [Menu] Add Bring Your Project menu item
+
+## 2.0.0
+
+### Major Changes
+
+- a703b87: Extract Astro into its own package
+
+## 1.0.1
+
+### Patch Changes
+
+- 730d2dc: [SEO] Add seo_title_suffix fallback
+- 18b980e: [Featured Story Popup] Fix publish target not applying
+
+## 1.0.0
+
+### Major Changes
+
+- 49f11b9: Extract Quicksilver into its own package
+
+## 0.3.3
+
+### Patch Changes
+
+- aa2ec26: Upgrade eclipsefdn-solstice-assets to 0.2.8 to resolve bugs
+- 40a389d: Update @eclipsefdn/solstice-components peer dependency version
+
+## 0.3.2
+
+### Patch Changes
+
+- 969234d: Upgrade dependencies
+
 ## 0.3.1
 
 ### Patch Changes
@@ -11,7 +68,7 @@
 ### Minor Changes
 
 - b1c65af: [Featured Story Popup] Add featured story popup component
-- d1e7e7c: Add solstice-components as peer dependency
+- d1e7e7c: Add @eclipsefdn/solstice-components as peer dependency
 
 ## 0.2.6
 
@@ -23,7 +80,7 @@
 
 ### Patch Changes
 
-- 3177e60: Upgrade efsa to 0.2.4
+- 3177e60: Upgrade eclipsefdn-solstice-assets to 0.2.4
 
 ## 0.2.4
 
@@ -37,7 +94,7 @@
 
 ### Patch Changes
 
-- b12ce69: Upgrade efsa to 0.2.2
+- b12ce69: Upgrade eclipsefdn-solstice-assets to 0.2.2
 
 ## 0.2.2
 
@@ -54,7 +111,7 @@
 
 ### Patch Changes
 
-- 4d3a118: Upgrade efsa to 0.2.1
+- 4d3a118: Upgrade eclipsefdn-solstice-assets to 0.2.1
 - d02c9fc: [Featured Footer] Fix publish target not applying
 
 ## 0.2.0
@@ -89,7 +146,7 @@
 
 ### Patch Changes
 
-- 312914d: Upgrade efsa to 0.1.21
+- 312914d: Upgrade eclipsefdn-solstice-assets to 0.1.21
 
 ## 0.1.18
 
@@ -107,14 +164,14 @@
 
 ### Minor Changes
 
-- a25dd3d: Upgrade efsa to 0.1.18
+- a25dd3d: Upgrade eclipsefdn-solstice-assets to 0.1.18
 - 229ce92: Add option to hide or unformat seo_title and seo_title_suffix
 
 ## 0.1.15
 
 ### Patch Changes
 
-- 0d3f05e: Upgrade efsa to 0.1.17
+- 0d3f05e: Upgrade eclipsefdn-solstice-assets to 0.1.17
 
 ## 0.1.14
 
@@ -167,7 +224,7 @@
 
 ### Minor Changes
 
-- 7df36f1: Upgrade efsa to 0.1.10
+- 7df36f1: Upgrade eclipsefdn-solstice-assets to 0.1.10
 
 ## 0.1.7
 
@@ -177,7 +234,7 @@
 
 ### Patch Changes
 
-- c64cfa0: Upgrade efsa
+- c64cfa0: Upgrade eclipsefdn-solstice-assets
 
 ## 0.1.6
 
@@ -196,7 +253,7 @@
 
 ### Patch Changes
 
-- bd541ba: Upgrade efsa to 0.1.7
+- bd541ba: Upgrade eclipsefdn-solstice-assets to 0.1.7
 - 49f1f23: Fix news pagination not appearing
 
 ## 0.1.3
@@ -209,7 +266,7 @@
 
 ### Patch Changes
 
-- 505f118: Upgrade efsa to 0.1.4
+- 505f118: Upgrade eclipsefdn-solstice-assets to 0.1.4
 
 ## 0.1.1
 

package/config.toml

@@ -157,7 +157,7 @@
 
 [[menu.neptune]]
   name = "Explore projects"
-  url = "https://projects.eclipse.org/"
+  url = "https://www.eclipse.org/projects/"
   weight = 1
   parent = "projects"
 

package/exampleSite/config/_default/config.toml

@@ -15,8 +15,6 @@ 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/neptune.css"
-  js = "js/neptune.js"
   gcse = "011805775785170369411:p3ec0igo0qq"
   gcse_result_url = "/search"
   # eclipse_search_icon = "<i data-feather=\"search\" stroke-width=\"1\"></i>"
@@ -60,3 +58,11 @@ baseURL = "https://webdev.eclipse.org/docs/hugo"
 [blackfriday]
   plainIDAnchors = true
   hrefTargetBlank = true
+
+[[Params.styles]]
+  url = "css/neptune.css"
+  cache = true
+
+[[Params.scripts]]
+  url = "js/neptune.js"
+  cache = true

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,30 @@ 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.
+  - name: scripts
+    description: Array of script objects to load on the page, rendered after site-level scripts. Each entry can define a type, url, cache, defer, and integrity.
     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.
+      - "Array of objects with the following properties: url (string, required), type (string, e.g. module), cache (boolean, appends ?v=timestamp to bust cache), defer (boolean), integrity (string)"
+    example: |
+      scripts:
+        - type: "module"
+          url: "/js/page-specific.mjs"
+          cache: true
+  - name: styles
+    description: Array of stylesheet objects to load on the page, rendered after site-level styles. Replaces the deprecated page_css_file param.
+    values:
+      - "Array of objects with the following properties: url (string, required), cache (boolean, appends ?v=timestamp to bust cache)"
+    example: |
+      styles:
+        - url: "/css/page-specific.css"
+          cache: true
+  -
+    name: page_css_file
+    deprecated: true
+    description: "Deprecated: use the page-level styles array instead. URL to an additional stylesheet to load on this page."
     values:
-      - Any string value
-  - 
+      - Absolute links or fully qualified URLs.
+  -
     name: Summary
     description: Built in Hugo document parameter. Used in the head meta description if the Description parameter is not set.
     values:
@@ -146,23 +158,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,14 +68,10 @@ 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>
+    deprecated: true
+    description: "Deprecated: use [[Params.scripts]] array instead. URL to the main javascript to be used on 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:
       - Absolute link or fully qualified URL to a JS file
   - 
@@ -100,19 +80,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:
@@ -132,24 +100,23 @@ items:
     description:  Boolean value, when set to true events will be enabled on the site.
     values:
       - "true"
-  - 
+  -
     name: styles
-    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"
+    description: Array of stylesheet objects to load site-wide. Each entry supports url and cache (appends ?v=timestamp). Page-level styles are always appended after site styles. Defaults to the Neptune stylesheet.
     values:
-      - Absolute link to YouTube profile
-  - 
+      - "Array of objects with the following properties: url (string, required), cache (boolean, appends ?v=timestamp to bust cache)"
+    deprecated_values:
+      - "Deprecated string form: a single URL string — use [[Params.styles]] array instead. The legacy style_overrides string param is also deprecated in favour of adding additional entries to this array."
+    example: |
+      <pre>
+      [[Params.styles]]
+        url = "/css/main.css"
+        cache = true
+
+      [[Params.styles]]
+        url = "/css/overrides.css"
+      </pre>
+  -
     name: hide_breadcrumb
     description: Hides the breadcrumb on all pages if set to true, otherwise ignored.
     values:
@@ -164,6 +131,28 @@ items:
     description: Optional custom_jumbotron_class that will be used for custom_jumbotron.
     values:
       - Any string value
+  -
+    name: newsroom_esm
+    description: When set to true, the inline newsroom components script (events, news items) is rendered as an ES module using `import $ from "jquery"`. Defaults to false.
+    values:
+      - "true"
+      - "false"
+  - name: scripts
+    description: Array of script objects to load site-wide. Each entry can define a type, url, cache, defer, and integrity. When defined, this replaces the js and hugo_js params.
+    values:
+      - "Array of objects with the following properties: url (string, required), type (string, e.g. module), cache (boolean, appends ?v=timestamp to bust cache), defer (boolean), integrity (string)"
+    example: |
+      <pre>
+      [[Params.scripts]]
+        type = "module"
+        url = "/js/main.mjs"
+        cache = true
+
+      [[Params.scripts]]
+        defer = true
+        url = "https://some.cdn.com/js/script.js"
+        integrity = "sha384-..."
+      </pre>
   - name: socials
     values:
       - "Array of objects with the following properties: name (string), icon (string, Font Awesome 6 icon classes), url (string)"

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/partials/featured_story_popup.html

@@ -1,8 +1,9 @@
 {{ if .Page.Params.show_featured_story_popup }}
+  {{ $publish_target := .Page.Params.featured_content_publish_target | default .Site.Params.featured_content_publish_target | default "eclipse_org" }}
   <efsc-featured-story-popup
     autoopen='{"xs":false,"md":true}'
     variant="tertiary"
-    publishtarget="eclipse_org"
+    publishtarget="{{ $publish_target }}"
     type="popup"
   ></efsc-featured-story-popup>
   <style>

package/layouts/partials/footer_js.html

@@ -1,13 +1,39 @@
 <div id="footer-js">
   <!-- Placed at the end of the document so the pages load faster -->
   {{- $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 }}
+  {{- $site_scripts := .Site.Params.scripts -}}
+  {{- $page_scripts := .Page.Params.scripts -}}
 
-  {{- with .Site.Params.hugo_js }}
+  {{- if $site_scripts -}}
+    {{- range $site_scripts -}}
+      {{- $src := .url | relURL -}}
+      {{- if .cache -}}{{- $src = printf "%s?v=%d" $src now.Unix -}}{{- end -}}
+      {{- $stag := printf `<script src="%s"` $src -}}
+      {{- with .type -}}{{- $stag = printf `%s type="%s"` $stag . -}}{{- end -}}
+      {{- if .defer -}}{{- $stag = printf "%s defer" $stag -}}{{- end -}}
+      {{- with .integrity -}}{{- $stag = printf `%s integrity="%s"` $stag . -}}{{- end -}}
+      {{- (printf "%s></script>" $stag) | safeHTML -}}
+    {{- end }}
+  {{- else if .Site.Params.js -}}
+    {{- warnf "Param 'Params.js' is deprecated. Use [[Params.scripts]] array instead. See https://webdev.eclipse.org/docs/hugo/" -}}
+    <script src="{{ .Site.Params.js | relURL }}?v={{ now.Unix }}"></script>
+    {{- with .Site.Params.hugo_js }}
+    {{- warnf "Param 'Params.hugo_js' is deprecated. Use [[Params.scripts]] array instead. See https://webdev.eclipse.org/docs/hugo/" -}}
     <script src="{{ . | relURL }}"></script>
-  {{ end }}
+    {{- end }}
+  {{- else -}}
+    <script src="{{ $default_js | relURL }}?v={{ now.Unix }}"></script>
+  {{- end }}
+
+  {{- range $page_scripts -}}
+    {{- $src := .url | relURL -}}
+    {{- if .cache -}}{{- $src = printf "%s?v=%d" $src now.Unix -}}{{- end -}}
+    {{- $stag := printf `<script src="%s"` $src -}}
+    {{- with .type -}}{{- $stag = printf `%s type="%s"` $stag . -}}{{- end -}}
+    {{- if .defer -}}{{- $stag = printf "%s defer" $stag -}}{{- end -}}
+    {{- with .integrity -}}{{- $stag = printf `%s integrity="%s"` $stag . -}}{{- end -}}
+    {{- (printf "%s></script>" $stag) | safeHTML -}}
+  {{- end }}
 
   <!-- Read in mustache templates registered in page scratch -->
   {{ range $key, $value := (.Page.Scratch.Get "mustache-templates") }}
@@ -17,6 +43,21 @@
   {{ end }}
 
   <!-- Initialize any newsroom components on the page -->
+  {{ if (.Site.Params.newsroom_esm | default false) -}}
+  <script type="module">
+    import $ from "jquery";
+    {{ range (.Page.Scratch.Get "events-container-ids") }}
+      $("#{{ . }}").eclipseFdnApi({
+        type: "filteredEvents"
+      });
+    {{ end }}
+    {{ range (.Page.Scratch.Get "news-container-ids") }}
+      $("#{{ . }}").eclipseFdnApi({
+        type: "newsItems"
+      });
+    {{ end }}
+  </script>
+  {{- else -}}
   <script>
   (function($, document) {
     {{ range (.Page.Scratch.Get "events-container-ids") }}
@@ -31,6 +72,7 @@
     {{ end }}
   })(jQuery, document);
   </script>
+  {{- end }}
 
   {{ if eq (.Page.Scratch.Get "is_using_twitter") "true" }}
     <script src="https://platform.twitter.com/widgets.js" async></script>

package/layouts/partials/head.html

@@ -10,9 +10,9 @@
 
   SPDX-License-Identifier: EPL-2.0
 -->
-<meta charset="utf-8">
-<meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta charset="utf-8" />
+<meta http-equiv="X-UA-Compatible" content="IE=edge" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
 <!-- Site Title, Description, Author, and Favicon -->
 {{ $title :=  .Params.seo_title | default (.Params.headline | plainify) | default (.Title | plainify) | default .Site.Title }}
 {{ if (.Params.format_seo_title | default true) }}
@@ -20,51 +20,58 @@
 {{ end }}
 {{ $title_suffix := "" }}
 {{ if not .Params.hide_seo_title_suffix }}
-  {{ $title_suffix = .Params.seo_title_suffix | default .Site.Params.seo_title_suffix }}
+  {{ $title_suffix = .Params.seo_title_suffix | default .Site.Params.seo_title_suffix | default "" }}
 {{ end }}
 {{ $full_title := printf "%s%s" $title $title_suffix }}
 <title>{{ $full_title }}</title>
 <meta property="og:title" content="{{ $full_title }}" />
-<meta name="twitter:title" content="{{ $title | truncate 70 }}{{ $title_suffix }}" />
+<meta
+  name="twitter:title"
+  content="{{ $title | truncate 70 }}{{ $title_suffix }}"
+/>
 {{ if isset .Page.Params "redirect_url" }}
-<link rel="canonical" href="{{ .Page.Params.redirect_url }}"/>
-<meta name="robots" content="noindex">
-<meta http-equiv="refresh" content="0; url={{ .Page.Params.redirect_url }}" />
+  <link rel="canonical" href="{{ .Page.Params.redirect_url }}" />
+  <meta name="robots" content="noindex" />
+  <meta http-equiv="refresh" content="0; url={{ .Page.Params.redirect_url }}" />
 {{ end }}
 {{- with .Description | default .Page.Params.summary | default .Site.Params.description | plainify }}
-{{- with  . | replaceRE "{{[\\s\\S]*?}}" " " | truncate 160 }}
-<meta name="description" content="{{ . }}">
-<meta property="og:description" content="{{ . }}">
-<meta name="twitter:description" content="{{ . }}">
-{{- end }}
+  {{- $description_clean_pattern := "{{[\\s\\S]*? }}\\s*" -}}
+  {{- with . | replaceRE $description_clean_pattern " " | truncate 160 }}
+    <meta name="description" content="{{ . }}" />
+    <meta property="og:description" content="{{ . }}" />
+    <meta name="twitter:description" content="{{ . }}" />
+  {{- end }}
 {{- end }}
 {{- with .Page.Params.author }}
-<meta name="author" content="{{ . }}"/>
+  <meta name="author" content="{{ . }}" />
 {{- end }}
- {{- with  .Params.page_favicon | default .Site.Params.favicon | default "https://www.eclipse.org/favicon.ico"}}
-<link href='{{ . | relURL }}' rel='icon' type='image/x-icon'/>
+{{- with  .Params.page_favicon | default .Site.Params.favicon | default "https://www.eclipse.org/favicon.ico" }}
+  <link href="{{ . | relURL }}" rel="icon" type="image/x-icon" />
 {{- end -}}
 {{- with .Page.Params.metatag_robots }}
-  <meta name="robots" content="{{ . }}">
+  <meta name="robots" content="{{ . }}" />
 {{- end }}
 <!-- Social Media Tags -->
 {{- with .Params.share_img | default .Params.image  | default .Site.Params.share_img | default .Site.Params.logo }}
-<meta property="og:image" content="{{ . | absURL }}" />
-<meta name="twitter:image" content="{{ . | absURL }}" />
+  <meta property="og:image" content="{{ . | absURL }}" />
+  <meta name="twitter:image" content="{{ . | absURL }}" />
 {{- end }}
 <meta name="twitter:card" content="summary" />
 {{- with .Site.Params.author.twitter }}
-<meta name="twitter:site" content="@{{ . }}" />
-<meta name="twitter:creator" content="@{{ . }}" />
+  <meta name="twitter:site" content="@{{ . }}" />
+  <meta name="twitter:creator" content="@{{ . }}" />
 {{- end }}
 {{- with .Site.Params.fb_app_id }}
-<meta property="fb:app_id" content="{{ . }}" />
+  <meta property="fb:app_id" content="{{ . }}" />
 {{- end }}
 <meta property="og:url" content="{{ .Permalink | absLangURL }}" />
 <meta property="og:type" content="website" />
 <meta property="og:site_name" content="{{ .Site.Title }}" />
 {{- with .Keywords | default .Site.Params.keywords }}
-<meta name="keywords" content="{{ range $i, $e := . }}{{ if $i }}, {{ end }}{{ $e }}{{ end }}">
+  <meta
+    name="keywords"
+    content="{{ range $i, $e := . }}{{ if $i }},{{ end }}{{ $e }}{{ end }}"
+  />
 {{ end }}
 <!-- Hugo Version number -->
 {{ hugo.Generator -}}
@@ -72,33 +79,66 @@
 {{ $canonical_url := (.Page.Params.canonical_url | default .Permalink) | absLangURL }}
 <link rel="canonical" href="{{ $canonical_url }}" />
 {{ with .OutputFormats.Get "RSS" }}
-<link rel="alternate" href="{{ .RelPermalink }}" type="application/rss+xml" title="">
+  <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/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 }}
+  {{- $default_css := "https://www.eclipse.org/public/css/neptune.css" -}}
+  {{- $site_styles := .Site.Params.styles -}}
+  {{- $page_styles := .Page.Params.styles -}}
+
+  {{- if $site_styles -}}
+    {{- range $site_styles -}}
+      {{- $href := .url | relURL -}}
+      {{- if .cache -}}
+        {{- $href = printf "%s?v=%d" $href now.Unix -}}
+      {{- end -}}
+      <link rel="stylesheet" href="{{ $href }}" />
+    {{- end }}
+  {{- else if .Site.Params.styles -}}
+    {{- warnf "Param 'Params.styles' is deprecated. Use [[Params.styles]] array instead. See https://webdev.eclipse.org/docs/hugo/" -}}
+    <link rel="stylesheet" href="{{ .Site.Params.styles | relURL }}?v={{ now.Unix }}" />
+    {{- with .Site.Params.style_overrides }}
+    {{- warnf "Param 'Params.style_overrides' is deprecated. Use [[Params.styles]] array instead. See https://webdev.eclipse.org/docs/hugo/" -}}
+    <link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}" />
+    {{- end }}
+  {{- else -}}
+    <link
+      rel="stylesheet"
+      href="{{ $default_css | relURL }}?v={{ now.Unix }}"
+    />
+  {{- end }}
+
+  {{- range $page_styles -}}
+    {{- $href := .url | relURL -}}
+    {{- if .cache -}}{{- $href = printf "%s?v=%d" $href now.Unix -}}{{- end -}}
+    <link rel="stylesheet" href="{{ $href }}" />
+  {{- end }}
+
+  {{- if not $page_styles -}}
+    {{- with .Page.Params.page_css_file }}
+    {{- warnf "Page param 'page_css_file' is deprecated. Use the page-level styles array instead. See https://webdev.eclipse.org/docs/hugo/" -}}
+    <link rel="stylesheet" href="{{ . | relURL }}?v={{ now.Unix }}" />
+    {{- end }}
+  {{- end }}
 {{- end }}
 {{- partial "google_tag_manager.html" . }}
 {{- partial "head_variables.html" . }}
 
 {{ $metadata := .Page.Params.metadata | default slice }}
 {{ range $metadata }}
-    {{ $path_parts := split .path "/" }}
-    {{ $data := $.Site.Data }}
-    {{ range $path_parts }}
+  {{ $path_parts := split .path "/" }}
+  {{ $data := $.Site.Data }}
+  {{ range $path_parts }}
     {{ $data = index $data . }}
   {{ end }}
   {{ if eq .type "ld+json" }}
     <script type="application/ld+json">
-      {{ with $data }} 
+      {{ with $data }}
         {{ . }}
       {{ end }}
     </script>

package/package.json

@@ -4,7 +4,7 @@
   "main": "webpack.min.js",
   "author": "Christopher Guindon",
   "license": "EPL-2.0",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "bugs": {
     "url": "https://gitlab.eclipse.org/eclipsefdn/it/webdev/hugo-solstice-theme/-/issues"
   },
@@ -18,16 +18,19 @@
     "hot": "NODE_ENV=development webpack-dev-server --inline --hot --config=node_modules/laravel-mix/setup/webpack.config.js",
     "production": "NODE_ENV=production webpack --progress --config=node_modules/laravel-mix/setup/webpack.config.js",
     "fetch_project": "node bin/projects/index.js -l exampleSite/data",
-    "build": "npm run production && npm run fetch_project"
+    "build": "npm run production && npm run fetch_project",
+    "changeset": "changeset"
   },
   "readmeFilename": "README.md",
   "dependencies": {
-    "eclipsefdn-solstice-assets": "0.2.8",
+    "eclipsefdn-solstice-assets": "0.2.9",
     "json2yaml": "^1.1.0",
     "toml": "^3.0.0"
   },
   "browserslist": "last 5 version, > 0.2%, not dead, IE 11",
-  "devDependencies": {},
+  "devDependencies": {
+    "@changesets/cli": "^2.31.0"
+  },
   "peerDependencies": {
     "@eclipsefdn/solstice-components": ">=0.7.0 <1.0.0"
   }