digitalcraftsman / hugo-minimalist-theme Goto Github PK

Port of Raphael Riegger's Minimalistic Ghost theme to Hugo.

License: Apache License 2.0

HTML 35.49% CSS 62.02% JavaScript 2.49%

hugo hugo-theme static-site-generator blog-theme

hugo-minimalist-theme's Introduction

Minimalist

Minimalist is a responsive theme with a focus on blogging based on the Minimalistic Ghost theme made by Raphael Riegger.

Noteworthy features of this Hugo theme are the integration of a comment-system powered by Disqus, easy localization (l10n), support for RSS feeds, syntax highlighting for source code and sharing options in the blog posts.

Please note that this theme is no longer maintained.

Preview & Installation

Preview

The theme ships with an exampleSite folder that acts as a demo setup. cd into this folder an start the Hugo:

git clone https://github.com/digitalcraftsman/hugo-minimalist-theme.git
cd hugo-minimalist-theme/exampleSite
hugo server

Now enter localhost:1313 in the address bar of your browser.

Installation

If you want to use this theme for an actual website create a new Hugo project and clone the theme:

cd themes
git clone https://github.com/digitalcraftsman/hugo-minimalist-theme.git

Note: make sure to remove themesDir = "../.." from the top of your config file if you copied it from exampleSite/config.toml. Otherwise, Hugo will be unable to find the theme.

For more information read the official setup guide of Hugo.

The Config File

Take a look inside the exampleSite folder of this theme. You'll find a file called config.toml.

To use it, copy the config.toml to the root folder of your Hugo site. Play around with the settings to tweak your site as you like.

Localization (l10n)

Localization allows you to easily translate all strings in our website. Within exampleSite/data you'll find a file called l10n.toml. If you're not blogging in English replace all strings with their equivalents of your preferred language.

Contributing

Did you find a bug or have an idea for a new feature? Feel free to use the issue tracker to let me know. Or create a pull request. Please create a seperate branch for your pull request.

License

This theme is released under the Apache License 2.0. For more information read the License.

Acknowledgements

Thanks to

Raphael Riegger for creating the original theme
Steve Francia for creating Hugo and the awesome community around the project

hugo-minimalist-theme's People

Contributors

Stargazers

Watchers

hugo-minimalist-theme's Issues

About, Licence and other type of pages and a sidebar for newsletter

I'm new to hugo so maybe it's just my fault that I don't figure out how to add the "about", "licence" and other pages in the footer like a lot of other sites do. I uploaded an example image. In the example image instead of "about" and "licence" there are "STARTUP LESSON", "VENTURE CAPITAL", "ENTREPENEURSHIP", "UPFRONT VENTURES".

Also a sidebar with the form to be completed to sign up to the newsletter under the author image would be a great feature.
Thank for the theme, it look really great!

RFE for adding menu and a nav bar in the theme

Hi,

I recently migrated to Hugo from my Pelican blog. I loved this theme a lot , and would love to customize it more for my blog. I am a newbie programmer , and I am not aware so as to how one should start implementing the ideas in to the projects they want to work upon and contribute.
Please guide me so that I can make my contribution to this lovely theme and an amazing project!!

Regards,
Ganesh

Errors on site without expected parameters set

Hello!

$subj, when trying to run this theme against my blog source I get following (and site won't render at all):

Building sites … ERROR 2018/03/20 16:00:55 Error while rendering "page" in "": template: theme/_default/single.html:1:3: executing "theme/_default/single.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "page" in "post/": template: theme/_default/single.html:1:3: executing "theme/_default/single.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "taxonomy" in "": template: theme/_default/list.html:1:3: executing "theme/_default/list.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "home" in "": template: theme/index.html:1:3: executing "theme/index.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "taxonomyTerm" in "": template: theme/_default/terms.html:1:3: executing "theme/_default/terms.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "section" in "": template: theme/_default/list.html:1:3: executing "theme/_default/list.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0
ERROR 2018/03/20 16:00:55 Error while rendering "404" in "": template: theme/404.html:1:3: executing "theme/404.html" at <partial "header" .>: error calling partial: template: theme/partials/header.html:24:60: executing "theme/partials/header.html" at <absURL>: wrong number of args for absURL: want 1 got 0

The reason is likely some absent .Site. parameter but you can't tell it from error message, I guess input parameters handling could be improved.