From bff5aa0b1ecb147b75bc06c1f3c5dcfc18f9fd2e Mon Sep 17 00:00:00 2001
From: Gabriele Musco <gabmus@disroot.org>
Date: Sun, 18 Apr 2021 10:50:02 +0200
Subject: [PATCH] added general meta tags for seo; added some article params to
 readme

---
 README.md                                 |  9 +++++++++
 layouts/partials/head.html                |  7 ++++---
 layouts/partials/head_meta_opengraph.html | 15 ++++++++++++---
 layouts/partials/head_meta_seo.html       | 15 +++++++++++++++
 4 files changed, 40 insertions(+), 6 deletions(-)
 create mode 100644 layouts/partials/head_meta_seo.html

diff --git a/README.md b/README.md
index fde0b92..429fc89 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,8 @@ summaryLength = 70  # number of words for article summaries
 
 [params]
     author = "Gabriele Musco"
+    description = "A description for my website"  # this will be added as metadata
+
     logo = "/images/mylogo.png"
     favicon = "/images/myfavicon.png"
     showTags = true  # show the Tags menu item; default true
@@ -166,6 +168,13 @@ Following is an example configuration:
       link: https://gitlab.gnome.org/gabmus
 ```
 
+## Params supported in a post frontmatter
+
+| Param | Description |
+|-------|-------------|
+| `tags` | An array of tags, useful for searching similar articles |
+| `description` | A brief description of the post, useful for SEO optimization |
+| `featured` | Boolean, indicate if the post should be shown as featured |
 
 ## Inject custom content
 
diff --git a/layouts/partials/head.html b/layouts/partials/head.html
index 45271af..04e5450 100644
--- a/layouts/partials/head.html
+++ b/layouts/partials/head.html
@@ -4,9 +4,9 @@
             if (location.host != new URL("{{ .Site.BaseURL }}").host) location.href = "{{ .Site.BaseURL }}"
         </script>
     {{ end }}
-    <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
-    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=7">
+    <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0" />
+    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=7" />
 
     {{ if .OutputFormats.Get "RSS" }}
         {{ with .OutputFormats.Get "RSS" }}
@@ -28,5 +28,6 @@
     {{ $style := resources.Get "/scss/style.scss" | resources.ExecuteAsTemplate "/scss/style.scss" . | resources.ToCSS (dict "targetPath" "css/styles.css" "outputStyle" "compressed" "enableSourceMap" "true") | resources.Fingerprint "sha512" }}
     <link type=text/css rel=stylesheet href={{ $style.Permalink }} integrity="{{ $style.Data.Integrity }}" />
     {{- partial "inject/head.html" . -}}
+    {{- partial "head_meta_seo.html" . -}}
     {{- partial "head_meta_opengraph.html" . -}}
 </head>
diff --git a/layouts/partials/head_meta_opengraph.html b/layouts/partials/head_meta_opengraph.html
index b8bd1bb..06b0b79 100644
--- a/layouts/partials/head_meta_opengraph.html
+++ b/layouts/partials/head_meta_opengraph.html
@@ -9,18 +9,27 @@
     <meta
         property="article:published_time"
         content='{{ .Date.Format "2006-01-02T15:04:05Z-0700" }}' />
-    {{ range .Params.tags }}
-        <meta property="article:tag" content="{{ . }}" />
+    {{ if .Params.tags }}
+        {{ range .Params.tags }}
+            <meta property="article:tag" content="{{ . }}" />
+        {{ end }}
     {{ end }}
     <meta property="og:url" content="{{ .Permalink }}" />
     <meta property="og:image"
         content='{{ if .Params.Image }}{{ .Params.Image | absURL }}
         {{ else }}{{ .Site.Params.Logo | default "/img/icon.svg" | absURL }}
     {{ end }}' />
-    <meta property="og:description" content="{{ .Summary }}" />
+    {{ if .Params.description }}
+        <meta property="og:description" content="{{ .Params.description }}" />
+    {{ else }}
+        <meta property="og:description" content="{{ substr .Summary 20 }}" />
+    {{ end }}
 {{ else }}
     <meta property="og:title"
         content='{{ .Site.Title | default "Ficurinia" }}' />
+    {{ if .Site.Params.description }}
+        <meta name="og:description" content="{{ .Site.Params.description }}" />
+    {{ end }}
     <meta property="og:type" content="blog" />
     <meta property="og:image"
         content='{{ .Site.Params.Logo | default "/img/icon.svg" | absURL }}' />
diff --git a/layouts/partials/head_meta_seo.html b/layouts/partials/head_meta_seo.html
new file mode 100644
index 0000000..3780fab
--- /dev/null
+++ b/layouts/partials/head_meta_seo.html
@@ -0,0 +1,15 @@
+<meta name="author" content="{{ .Site.Params.Author }}" />
+{{ if .IsPage }}
+    {{ if .Params.tags }}
+        <meta name="keywords" content='{{ delimit .Params.tags ", "}}' />
+    {{ end }}
+    {{ if .Params.description }}
+        <meta name="description" content="{{ .Params.description }}" />
+    {{ else }}
+        <meta name="description" content="{{ substr .Summary 20 }}" />
+    {{ end }}
+{{ else }}
+    {{ if .Site.Params.description }}
+        <meta name="description" content="{{ .Site.Params.description }}" />
+    {{ end }}
+{{ end }}