• Stars
    star
    416
  • Rank 104,068 (Top 3 %)
  • Language
    HTML
  • License
    MIT License
  • Created over 5 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Clean and minimal personal blog theme for Hugo

Ezhil

Clean and minimal personal blog and portfolio theme for Hugo.

Demo

View demo

Screenshot Screenshot

Features

  • Clean and minimal
  • Dark mode (Auto detect from OS)
  • Responsive
  • Supports tags
  • Social media links
  • Google Analytics integration
  • Syntax highlighting
  • Twitter cards and opengraph tags support
  • Disqus comments
  • Hugo RSS feeds
  • Custom CSS/JS

Installation

From your Hugo site run the following.

cd themes
git clone https://github.com/vividvilla/ezhil.git

For more information read the official setup guide of Hugo.

Configuration

baseURL = "http://example.org/"
languageCode = "en-us"
title = "My personal blog"
theme = "ezhil"

copyright = "© Copyright notice"

# Enable syntax highlighting.
pygmentsstyle = "solarized-dark"
pygmentscodefences = true
pygmentscodefencesguesssyntax = true

# Your Google analytics code.
googleAnalytics = "UA-123-45"
# Your Disqus sortname.
disqusShortname = "localhost"

# Number of posts to show in recent posts list (Optional). Defaults to 10.
paginate = 10

# Number of characters to show in summary.
summaryLength = 20

[params]
    # Blog subtitle which appears below blog title. Supports markdown.
    subtitle = "Clean and minimal personal [blog theme for Hugo](https://github.com/vividvilla/ezhil)"

    # Content types which are included in home page recent posts list.
    mainSections = ["posts"]

    # Content types which are excludes Disqus comments.
    disableDisqusTypes = ["page"]

    # If social media links are enabled then enable this to fetch icons from CDN instead of hosted on your site.
    featherIconsCDN = true

    # Specify favicon (icons/i.png maps to static/icons/i.png). No favicon if not defined.
    favicon = "icons/myicon.png"

    # Switch to dark mode or auto detect mode from OS (Optional).
    # "dark" will set mode to dark and "auto" will switch to dark mode if OS is in dark mode.
    mode = "dark" # "dark" or "auto"

    # Custom CSS added to default styles. Files added to `static` folder is copied as it is to
    # root by Hugo. For example if you have custom CSS file under `static/css/custom.css` then
    # you can specify custom css path as `css/custom.css`.
    customCSS = "css/custom.css"
    # Custom CSS added to dark mode style.
    customDarkCSS = "css/custom-dark.css"

    # Custom list of Javascript files to load. Just like custom CSS you can place js files under
    # `static/js` folder and specify path here as `js/script-name.js`. You can also specify full url,
    # for example you may want to include external JS library.
    customJS = ["js/abc.js", "js/xyz.js", "https://code.jquery.com/jquery-3.4.1.js"]

# Main menu which appears below site header.
[[menu.main]]
name = "Home"
url = "/"
weight = 1

[[menu.main]]
name = "All posts"
url = "/posts"
weight = 2

[[menu.main]]
name = "About"
url = "/about"
weight = 3

[[menu.main]]
name = "Tags"
url = "/tags"
weight = 4

# Social media links which shows up on site header.
# Uses feather icons for icons. You can [search icon names from here](https://feathericons.com/).
[[params.social]]
name = "Github"
icon = "github"
url = "https://github.com/vividvilla/ezhil"

[[params.social]]
name = "Twitter"
icon = "twitter"
url = "https://twitter.com/gohugoio"

# Enable tags.
[taxonomies]
   tag = "tags"

Content type

You can specify content type with field type in your content. For example static pages can be set as type page which are excluded from recent posts and all posts page. You can use site params mainSections and disableDisqusTypes to control which page types are excluded from recent posts and Disqus comments respectively.

---
title: "About"
date: 2019-04-19T21:37:58+05:30
type: "page"
---

This is some static page where you can write about yourself.

Disable Disqus

You can disable Disqus site wide if you don't set DisqusShortname param in config. You can also disable Disqus from contents selectively or for all contents with certain content type. Use content field disqus to disable Disqus from certain contents.

---
title: "Content without comments"
date: 2019-04-19T21:37:58+05:30
disqus: false
---

This is a content without Disqus comments.

You can also disable Disqus for certain content types by using site param disableDisqusTypes. You can check config section above for example.

Credits

More Repositories

1

csvtotable

Simple command-line utility to convert CSV files to searchable and sortable HTML table.
Python
1,109
star
2

lil

Simple URL shortener built with Go
Go
45
star
3

gotp

Simple utility to live preview Go templates with custom data
HTML
28
star
4

consul-cfg

Commandline utility to convert config formats like TOML, JSON, YAML etc to KV Pairs which can be imported via consul cli.
Go
14
star
5

NSE-Live-Market

Retrives data from NSE Live Market - http://nse-live-market.appspot.com/
Python
10
star
6

olaf

Static site generator based on Python/Flask
Python
10
star
7

hackerrank

Solutions to HackerRank problems.
C++
8
star
8

bankr

Full text search engine written in Go to find any bank details in India by IFSC, Name, Address etc.
JavaScript
7
star
9

gobak

Gobak - tool for rotating database backup archives.
Go
6
star
10

copyblogger

Clean and Professional Genesis 2 CHild Theme (HTML5 and CSS3)
CSS
5
star
11

flaq

flaq - Q&A
Python
3
star
12

Light-Weight-Blog

Simple Python(webapp2) based blogging engine
Python
2
star
13

sportsmeethub-frontend

JavaScript
2
star
14

justread

Tumblog Styled Free Genesis Child theme for WordPress.Design Inspired by Quora Blog.
PHP
2
star
15

divinewp

Clean, Minimal and Divine Genesis Child Theme
CSS
2
star
16

boiler-flask

Simple boiler plate for Flask test/sample apps.
Python
2
star
17

arduino-codes

Arduino Project Codes for project hosted in Techiestuffs electronics blog
Arduino
2
star
18

tuxresistor

Tux Resistor is an Interactive Electronics Tool which can be used to convert Resitor color bands to Resistor values and vice versa.
Java
2
star
19

vivekr.dev

Source for my blog
CSS
1
star