YinYang

YinYang is a black-white theme for Hugo.

Feature

minimalist
multi-language support
disqus support
SEO Optimization

Screenshot

Installation

From the root of your site:

git clone git@github.com:joway/hugo-theme-yinyang.git themes/yinyang

Change config.toml:

theme = "yinyang"

Configuration

Head Title

[params]
headTitle = "Joway Wang"

If there is no headTitle in params, use .Site.Params.Author.name.

Main section

Set your main section:

[params]
mainSections = ["posts"]

Multi-Language

[languages]
  [languages.en]
    contentDir = "content/en"
    languageName = "English"
    weight = 1
  [languages.cn]
    contentDir = "content/cn"
    languageName = "Chinese"
    weight = 2

Then your posts files should be put into content/en or content/cn.

Footer

[[params.socials]]
name = "About Me"
link = "https://joway.io"
[[params.socials]]
name = "Github"
link = "https://github.com/joway"

Extra Head

[params]
extraHead = '<script src="xxxx.js"></script>'

Extra CSS files

[params]
extraCSSFiles = ["css/foo.css", "css/bar.css"]

Twitter Cards

Add the following setting:

[params]
twitterCards = true

In a post's front matter, include a keyword images with a value of a list of URLs of images that will be used for Twitter Cards.

Insert content on every post

[params]
postHeaderContent = ""
postFooterContent = "<br/><br/><p>Subscribe：<a target='_blank' href='https://mailchi.mp/a1a0d59e7a19/joway'>Joway's Blog</a></p>"

Example

baseURL = "https://blog.joway.io/"
languageCode = "en-us"
title = "Joway's Blog"
theme = "yinyang"
DefaultContentLanguage = "cn"

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true
  [markup.highlight]
    guessSyntax = true
    noClasses = true
    style = "bw"
    tabWidth = 2

[author]
  name = "Joway"
  homepage = "https://joway.io/"

[languages]
  [languages.en]
    contentDir = "content/en"
    languageName = "English"
    weight = 1
  [languages.cn]
    contentDir = "content/cn"
    languageName = "Chinese"
    weight = 2

[params]
mainSections = ["posts"]
headTitle = "Joway Wang"
disqus = "joway" # disqus account name
extraHead = '<script async src="https://www.googletagmanager.com/gtag/js?id=UA-xxx"></script>'
[[params.socials]]
name = "About Me"
link = "https://joway.io"
[[params.socials]]
name = "Github"
link = "https://github.com/joway"
postHeaderContent = ""
postFooterContent = "<br/><br/><p>Subscribe to：<a target='_blank' href='https://mailchi.mp/a1a0d59e7a19/joway'>Joway's Blog</a></p>"
# extraCSSFiles = ["css/foo.css", "css/bar.css"]
extraCSSFiles = []

new posts

hugo new content/en/posts/my-first-post.md

smallnest/hugo-theme-yinyang