shadow53 / darkroad

Responsive, simple, clean and content-focused Hugo theme based on the MH Magazine lite WordPress theme - Dark version

Mainroad

Mainroad is a responsive, simple, clean and content-focused Hugo theme based on the MH Magazine lite WordPress theme by MH Themes.

Alternate Demo (Best) | Standart Demo

Adaptation has several changes:

• Include Hugo internal templates (Open Graph, Disqus, Google Analytics)
• New responsive menu without jQuery
• SVG icons instead of font icons
• Theme options are saved (Sidebar position, Author Box, Post Navigation) and available through config.toml file parameters
• Other small changes

Installation

In your Hugo site themes directory, run:

$ git clone https://github.com/vimux/mainroad

Next, open config.toml in the base of the Hugo site and ensure the theme option is set to mainroad:

theme = "mainroad"

For more information read the official setup guide of Hugo.

Configuration

Example config.toml

baseurl = "/"
title = "Mainroad"
languageCode = "en-us"
paginate = "10" # Number of posts per page
theme = "mainroad"
disqusShortname = "" # Enable comments by entering your Disqus shortname
googleAnalytics = "" # Enable Google Analytics by entering your tracking id


[Author]
    name = "John Doe"
    bio = "John Doe's true identity is unknown. Maybe he is a successful blogger or writer. Nobody knows it."
    avatar = "img/avatar.png"


[Params]
    subtitle = "Just another site" # Subtitle of your site
    description = " John Doe's Personal blog about everything" # Description of your site
    opengraph = true
    leftsidebar = false # Move sidebar to the left side if true
    authorbox = true
    post_navigation = true


[Params.widgets]
    search = true # Enable "Search" widget
    recent_articles = true # Enable "Recent arcticles" widget
    categories = true # Enable "Categories" widget
    tags = true # Enable "Tags" widget

TODO

• Delete unused CSS
• No ID in CSS
• Responsive menu without jQuery
• Delete unused JS
• i18n support (Internationalization)
• Detailed documentation (?)
• Social media widget (?)
• Enhanced version of recent posts widget (?)
• Tabbed widget (?)

Contributing

Have you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.

License

This theme is released under the GPLv2 license (inherited from the original MH Magazine lite WordPress theme).

darkroad's Issues

Investigate responsive nav without javascript

Some tutorials for CSS dropdown navs here:
http://candpgeneration.com/toys/CSS3-dropdown-tut.php
https://www.justsoftwaresolutions.co.uk/articles/css_menus.html
http://blog.teamtreehouse.com/create-an-absolute-basic-mobile-css-responsive-navigation-menu

And a library: http://css3menu.com/

The big issue would be making it work in mobile view as well as desktop view.

Add basic search bar to replace Google search

I'd like users of the theme to be able to choose which search engine to use for searching their site. Perhaps hard-coding particular values ("google" "bing" "ddg" "etc") and having an option to include a custom query string?

Also, this may be worth trying out: https://www.algolia.com/pricing