Skip to content

22940dev/hugo-tania

Repository files navigation

Hugo Theme Tania

Netlify Status

A simple theme for bloggers.

Demo

Example Site

Introduction

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.

Requirements

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

Features

  • Responsive and Mobile-Friendly
  • Dark mode(It can switch automatically or manually)
  • Footnotes(Float on the right side)
  • Search with categories filter

Installation

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.

Configuration

Menu

You can custom header and footer menu.

menu:
  header:
    - name: Articles
      url: "/articles/"
  footer:
    - name: RSS
      url: "/index.xml"

Site Configuration

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

Layout

Archives

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"
---

Article Params

Enable math formula render

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...

Thanks to

License

MIT