/r-hugo-theme

A simple Hugo theme suitable for a portfolio, documentation library, or blog.

Primary LanguageCSSMIT LicenseMIT

r-hugo-theme

A simple Hugo theme suitable for a portfolio, documentation library, or blog. See r-hugo-theme-demo.

r-hugo-theme-desktop-light

r-hugo-theme-mobile-darkr-hugo-theme-mobile-light

Key features

  • Responsive layout for desktops, tablets, mobile, and print
  • A switch that controls light and dark modes
  • Extensive, automatically generated site navigation that includes:
    • Section navigation (in this section)
    • Page navigation (on this page)
    • Breadcrumbs
    • Links to next and previous pages
    • Related links based on keywords
  • Easily customizable contact info in the footer
  • Blogging capabilities:
    • Categories
    • Tags
    • Estimated reading time

Quick start

Set up a simple website that uses r-hug-theme with sample content.

Prerequisites

Procedure

  1. In the terminal, create a new site by entering hugo new site {site_name}
    Where: {site_name} is the name of the site that you want to create.
  2. Enter the Hugo site directory by entering cd {site_name}
  3. Initialize a Git repository by entering git init
  4. Add the theme by entering git submodule add https://rafalkaron.github.io/r-hugo-theme
  5. Move the files and folders from the example-site or example-site-multilingual directory into the root folder of your site.
  6. Run a local Hugo webserver by entering hugo server

Postrequisites

Theme customization

You can further customize the site by editing the config.yaml file. For more information, see the Hugo documentation.