eclipsefdn-hugo-solstice-theme 0.1.12 → 0.1.13

package/config.toml

@@ -272,10 +272,16 @@
   weight = 1
   parent = "resources-open-source"
 
+[[menus.astro]]
+  name = "Professional Services"
+  url = "https://www.eclipse.org/os4biz/services/"
+  weight = 2
+  parent = "resources-open-source"
+
 [[menus.astro]]
   name = "Open Source Program Offices"
   url = "https://www.eclipse.org/os4biz/ospo/"
-  weight = 2
+  weight = 3
   parent = "resources-open-source"
 
 [[menus.astro]]

package/exampleSite/content/components/paginated_video_list.md

@@ -0,0 +1,62 @@
+---
+title: Paginated Video List
+date: 2022-12-15
+hide_sidebar: true
+---
+
+Renders an aggregated, paginated and filterable list of videos from playlists.
+
+{{< paginated_video_list count="4" src="paginated_video_list_playlists" >}}
+
+## How it works
+
+This shortcode uses Hugo's [resources.GetRemote](https://gohugo.io/functions/resources/getremote/) function to fetch YouTube RSS feeds for each playlist in real-time during site build. This means:
+
+- Content is fetched at build time, not runtime, ensuring fast page loads
+- Videos are automatically updated when the site is rebuilt
+- No API keys are required since it uses YouTube's public RSS feeds
+
+Note that since resources.GetRemote works at build time, any changes to the YouTube playlists will only be reflected after rebuilding the site.
+
+## Parameters
+
+#### Using a data file for playlists
+
+You can use a data file to list out the playlists which you want to use for the `paginated_video_list` shortcode.
+The parameter to specify the name of the data file is `src`.
+
+```md
+{{</* paginated_video_list src="playlists" */>}}
+```
+
+The example above will target `/data/playlists.yml`.
+
+The data file should have an array at the top level. Within the array, you need an object with the `title` and `id` properties.
+
+#### Having your data files work with localization
+
+If you want to display different playlists for different locales, you can use the `src` parameter in combination with the `localize` parameter.
+
+The `localize` parameter is a boolean.
+
+```md
+{{</* paginated_video_list src="playlists" localize="true" */>}}
+```
+
+The example above will target `/data/fr/playlists.yml` if the user's locale is "fr".
+
+### Setting a max description length
+
+You can change the max description character length using the `description_max` shortcode parameter. The default value is `200`.
+
+```md
+{{</* paginated_video_list src="playlists" description_max="100" */>}}
+```
+
+### Setting items per page
+
+You can control how many videos appear on each page using the `count` parameter. The default value is `6`.
+
+```md
+{{</* paginated_video_list src="playlists" count="8" */>}}
+```

package/exampleSite/data/paginated_video_list_playlists.yml

@@ -0,0 +1,12 @@
+# Copyright (c) Eclipse Foundation
+#
+# This program and the accompanying materials are made
+# available under the terms of the Eclipse Public License 2.0
+# which is available at https://www.eclipse.org/legal/epl-2.0/
+#
+# SPDX-License-Identifier: EPL-2.0
+
+- title: "SDV Community Interviews Sep 2022"
+  id: "PLy7t4z5SYNaSruNciCsq79vfquXnZ7iTi"
+- title: "Virtual IoT 2022"
+  id: "PLy7t4z5SYNaQejP4OMb-i3hC7-fO_u03j"

package/layouts/shortcodes/html.html

@@ -0,0 +1,10 @@
+{{/*
+  Copyright (c) 2025 Eclipse Foundation, Inc.
+
+  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.
+
+  SPDX-License-Identifier: EPL-2.0
+*/}}
+{{ .Inner | safeHTML }}

package/layouts/shortcodes/paginated_video_list.html

@@ -0,0 +1,39 @@
+<!--
+ Copyright (c) Eclipse Foundation
+
+ This program and the accompanying materials are made
+ available under the terms of the Eclipse Public License 2.0
+ which is available at https://www.eclipse.org/legal/epl-2.0/
+
+ SPDX-License-Identifier: EPL-2.0
+-->
+
+{{ $params := dict 
+  "description_max" (.Get "description_max" | default 200)
+  "count" (.Get "count" | default 6)
+  "filterable" (.Get "filterable" | default true)
+}}
+
+{{ $base := cond (eq (.Get "localize" | default "false") "false") .Site.Data (index .Site.Data .Page.Lang) }}
+{{ $playlists := index $base (.Get "src") }}
+{{ $store := .Store }}
+
+{{ range $playlist := $playlists }}
+  {{ with resources.GetRemote (print "https://www.youtube.com/feeds/videos.xml?playlist_id=" $playlist.id) }}
+    {{ range $video := (.Content | transform.Unmarshal).entry }}
+      {{ $store.SetInMap "videos" (.title | urlize) (merge $video (dict "category" $playlist.title)) }}
+    {{ end }}
+  {{ end }}
+{{ end }}
+
+<div class="eclipsefdn-paginated-video-list" data-count="{{ $params.count }}" data-filterable="{{ $params.filterable }}">
+  {{ range sort ($store.GetSortedMapValues "videos") "published" "desc" }}
+    <div class="video-item"
+          data-title="{{ .title }}"
+          data-id="{{ .videoId }}"
+          data-category="{{ .category }}"
+          data-date='{{ time.Format "2 January 2006" .published }}'
+          data-description='{{ index .group "description" | truncate $params.description_max }}'
+    ></div>
+  {{ end }}
+</div>

package/package.json

@@ -4,7 +4,7 @@
   "main": "webpack.min.js",
   "author": "Christopher Guindon",
   "license": "EPL-2.0",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "bugs": {
     "url": "https://gitlab.eclipse.org/eclipsefdn/it/webdev/hugo-solstice-theme/-/issues"
   },
@@ -23,7 +23,7 @@
   "readmeFilename": "README.md",
   "dependencies": {
     "axios": "^1.7.7",
-    "eclipsefdn-solstice-assets": "0.1.15",
+    "eclipsefdn-solstice-assets": "0.1.16",
     "json2yaml": "^1.1.0",
     "toml": "^3.0.0"
   },