add configurable meta-tags

README.md

@@ -67,3 +67,42 @@ hugo server
 ```
 
 Now enter [`localhost:1313`](http://localhost:1313) in the address bar of your browser.
+
+# Configuring theme features
+
+### Homepage meta tags
+
+Often a homepage requires special meta tags such as a meta description or og meta data for twitter, facebook etc. You can configure these values in the `config.toml`
+
+```
+// config.toml
+[params]
+  google_analytics_id=""
+
+  [params.homepage_meta_tags]
+    meta_description = "a description of your website."
+    meta_og_title = "My Theme"
+    meta_og_type = "website"
+    meta_og_url = "https://www.mywebsite.com"
+    meta_og_image = "https://www.mywebsite.com/images/tn.png"
+    meta_og_description = "a description of your website."
+    meta_twitter_card = "summary"
+    meta_twitter_site = "@mytwitterhandle"
+    meta_twitter_creator = "@mytwitterhandle"
+```
+
+### Set meta tags on a per template/page basis
+
+You can set meta tags on a per template basis using a block. For example, you might want to write a custom meta description for the `/services` page. You can insert any valid HTML meta data inside the `{{ define "meta_tags }}` block at the top of a template.
+
+```
+// layouts/services/list.html
+...
+
+{{ define "meta_tags" }}
+    <meta name="description" content="We offer a variety of services in the finance industry" />
+{{ end }}
+
+{{ define main }}
+...
+```

exampleSite/config.toml

@@ -5,7 +5,18 @@ themesDir = "../.."
 theme = "hugo-serif-theme"
 
 [params]
-    google_analytics_id=""
+  google_analytics_id=""
+
+  [params.homepage_meta_tags]
+    meta_description = "Serif is a beautiful small business theme for Hugo (Static Site Generator). It contains content types for the archetypical small business website. The theme is fully responsive, blazing fast and artfully illustrated."
+    meta_og_title = "Hugo Serif Theme"
+    meta_og_type = "website"
+    meta_og_url = "https://hugo-serif.netlify.com"
+    meta_og_image = "https://raw.githubusercontent.com/JugglerX/hugo-serif-theme/master/images/tn.png"
+    meta_og_description = "Serif is a beautiful small business theme for Hugo (Static Site Generator). It contains content types for the archetypical small business website. The theme is fully responsive, blazing fast and artfully illustrated."
+    meta_twitter_card = "summary"
+    meta_twitter_site = "@zerostaticio"
+    meta_twitter_creator = "@zerostaticio"
 
 [[menu.main]]
 	name = "Services"

exampleSite/resources/_gen/assets/scss/scss/style.scss_7c5b0bc187eba1f0fa872b04866c7835.json

@@ -1 +1 @@
-{"Target":"css/style.min.d10d2f6c383f9abe07dcfa1800a72f582ff39c51785787b0e731f6401c43bc99.css","MediaType":"text/css","Data":{"Integrity":"sha256-0Q0vbDg/mr4H3PoYAKcvWC/znFF4V4ew5zH2QBxDvJk="}}
+{"Target":"css/style.min.86ae9969a9d827177d9bc22b206a6cbba9411c96e8a2e3b65dbe509613edb11f.css","MediaType":"text/css","Data":{"Integrity":"sha256-hq6ZaanYJxd9m8IrIGpsu6lBHJboouO2Xb5QlhPtsR8="}}

exampleSite/resources/_gen/assets/scss/scss/style.scss_cf66e63debe6917c04534d6c7b66f623.json

@@ -1 +1 @@
-{"Target":"css/style.min.5ff9ab1c2a7b76b6cdc181aef5b639d8fad30127381226dd2b1af203e4a91743.css","MediaType":"text/css","Data":{"Integrity":"sha256-X/mrHCp7drbNwYGu9bY52PrTASc4EibdKxryA+SpF0M="}}
+{"Target":"css/style.min.66d2a2d57ed39ba1b6d523fef1f7b51c4c3825c5a7c299e4df07ea49e5ff92a1.css","MediaType":"text/css","Data":{"Integrity":"sha256-ZtKi1X7Tm6G21SP+8fe1HEw4JcWnwpnk3wfqSeX/kqE="}}

layouts/_default/baseof.html

@@ -6,7 +6,7 @@
   <meta http-equiv="x-ua-compatible" content="ie=edge">
   <title>{{ block "title" . }}{{ .Title }} - {{ .Site.Title }}{{ end }}</title>
   <meta name="viewport" content="width=device-width, initial-scale=1">
-  {{ block "meta" . }}{{end}}
+  {{ block "meta_tags" . }}{{end}}
   <link rel="icon" href="{{ .Site.BaseURL }}favicon.png">
 
   <!-- CSS -->

layouts/index.html

@@ -2,7 +2,6 @@
 {{ define "header_css" }}{{ end }}
 {{ define "body_classes" }}page-home{{ end }}
 {{ define "header_classes" }}header-transparent{{ end }}
-{{ define "meta"}}<meta name="description" content="Live demo of the Hugo Serif Theme">{{ end }}
 
 {{ define "main" }}