left is a hugo theme forked from KeepIt (which is based on LeaveIt).
take a quick look here
this theme has lots of enhancement on LeaveIt, e.g.
- auto dark mode (unfortunately we don't have manual option now)
- mathjax support
- better code highlighting (auto change light/dark based on the theme!)
- article heading anchors
- etc.
be sure to add
[markup] [markup.highlight] codeFences = false
to your config file or you will get an annoying code block
if you want use mathjax, please add
mathjax = true
both to your site config file and your article file frontmatters.(the example is toml code, use yaml or json based on your own config file/article frontmatters)
repl.it is a pretty cool programming platform, also it provide a "embed code" share. Since hugo had disabled raw html by default from v0.60, so i write a shortcode to share repl code.
usage:
{{< repl "username/repl-name" >}}
you could find your repl's "username/repl-name" from the address bar, be caution that the username don't inculde the @ symbol.
an example config file is like this:
baseURL = "https://blog.example.com/" languageCode = "zh-cn" title = "example blog" theme = "left" hasCJKLanguage = true # if your lang is not Chinese, Japanese or Korean, pls comment this line paginate = 12 enableEmoji = true enableRobotsTXT = true googleAnalytics = "" disqusShortname = "yourdiscussshortname" cfWebAnalyticsToken = "" [sitemap] changefreq = "monthly" filename = "sitemap.xml" priority = 0.5 [Permalinks] posts = "/posts/:year/:filename/" # disable condeFences to use theme code highlight # or this will give u an annoying code block background color [markup] [markup.highlight] codeFences = false [menu] [[menu.main]] name = "Posts" url = "/posts/" weight = 1 [[menu.main]] name = "Tags" url = "/tags/" weight = 3 [[menu.main]] name = "About" url = "/about" weight = 4 [[menu.main]] name = "RSS" url = "/atom.xml" weight = 5 [params] since = 2020 author = "batkiz" # Author's name subtitle = "" home_mode = "" # post or other mathjax = true google_verification = "" bing_verification = "" yandex_verification = "" pinterest_verification = "" baidu_verification = "" avatar = "" #comment it to use gravatar socialShare = false description = "" # site description keywords = "" # site keywords license= '如无特殊声明,本博客文章均以 <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/" target="_blank">CC BY-NC-SA 4.0</a> 协议发布' [params.gravatar] #email = "example@gmail.com" #uncomment and insert your email address to use gravatar [params.social] #GitHub = "xxxx" #Linkedin = "xxxx" #Twitter = "xxxx" #Instagram = "xxxx" #Email = "i@xxxx.com" #Facebook = "xxxx" #Telegram = "xxxx" #Medium = "xxxx" #Gitlab = "xxxx" #Youtubelegacy = "xxxx" #Youtubecustom = "xxxx" #Youtubechannel = "xxxx" #Tumblr ="xxxx" #Quora = "xxxx" #Keybase = "xxxx" #Pinterest = "xxxx" #Reddit = "xxxx" #Codepen = "xxxx" #Bitbucket = "xxxx" #Stackoverflow = "xxxxx" #Weibo = "xxxx" #Odnoklassniki = "xxxx" #VKontakte = "xxxx" #Flickr = "xxxx" #Xing = "xxxx" #Snapchat = "xxxx" #Soundcloud = "xxxx" #Spotify = "xxxx" #Bandcamp = "xxxx" #Paypal = "xxxx" #Fivehundredpx = "xxxx" #Mix = "xxxx" #Goodreads = "xxxx" #Lastfm = "xxxx" #Foursquare = "xxxx" #Hackernews = "xxxx" #Kickstarter = "xxxx" #Patreon = "xxxx" #Steam = "xxxx" #Twitch = "xxxx" #Strava = "xxxx" #Skype = "xxxx" #Whatsapp = "xxxx" #Zhihu = "xxxx" #Douban = "xxxx" #Angellist = "xxxx" #Slidershare = "xxxx" #Jsfiddle = "xxxx" #Deviantart = "xxxx" #Behance = "xxxx" #Dribble = "xxxx" #Wordpress = "xxxx" #Vine = "xxxx" #Googlescholar = "xxxx" #Researchgate = "xxxx" #Mastodon = "xxxx" #Thingiverse = "xxxx" [params.share] #Twitter = true #Facebook = true #Reddit = true #Linkedin = true #Pinterest = true #HackerNews = true #Mix = true #Tumblr = true #VKontakte = true #Douban = true #Weibo = true # for RSS copyright = "This work is licensed under a Creative Commons Attribution-NonCommercial 4.0 International License." defaultContentLanguage = "en" [outputs] home = [ "Atom", "HTML" ] [outputFormats.Atom] mediatype = "application/rss" baseName = "atom" [author] name = "xxxx" [params.publisher] name = "xxxx" [params.publisher.logo] url = "logo.png" width = 127 height = 40 [params.logo] url = "logo.png" width = 127 height = 40 [params.image] url = "cover.png" width = 800 height = 600 # comments [params.gitalk] owner = "" # Your GitHub ID repo = "" # The repo to store comments clientId = "" # Your client ID clientSecret = "" # Your client secret [params.valine] enable = false appId = 'your appId' appKey = 'your appKey' notify = false # mail notifier , https://github.com/xCss/Valine/wiki verify = false # Verification code avatar = 'mm' placeholder = 'your comments ...' visitor = true [params.utterances] # https://utteranc.es/ owner = "" # Your GitHub ID repo = "" # The repo to store comments [params.gitment] # Gitment is a comment system based on GitHub issues. see https://github.com/imsun/gitment owner = "" # Your GitHub ID repo = "" # The repo to store comments clientId = "" # Your client ID clientSecret = "" # Your client secret