From a48a6fa2dd47f4d52a96187785a1147050306b87 Mon Sep 17 00:00:00 2001
From: Guillaume Rivier <rivierg@gmail.com>
Date: Wed, 10 Jul 2024 22:57:24 +0900
Subject: [PATCH] Site.Author is deprecated, use Params.author instead (#481)

* Site.Author is deprecated, use Params.author instead

* Update footer.html

* Update footer.html

* Update footer.html

* Update footer.html

* Update footer.html

* Update footer.html

* Update footer.html

* Update ci.yml

* Update ci.yml

* Update footer.html

* Update ci.yml

* Update ci.yml

---------

Co-authored-by: Henry Schreiner <HenrySchreinerIII@gmail.com>
---
 .github/workflows/ci.yml                     | 13 +++++++------
 exampleSite/hugo.toml                        |  2 +-
 layouts/partials/footer.html                 | 19 +++++++++++--------
 layouts/partials/head.html                   |  2 +-
 layouts/partials/post_meta.html              |  2 +-
 layouts/partials/seo/structured/article.html |  2 +-
 layouts/partials/seo/structured/post.html    |  4 ++--
 layouts/partials/seo/twitter.html            |  2 +-
 layouts/partials/share-links.html            |  2 +-
 9 files changed, 26 insertions(+), 22 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6c35640b..118a4259 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -37,12 +37,13 @@ jobs:
           # For maximum backward compatibility with Hugo modules
           HUGO_ENVIRONMENT: production
           HUGO_ENV: production
-        run: |
-          hugo \
-            --minify \
-            --baseURL "${{ steps.pages.outputs.base_url }}/" \
-            -s "./exampleSite/" \
-            --themesDir "../../"
+        run: >
+          hugo
+          --minify
+          --baseURL "${{ steps.pages.outputs.base_url }}/"
+          -s "./exampleSite/"
+          --themesDir "../../"
+          --logLevel info
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v2
         with:
diff --git a/exampleSite/hugo.toml b/exampleSite/hugo.toml
index f0d8e264..4744a0e7 100644
--- a/exampleSite/hugo.toml
+++ b/exampleSite/hugo.toml
@@ -47,7 +47,7 @@ pygmentsCodefencesGuessSyntax = true
 #  src = "img/hexagon.jpg"
 #  desc = "Hexagon"
 
-[Author]
+[Params.author]
   # Set only your "username" for default hosts and full URLs otherwise (e.g., "https://MyGitLab.org/username")
   name = "Some Person"
   website = "yourwebsite.com"
diff --git a/layouts/partials/footer.html b/layouts/partials/footer.html
index 74994a67..ead747de 100644
--- a/layouts/partials/footer.html
+++ b/layouts/partials/footer.html
@@ -1,6 +1,9 @@
   {{ if eq .Type "page" }}
     {{ partial "page_meta.html" . }}
   {{ end }}
+  {{- if and (not (isset .Site.Params "author")) (isset .Site "author") -}}
+     {{ errorf "Please move [author] to [params.author]; Hugo has deprecated the former." }}
+  {{- end -}}
 <footer>
   <div class="container">
     {{ if .Site.Params.disclaimerText }}
@@ -14,12 +17,12 @@
       <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
         <ul class="list-inline text-center footer-links">
           {{ range .Site.Data.beautifulhugo.social.social_icons }}
-            {{- if isset $.Site.Author .id }}
+            {{- if isset $.Site.Params.author .id }}
               <li>
-		{{ if or ( hasPrefix ( index $.Site.Author .id ) "http://" ) ( hasPrefix ( index $.Site.Author .id ) "https://" ) }}
-		  <a {{ if .rel }}rel="{{ .rel }}"{{- end -}} href="{{ printf "%s" (index $.Site.Author .id) }}" title="{{ .title }}">
+		{{ if or ( hasPrefix ( index $.Site.Params.author .id ) "http://" ) ( hasPrefix ( index $.Site.Params.author .id ) "https://" ) }}
+		  <a {{ if .rel }}rel="{{ .rel }}"{{- end -}} href="{{ printf "%s" (index $.Site.Params.author .id) }}" title="{{ .title }}">
 		{{ else }}
-		  <a {{ if .rel }}rel="{{ .rel }}"{{- end -}} href="{{ printf .url (index $.Site.Author .id) }}" title="{{ .title }}">
+		  <a {{ if .rel }}rel="{{ .rel }}"{{- end -}} href="{{ printf .url (index $.Site.Params.author .id) }}" title="{{ .title }}">
 		{{ end }}
                   <span class="fa-stack fa-lg">
                     <i class="fas fa-circle fa-stack-2x"></i>
@@ -41,11 +44,11 @@
           {{ end }}
         </ul>
         <p class="credits copyright text-muted">
-          {{ if .Site.Author.name }}
-            {{ if .Site.Author.website }}
-              <a href="{{ .Site.Author.website }}">{{ .Site.Author.name }}</a>
+          {{ if .Site.Params.author.name }}
+            {{ if .Site.Params.author.website }}
+              <a href="{{ .Site.Params.author.website }}">{{ .Site.Params.author.name }}</a>
             {{ else }}
-              {{ .Site.Author.name }}
+              {{ .Site.Params.author.name }}
             {{ end }}
           {{ end }}
 
diff --git a/layouts/partials/head.html b/layouts/partials/head.html
index 8c4de22b..d33412dd 100644
--- a/layouts/partials/head.html
+++ b/layouts/partials/head.html
@@ -42,7 +42,7 @@
 {{- with ($.Scratch.Get "Description") }}
   <meta name="description" content="{{ . }}">
 {{- end }}
-{{- with .Site.Author.name }}
+{{- with .Site.Params.author.name }}
   <meta name="author" content="{{ . }}"/>
 {{- end }}
 {{- partial "seo/main.html" . }}  
diff --git a/layouts/partials/post_meta.html b/layouts/partials/post_meta.html
index 34f21f68..8009edb4 100644
--- a/layouts/partials/post_meta.html
+++ b/layouts/partials/post_meta.html
@@ -21,7 +21,7 @@
         &nbsp;|&nbsp;<i class="fas fa-user"></i>&nbsp;{{ .Params.author | safeHTML }}
       {{ end }}
     {{ else }}
-      &nbsp;|&nbsp;<i class="fas fa-user"></i>&nbsp;{{ .Site.Author.name | safeHTML }}
+      &nbsp;|&nbsp;<i class="fas fa-user"></i>&nbsp;{{ .Site.Params.author.name | safeHTML }}
     {{ end }}
   {{ end }}
   {{- if .Site.Params.staticman -}}
diff --git a/layouts/partials/seo/structured/article.html b/layouts/partials/seo/structured/article.html
index c92284ea..25226d2a 100644
--- a/layouts/partials/seo/structured/article.html
+++ b/layouts/partials/seo/structured/article.html
@@ -3,7 +3,7 @@
   "@context": "http://schema.org",
   "@type": "Article",
   "author": {
-    "name" : "{{ if .Params.author -}}{{ .Params.author }}{{- else if .Site.Author.name -}}{{ .Site.Author.name }}{{- end }}"
+    "name" : "{{ if .Params.author -}}{{ .Params.author }}{{- else if .Site.Params.author.name -}}{{ .Site.Params.author.name }}{{- end }}"
   },
   "headline": "{{ .Title }}",
   "description" : "{{ if .Description }}{{ .Description | plainify }}{{ else }}{{if .IsPage}}{{ .Summary | plainify  }}{{ end }}{{ end }}",
diff --git a/layouts/partials/seo/structured/post.html b/layouts/partials/seo/structured/post.html
index f1a10dab..f7831bd4 100644
--- a/layouts/partials/seo/structured/post.html
+++ b/layouts/partials/seo/structured/post.html
@@ -15,10 +15,10 @@
       "@type": "Person",
       "name": "{{ .Params.author }}"
   },
