Vendor theme

2026-08-24 15:28:54 +00:00 · 2024-04-26 14:42:04 -07:00
parent 21247df4eb
commit 5befe5f280
9 changed files with 168 additions and 62 deletions
@@ -1,4 +1,4 @@
-{{- /* Last modified: 2023-09-04T09:23:04-07:00 */}}
+{{- /* Last modified: 2024-04-26T13:54:00-07:00 */}}

 {{- /*
 Copyright 2023 Veriphor LLC
@@ -118,7 +118,7 @@ either of these shortcodes in conjunction with this render hook.
  {{- $attrs = merge $attrs (dict "rel" "external") }}
 {{- else }}
  {{- with $u.Path }}
-    {{- with $p := or ($.Page.GetPage .) ($.Page.GetPage (strings.TrimRight "/" .)) }}
+    {{- with $p := or ($.PageInner.GetPage .) ($.PageInner.GetPage (strings.TrimRight "/" .)) }}
      {{- /* Destination is a page. */}}
      {{- $href := .RelPermalink }}
      {{- with $u.RawQuery }}
@@ -137,7 +137,7 @@ either of these shortcodes in conjunction with this render hook.
      {{- end }}
      {{- $attrs = dict "href" $href }}
    {{- else }}
-      {{- with $.Page.Resources.Get $u.Path }}
+      {{- with $.PageInner.Resources.Get $u.Path }}
        {{- /* Destination is a page resource; drop query and fragment. */}}
        {{- $attrs = dict "href" .RelPermalink }}
      {{- else }}
@@ -185,14 +185,14 @@ either of these shortcodes in conjunction with this render hook.
    {{- end }}
  {{- end }}
 {{- end }}
-{{- with .Title }}
-  {{- $attrs = merge $attrs (dict "title" .) }}
-{{- end -}}
+{{- $attrs = merge $attrs (dict "title" (.Title | transform.HTMLEscape)) }}

 {{- /* Render anchor element. */ -}}
 <a
  {{- range $k, $v := $attrs }}
-    {{- printf " %s=%q" $k $v | safeHTMLAttr }}
+    {{- if $v }}
+      {{- printf " %s=%q" $k $v | safeHTMLAttr }}
+    {{- end }}
  {{- end -}}
 >{{ .Text | safeHTML }}</a>

