Skip to content
This repository has been archived by the owner on Dec 28, 2023. It is now read-only.

wildtechgarden/wild-theme-shell-mod-hugo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

'Wild' theme shell for Hugo by Wild Tech 'Garden'

Description: The Hugo shell (wrapper) module for themes by Wild Tech 'Garden' (WTG)
Site: https://www.wild-theme-shell.wtg-demos.ca/
Repository: https://github.com/wildtechgarden/wild-theme-shell-mod-hugo
CI Status: pre-commit.ci status build-audit

Contents

  1. Contents
  2. Features
    1. Designed for extensibility
    2. Minimal theme in its own right
    3. Classless or classful CSS supported
    4. Comes with sample 'responsive' vanilla CSS
  3. Usage
    1. Basic (as theme)
      1. Hugo module (preferred)
      2. With git submodule (unsupported by theme author)
    2. Configuration
    3. Extension (the hooks)
      1. The base (skeleton)
  4. Development
  5. Colophon

Features

Designed for extensibility

Primarily designed as a skeleton with 'hooks' to be supplied by the consumer of this shell (e.g. can be site-specific or used by a theme that extends the shell).

See Extension (the hooks), below.

Minimal theme in its own right

The skeleton has defaults for the 'hooks' that are sufficient to allow you to use this project as a minimal theme for websites.

See Usage, below.

Classless or classful CSS supported

The HTML in the skeleton defaults to no classes on the elements by default, but accepts parameters to override this behaviour (often can be site-wide or per-page, or site-wide with page overrides, as you choose).

Comes with sample 'responsive' vanilla CSS

  1. Defaults to mobile menu as header until on larger screens
  2. Includes a selection of starter colour schemes
  3. Includes styles for reasonable printed output

Usage

Basic (as theme)

Hugo module (preferred)

  1. Initialize the Hugo module system: hugo mod init github.com/<your_user>/<your_project>; (assuming you are using GitHub, of course).

  2. Import the theme in your hugo.toml

    [module]
    [[module.imports]]
    path = "github.com/wildtechgarden/wild-theme-shell-mod-hugo"
  3. Get the module

    hugo mod get github.com/wildtechgarden/wild-theme-shell-mod-hugo
  4. To test the result, run the local Hugo server

    hugo server -b http://localhost:1313/

With git submodule (unsupported by theme author)

  1. Make a themes directory and switch to it.

    mkdir themes
    cd themes
  2. In the themes directory, add wild-theme-shell-mod-hugo as a submodule

    git submodule add -f https://github.com/wildtechgarden/wild-theme-shell-mod-hugo.git
  3. Change back to the site directory

  4. To test the result, run the local Hugo server

    hugo server -t wild-theme-shell-mod-hugo -b http://localhost:1313/

Enjoy!

Configuration

Extension (the hooks)

The base (skeleton)

See skeleton documentation

Development


Colophon

Copyright © 2023 Wild Tech 'Garden'
Released under an MIT License