Skip to content

TanishkThoria/Hugo-Programmer

Repository files navigation

Hugo-Programmer

Github Commits
MIT License Badge

A sleek and minimal theme for Hugo, an efficient and easy to use tool for creating websites.
This theme is a modified version of the Hugo Coder theme.

Example Site

Can't decide if you like it or not? You can find a live demo of this theme.
If you like what you see or are looking for what to do next, you can find the source code of this demo.

Starting from scratch

If you are are starting a new website from scratch, there are a couple commands you will have to do before you can add the theme.

  1. First, we will need to create a new site with hugo.
hugo new site quickstart
  1. Now, we will need to navigate into the new site that we just created.
cd quickstart
  1. Next, we will initialize an empty git repository.
git init

Now you can continue with the next steps in the adding the theme portion

Adding the Theme

  1. This theme should be added as a submodule in your themes directory:
git submodule add https://github.com/TanishkThoria/Hugo-Programmer.git themes/Hugo-Programmer

  1. Edit your config.toml file to match the new theme. You can do this by:
  • Simply adding theme = "Hugo-Programmer" at the top of the file and then adding other parameters seperately.

  • Or by copying this baseline configuration and filling it out.
    This is the recommended option due to being mostly filled out

  • Or by copying and editing the example website.
    Note that some of the images in the example website may not load properly in your website due to them being relative links. This could be fixed by either locally downloading the same images or adding https://tanishkthoria.netlify.app/ in front of all relative links.

  1. You should be good to go! To display the current version of the website including drafts*, execute the following command:
hugo server -D

or just hugo server if you do not want to display drafts (This is how the website would look like if published).

The resulting site will be displayed at http://localhost:1313/

*drafts of blog posts


Modifications

Wonder what is different from the original Hugo-Coder theme?

This theme:

  • Supports custom images for socials (non-Font Awesome)
  • Added socials to footer
  • More attractive blog posts page
    • Supports image thumbnails
    • Categorizations shown when in list-view
    • Descriptions shown when in list-view
    • Tags shown when in list-view

Currenly working on:

  • Modifying the posts page

Need help?

Documentation can be found under the docs folder.

Feature requests and issues can be reported through Github's Issues

Further questions can be email to me at tanishkthoria@gmail.com


Licensing

This theme, as well as the theme is forked from, is licensed under the MIT License


Have a great day :)