@@ -1,38 +1,68 @@
+{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
 <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
-    <title>{{ .Site.Title }} – {{ .Title }}</title>
+    <title>Hugo News</title>
+    <description>Recent news about Hugo, a static site generator written in Go, optimized for speed and designed for flexibility.</description>
    <link>{{ .Permalink }}</link>
-    <description>Recent Hugo news from gohugo.io</description>
-    <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
-    <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
-    <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
-    <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
-    <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
-    <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
-    <image>
-      <url>{{ "img/hugo.png" | absURL }}</url>
-      <title>GoHugo.io</title>
-      <link>{{ .Permalink }}</link>
-    </image>
-    {{ with .OutputFormats.Get "RSS" }}
-	{{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
-    {{ end }}
-    {{ range first 50 (where .Site.RegularPages "Type" "in" (slice "news" "showcase")) }}
-    <item>
-      <title>{{ .Section | title }}: {{ .Title }}</title>
-      <link>{{ .Permalink }}</link>
-      <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
-      {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
-      <guid>{{ .Permalink }}</guid>
-      <description>
-        {{ $img := (.Resources.ByType "image").GetMatch "*featured*" }}
-        {{ with $img }}
-        {{ $img := .Resize "640x" }}
-        {{ printf "<![CDATA[<img src=\"%s\" width=\"%d\" height=\"%d\"/>]]>" $img.Permalink $img.Width $img.Height | safeHTML }}
-        {{ end }}
-        {{ .Content | html }}
-      </description>
-    </item>
-    {{ end }}
+    <generator>Hugo {{ hugo.Version }}</generator>
+    <language>{{ or site.Language.LanguageCode site.Language.Lang }}</language>
+    {{- with site.Copyright }}
+      <copyright>{{ . }}</copyright>
+    {{- end }}
+    {{- with .OutputFormats.Get "RSS" }}
+      {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
+    {{- end }}
+
+    {{- $news_items := slice }}
+
+    {{- /* Get releases from GitHub. */}}
+    {{- $u := "https://api.github.com/repos/gohugoio/hugo/releases" }}
+    {{- $releases := partial "utilities/get-remote-data.html" $u }}
+    {{- $releases = where $releases "draft" false }}
+    {{- $releases = where $releases "prerelease" false }}
+    {{- range $releases | first 20 }}
+      {{- $summary := printf
+        "Hugo %s was released on %s. See [release notes](%s) for details."
+        .tag_name
+        (.published_at | time.AsTime | time.Format "2 Jan 2006")
+        .html_url
+      }}
+      {{- $ctx := dict
+        "PublishDate" (.published_at | time.AsTime)
+        "Title" (printf "Release %s" .name)
+        "Permalink" .html_url
+        "Section" "news"
+        "Summary" ($summary | $.Page.RenderString)
+      }}
+      {{- $news_items = $news_items | append $ctx }}
+    {{- end }}
+
+    {{- /* Get content pages from news section. */}}
+    {{- range where site.RegularPages "Section" "news" }}
+      {{- $ctx := dict
+        "PublishDate" .PublishDate
+        "Title" .Title
+        "RelPermalink" .RelPermalink
+        "Section" "news"
+        "Summary" .Summary
+        "Params" (dict "description" .Description)
+      }}
+      {{- $news_items = $news_items | append $ctx }}
+    {{- end }}
+    {{- /* Sort, limit, and render lastBuildDate. */}}
+    {{- $limit := cond (gt site.Config.Services.RSS.Limit 1) site.Config.Services.RSS.Limit 999 }}
+    {{- $news_items = sort $news_items "PublishDate" "desc" | first $limit }}
+    <lastBuildDate>{{ (index $news_items 0).PublishDate.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>
+
+    {{- /* Render items. */}}
+    {{- range $news_items }}
+      <item>
+        <title>{{ .Title }}</title>
+        <link>{{ .Permalink }}</link>
+        <pubDate>{{ .PublishDate.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
+        <guid>{{ .Permalink }}</guid>
+        <description>{{ .Summary | transform.XMLEscape | safeHTML }}</description>
+      </item>
+    {{- end }}
  </channel>
-</rss>
+</rss>
@@ -18,7 +18,7 @@

      {{/* Get releases from GitHub. */}}
      {{ $u := "https://api.github.com/repos/gohugoio/hugo/releases" }}
-      {{ $releases := partial "inline/get-remote-data.html" $u }}
+      {{ $releases := partial "utilities/get-remote-data.html" $u }}
      {{ $releases = where $releases "draft" false }}
      {{ $releases = where $releases "prerelease" false }}
      {{ range $releases | first 20 }}
@@ -55,16 +55,3 @@

 </div>
 {{ end }}
-
-{{ define "partials/inline/get-remote-data.html" }}
-  {{ $u := . }}
-  {{ $r := "" }}
-  {{ with $r = resources.GetRemote $u }}
-    {{ with .Err }}
-      {{ errorf "%s" . }}
-    {{ end }}
-  {{ else }}
-    {{ errorf "Unable to get remote resource %q" $u }}
-  {{ end }}
-  {{ return ($r | transform.Unmarshal) }}
-{{ end }}
@@ -0,0 +1,68 @@
+{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Hugo News</title>
+    <description>Recent news about Hugo, a static site generator written in Go, optimized for speed and designed for flexibility.</description>
+    <link>{{ .Permalink }}</link>
+    <generator>Hugo {{ hugo.Version }}</generator>
+    <language>{{ or site.Language.LanguageCode site.Language.Lang }}</language>
+    {{- with site.Copyright }}
+      <copyright>{{ . }}</copyright>
+    {{- end }}
+    {{- with .OutputFormats.Get "RSS" }}
+      {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
+    {{- end }}
+
+    {{- $news_items := slice }}
+
+    {{- /* Get releases from GitHub. */}}
+    {{- $u := "https://api.github.com/repos/gohugoio/hugo/releases" }}
+    {{- $releases := partial "utilities/get-remote-data.html" $u }}
+    {{- $releases = where $releases "draft" false }}
+    {{- $releases = where $releases "prerelease" false }}
+    {{- range $releases | first 20 }}
+      {{- $summary := printf
+        "Hugo %s was released on %s. See [release notes](%s) for details."
+        .tag_name
+        (.published_at | time.AsTime | time.Format "2 Jan 2006")
+        .html_url
+      }}
+      {{- $ctx := dict
+        "PublishDate" (.published_at | time.AsTime)
+        "Title" (printf "Release %s" .name)
+        "Permalink" .html_url
+        "Section" "news"
+        "Summary" ($summary | $.Page.RenderString)
+      }}
+      {{- $news_items = $news_items | append $ctx }}
+    {{- end }}
+
+    {{- /* Get content pages from news section. */}}
+    {{- range .Pages }}
+      {{- $ctx := dict
+        "PublishDate" .PublishDate
+        "Title" .Title
+        "RelPermalink" .RelPermalink
+        "Section" "news"
+        "Summary" .Summary
+        "Params" (dict "description" .Description)
+      }}
+      {{- $news_items = $news_items | append $ctx }}
+    {{- end }}
+    {{- /* Sort, limit, and render lastBuildDate. */}}
+    {{- $limit := cond (gt site.Config.Services.RSS.Limit 1) site.Config.Services.RSS.Limit 999 }}
+    {{- $news_items = sort $news_items "PublishDate" "desc" | first $limit }}
+    <lastBuildDate>{{ (index $news_items 0).PublishDate.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>
+
+    {{- /* Render items. */}}
+    {{- range $news_items }}
+      <item>
+        <title>{{ .Title }}</title>
+        <link>{{ .Permalink }}</link>
+        <pubDate>{{ .PublishDate.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
+        <guid>{{ .Permalink }}</guid>
+        <description>{{ .Summary | transform.XMLEscape | safeHTML }}</description>
+      </item>
+    {{- end }}
+  </channel>
+</rss>
@@ -0,0 +1,23 @@
+{{/*
+Parses the serialized data from the given URL and returns a map or an array.
+
+Supports CSV, JSON, TOML, YAML, and XML.
+
+@param {string} . The URL from which to retrieve the serialized data.
+@returns {any}
+
+@example {{ partial "get-remote-data.html" "https://example.org/foo.json" }}
+*/}}
+
+{{ $url := . }}
+{{ $data := dict }}
+{{ with resources.GetRemote $url }}
+  {{ with .Err }}
+    {{ errorf "%s" . }}
+  {{ else }}
+    {{ $data = .Content | transform.Unmarshal }}
+  {{ end }}
+{{ else }}
+  {{ errorf "Unable to get remote resource %q" $url }}
+{{ end }}
+{{ return $data }}
@@ -27,9 +27,7 @@ button will be hidden if any of the following conditions is true:
      {{- warnf "This call to the %q shortcode should be removed: %s. The button is now hidden because the specified version (%s) is older than the display threshold." $.Name $.Position $version }}
    {{- end }}
  {{- else }}
-    <button class="bg-white hover:bg-gray-100 text-gray-800 font-semibold py-2 mr2 mt2 px-4 border border-gray-400 rounded shadow">
-      <a href="{{ printf "https://github.com/gohugoio/hugo/releases/tag/v%s" $version }}">New in v{{ $version }}</a>
-    </button>
+    <a class="dib f5 fw6 ba bw1 b--gray ph2 mt1" href="{{ printf "https://github.com/gohugoio/hugo/releases/tag/v%s" $version }}">New in v{{ $version }}</a>
  {{- end }}
 {{- else }}
  {{- errorf "The %q shortcode requires a positional parameter (version). See %s" .Name .Position }}
@@ -1 +1 @@
-# github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180
+# github.com/gohugoio/gohugoioTheme v0.0.0-20240426212330-f38e99e0d88d
@@ -2,4 +2,4 @@ module github.com/gohugoio/hugoDocs

 go 1.16

-require github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180 // indirect
+require github.com/gohugoio/gohugoioTheme v0.0.0-20240426212330-f38e99e0d88d // indirect
@@ -1,2 +1,2 @@
-github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180 h1:QMzk5J6Im/HG3ZeFfmy+cfn5XRZT5ZCbMGbLpcQKAfk=
-github.com/gohugoio/gohugoioTheme v0.0.0-20240302183348-b1860f349180/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=
+github.com/gohugoio/gohugoioTheme v0.0.0-20240426212330-f38e99e0d88d h1:EaFz80Aqh3Ej20VmUSNe3K+F0NbT8UueXLP/VqkK9Dw=
+github.com/gohugoio/gohugoioTheme v0.0.0-20240426212330-f38e99e0d88d/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=