A simple theme for bloggers.
Most of the styles for this theme come from taniarascia.com
I like it's style, so I transplant it to Hugo.
And is that why this theme called Tania.
Thank Tania Rascia again.
It's necessary to use Hugo ≥ 0.78.0.
Use Hugo Extended version (recommended) if you want to:
- Use the latest feature/fix from main branch
- Edit SCSS files
- Responsive and Mobile-Friendly
- Dark mode(It can switch automatically or manually)
- Footnotes(Float on the right side)
- Search with categories filter
In your site's root dir
git submodule add https://github.com/WingLim/hugo-tania themes/hugo-tania
Edit your site config following exampleSite/config.yaml.
You can custom header and footer menu.
menu:
header:
- name: Articles
url: "/articles/"
footer:
- name: RSS
url: "/index.xml"
There are a few configuration options that you can add to your config.yaml
file.
You can also see the toml
example in exampleSite/config.example.toml
Notice: if you want use disqus as comment system in this theme, you need to set disqusShortname
in config
root and comments
in params
.
params:
# Emoji will show before the blog title on site navbar.
titleEmoji: '😎'
# Logo will show before the blog title on site navbar.
titleLogo:
# Enable float footnotes.
# Default to true
enableFootnotes: true
# Limit how many categories filter show above search input.
# Default to 5
maxCategoryToShow: 10
# Show your socail information with icon on index bio with `_index.md` content.
socialOptions:
dev-to:
email:
facebook:
github:
instagram:
linkedin:
medium:
stack-overflow:
steam:
telegram:
twitter:
twitch:
whatsapp:
# Addtional option for meta SEO
siteName:
siteDesc:
author:
# Comments settings
comments:
enable: true
provider: disqus
archives
layout is for showing all articles you write.
Add articles.md
to site content
dir, and write as below:
If you want to show it on site header, see #Menu
---
title: Articles
subtitle: Posts, tutorials, snippets, musings, and everything else.
date: 2020-11-26
type: section
layout: "archives"
---
For enable math formula render, add katex: true
or mathjax: true
in your article head, like:
Notice: You should enable only one katex
or mathjax
in a same time.
---
title: Title
katex: true
---
Some content...
- hugo-theme-stack for dark mode switch
- hugo-prose for float footnotes