-  {{- else if .Site.Author.name -}}
+  {{- else if .Site.Params.author.name -}}
     "author": {
       "@type": "Person",
-      "name": "{{ .Site.Author.name }}"
+      "name": "{{ .Site.Params.author.name }}"
   },
   {{- end }}
   "copyrightYear" : "{{ .Site.Params.since }} - {{ .Site.LastChange.Format "2006" }}",
diff --git a/layouts/partials/seo/twitter.html b/layouts/partials/seo/twitter.html
index 5f133178..31b69167 100644
--- a/layouts/partials/seo/twitter.html
+++ b/layouts/partials/seo/twitter.html
@@ -8,7 +8,7 @@
   <meta name="twitter:image" content="{{ . | absURL }}" />
 {{- end }}
   <meta name="twitter:card" content="summary_large_image" />
-{{- with .Site.Author.twitter }}
+{{- with .Site.Params.author.twitter }}
   <meta name="twitter:site" content="@{{ . }}" />
   <meta name="twitter:creator" content="@{{ . }}" />
 {{- end }}
\ No newline at end of file
diff --git a/layouts/partials/share-links.html b/layouts/partials/share-links.html
index 78fe91bc..44cd2daf 100644
--- a/layouts/partials/share-links.html
+++ b/layouts/partials/share-links.html
@@ -4,7 +4,7 @@
     <ul class="share">
       <!-- Twitter -->
       <li>
-        <a href="//twitter.com/share?url={{ .Permalink }}&amp;text={{ .Title }}&amp;via={{ .Site.Author.twitter }}" target="_blank" title="Share on Twitter">
+        <a href="//twitter.com/share?url={{ .Permalink }}&amp;text={{ .Title }}&amp;via={{ .Site.Params.author.twitter }}" target="_blank" title="Share on Twitter">
           <i class="fab fa-twitter"></i>
         </a>
       </li>