From 4b2192f2fa89f10d09fabc48105465865ef01943 Mon Sep 17 00:00:00 2001 From: Track3 Date: Mon, 31 Dec 2018 20:03:32 +0800 Subject: [PATCH] Use `images` instead of `featuredImg` `featuredImg` and `bgImg` are preserved in case you want to use a different background image from metadata images --- README.md | 2 +- archetypes/posts.md | 4 ++-- exampleSite/config.toml | 23 ++++++++++++++----- .../content/posts/post-with-featured-image.md | 12 +++++++--- layouts/index.html | 8 +++++-- layouts/posts/single.html | 8 +++++-- 6 files changed, 41 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 6a6151d..4604bd1 100644 --- a/README.md +++ b/README.md @@ -101,7 +101,7 @@ You can reference as many stylesheets as you want. Their paths need to be relati #### Code injection -You can inject any html code to every page's document head or right above the closing body tag. This makes it easier to add any html meta data, custom css/js, dns-prefetch etc. To do this you simplely need to creat a file at site's `layouts/partials/extra-head.html` or `layouts/partials/extra-foot.html`, code inside will be injected to every page. +You can inject any html code to every page's document head or right above the closing body tag. This makes it easier to add any html meta data, custom css/js, dns-prefetch etc. To do this you simply need to create a file at site's `layouts/partials/extra-head.html` or `layouts/partials/extra-foot.html`, code inside will be injected to every page. ## Acknowledgments diff --git a/archetypes/posts.md b/archetypes/posts.md index 099f5bb..fe05261 100644 --- a/archetypes/posts.md +++ b/archetypes/posts.md @@ -3,8 +3,8 @@ title: "{{ replace .Name "-" " " | title }}" date: {{ .Date }} draft: true toc: false -featuredImg: "" +images: tags: - - tag + - untagged --- diff --git a/exampleSite/config.toml b/exampleSite/config.toml index 10eb6e0..efc4f98 100644 --- a/exampleSite/config.toml +++ b/exampleSite/config.toml @@ -6,7 +6,7 @@ theme = "hermit" # enableGitInfo = true pygmentsCodefences = true pygmentsUseClasses = true -hasCJKLanguage = true # If there're Chinese/Japanese/Korean Languages in the content, enable this. +# hasCJKLanguage = true # If Chinese/Japanese/Korean is your main content language, enable this to make wordCount works right. rssLimit = 10 # Maximum number of items in the RSS feed. copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." # This message is only used by the RSS template. enableEmoji = true # Shorthand emojis in content files - https://gohugo.io/functions/emojify/ @@ -29,13 +29,24 @@ enableEmoji = true # Shorthand emojis in content files - https://gohugo.io/func dateformNum = "2006-01-02" dateformNumTime = "2006-01-02 15:04 -0700" - # themeColor = "#494f5c" # Theme color in meta tags. + # Metadata mostly used in document's head + # description = "" + # images = [""] + themeColor = "#494f5c" + homeSubtitle = "A minimal and fast theme for Hugo." footerCopyright = ' · CC BY-NC 4.0' - # gitUrl = "https://github.com/Someone/SomeRepo/commit/" # Prefix of link to the git commit detail page. GitInfo must be enabled. - justifyContent = false # Set "text-align: justify" to .content, requires extended version of Hugo - # bgImg = "" # Homepage background-image URL - # customCSS = ["css/foo.css", "css/bar.css"] # add custom css + # bgImg = "" # Homepage background-image URL + + # Prefix of link to the git commit detail page. GitInfo must be enabled. + # gitUrl = "https://github.com/username/repository/commit/" + + # Toggle this option need to rebuild SCSS, requires extended version of Hugo + justifyContent = false # Set "text-align: justify" to .content. + + # Add custom css + # customCSS = ["css/foo.css", "css/bar.css"] + # Social Icons # Check https://github.com/Track3/hermit#social-icons for more info. [[params.social]] diff --git a/exampleSite/content/posts/post-with-featured-image.md b/exampleSite/content/posts/post-with-featured-image.md index cde54fb..c42ff5c 100644 --- a/exampleSite/content/posts/post-with-featured-image.md +++ b/exampleSite/content/posts/post-with-featured-image.md @@ -2,7 +2,8 @@ title: "Post With Featured Image" date: 2018-10-01T16:15:09+08:00 draft: false -featuredImg: "https://picsum.photos/1024/768/?random" +images: + - https://picsum.photos/1024/768/?random tags: - Demo - Image @@ -13,5 +14,10 @@ Just define the image URL in the content’s front matter, the featured image wi For example: ```yaml -featuredImg: "https://picsum.photos/1024/768/?random" -``` \ No newline at end of file +--- +images: + - https://picsum.photos/1024/768/?random +--- +``` + +This is an array, you can set multiple urls, only the first url will be used. These images is also used in [Twitter Cards](https://developer.twitter.com/en/docs/tweets/optimize-with-cards/guides/getting-started.html) and the [Open Graph](http://ogp.me/) metadata. diff --git a/layouts/index.html b/layouts/index.html index c9047e5..8a2f798 100644 --- a/layouts/index.html +++ b/layouts/index.html @@ -1,6 +1,10 @@ {{ define "main" }} - {{- with .Site.Params.bgImg }} -
+ {{- if .Site.Params.bgImg }} +
+ {{- else if .Site.Params.images }} + {{- range first 1 .Site.Params.images }} +
+ {{- end }} {{- end }}
diff --git a/layouts/posts/single.html b/layouts/posts/single.html index 224995e..026a626 100644 --- a/layouts/posts/single.html +++ b/layouts/posts/single.html @@ -3,9 +3,13 @@ {{ end }} {{ define "main" }} - {{- with .Params.featuredImg }} + {{- if .Params.featuredImg }} +
+ {{- else if .Params.images }} + {{- range first 1 .Params.images }}
{{- end }} + {{- end }}
@@ -51,7 +55,7 @@ {{- end }}
- {{ partial "comments.html" . }} + {{- partial "comments.html" . -}}
{{ end }}