darshanbaral / kitab

A hugo theme for publishing books

kitab theme

The kitab Theme is a simple theme meant for publishing books.

Demo

Click here for a live demo.

Installation

Inside the folder of your Hugo site run:

$ cd themes
$ git clone https://github.com/darshanbaral/kitab.git

For more information read the official setup guide of Hugo.

Getting started

After installing the kitab Theme successfully, modify the config.toml as you wish.

The config file

You'll find a file called config.toml. Copy the config.tomlto the root folder of your Hugo site and customize it per your need.

Adding books

• Create a folder inside the content folder for each book
• Add _index.md inside the folder for book with meta data such as book title, author, book cover image, and date.
• Create a new file for each chapter of the book.

Book Cover Images

The book cover image can be specified in the _index.md of the section folder. If the book cover image is big in size, a copy that is reduced in size can be specified as a thumbnail. See the _index.md in exampleSite for example.

kitab's Issues

Can I support the code snippet?

Include Book Cover on Homepage and a Book Description

Nice work with this theme, it was the only one that fit for a community site I have called Writing Buddies.

The only things missing from this theme are:

1. Book covers on the homepage, and/or
2. Book description.

I feel like there needs to be at least one or the other, both would be spectacular but if you decide not to I understand.

Still working on that one...

I uploaded book correctly and have seen books before I slept.
But on the next day, I find out the categories are there, but when check every single chapter, the page is showing "Still working on that one..."

Not having covers breaks site generation

If I attempt to create a _title.md file with the contents of:

+++ title = "Pride and Prejudice" author = "Jane Austen" date = "2019-05-12" weight = 3 bookCover = "bookCovers/pride_and_prejudice.jpg" +++

but I omit the book cover info (leaving me with)+++ title = "Pride and Prejudice" author = "Jane Austen" date = "2019-05-12" +++

I get the error EOF looking for end TOML front matter delimiter.

Is it possible to build without having the book cover info in the index? I don't have covers for any of my works, so that field isn't necessary.