Ok-ish Blog Hugo Theme

An ok-ish blog theme based on Vanilla. The theme is responsive and supports multi-language mode, multi-author posts, and many more. It's suitable for all types of blog posts.

Getting Started

I assume that you already have a Hugo site project. If not, you can create one by following Quick Start.

To use the theme, add it to your site's theme directory:

git submodule add https://github.com/kongdivin/hugo-theme-okayish-blog.git themes/hugo-theme-okayish-blog

Then tell Hugo to use hugo-theme-okayish-blog by adding/updating the following in config.toml

theme = "hugo-theme-okayish-blog"

Cloning an existing repository

If you have an existing repository that was setup with the steps above, you have to pull in the theme submodule after cloning your repository using the following command:

git submodule update --init


Head over to Content Managment to learn more how to manage your content.

Custom Home Page

The default homepage is showing the list of pages in the main sections. In case you want a custom homepage, you can create layouts/index.html. For example,

<!-- File: layouts/index.html -->

{{ define "main"}}
<h1>My New Home Page</h1>
{{ end }}

Since the theme is using Vanilla. You can use all its available components. See its docs for more details. Need inspirations? There you go, https://vanillaframework.io/showcase.

Custom Style

To provide a custom stylesheet, create layouts/partials/head-extension.html in your site directory to override the one the theme's created. Then put the link to your stylesheet in that file. For example,

<!-- File: layouts/partials/head-extension.html -->

<link href={{ "css/custom.css" | absURL }} rel="stylesheet"><link>

<link href="https://fonts.googleapis.com/css?family=Hanuman:400,700|Inconsolata|Roboto:400,400i,700,700i&display=swap&subset=khmer" rel="stylesheet"><link>

N.B. The theme includes fonts here. You might want to copy the <link> over; otherwise, the fonts will be default to Vanilla's default fonts (Ubuntu font).