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