HugoStarter

hugo-theme-sk2 — Hugo Starter Template

By J-Siu

Hugo Theme - SK2 is a Hugo theme for teaching demonstrations. It adds a minimal amount of CSS on top of SK1, uses no JavaScript, and provides basic features such as card lists, collapsible table of contents, horizontal menus, and pagination.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

Adds a minimal amount of CSS on top of SK1, uses no JavaScript

02

Provides card lists, collapsible table of contents, horizontal menus, and horizontal pagination

03

Supports subtitles, summaries, a copyright start year, and Git modification dates

04

Configures mainSections, startdate, subtitle, summary, and toc through Params in config.toml

05

Includes a default favicon that can be overridden or disabled in the site root

06

MIT licensed, allowing free use, modification, commercial use, and distribution

Template Details

hugo-theme-sk2 is the second in author John Siu's SK series of themes, positioned for demonstration and teaching purposes. It builds on hugo-theme-sk1, with the difference being the addition of a minimal amount of CSS while still using no JavaScript. The theme provides page elements such as card lists, a collapsible table of contents, horizontal menus, horizontal pagination, subtitles, summaries, a copyright start year, and Git modification dates.

The theme is configured through Params in config.toml, where parameters such as mainSections, startdate, subtitle, summary, and toc can be set. The repository includes a default favicon, which can be disabled by creating an empty static/favicon.ico in the site root, or replaced with your own icon.

To use it, clone it into themes/sk2 in a Hugo site directory or add it as a git submodule. The repository includes an example site, which can be fetched with git submodule update --recursive --init and then tested locally by running hugo server. The theme is MIT licensed, free to use, modify, use commercially, and distribute, but third-party assets such as demo images, fonts, and icons must be checked against their respective licenses.

HugoLauncher

Is it right for your project?

Use Cases

  • As an example project for learning Hugo theme structure and how it works
  • For building simple sites focused on text content that do not need JavaScript
  • As a starting point or reference when developing a custom Hugo theme
  • For testing Hugo configuration and rendering locally through the example site

Suitable For

  • Developers who want to understand the basic composition of a Hugo theme
  • Hugo users who need a lightweight, JavaScript-free theme
  • Users building sites for teaching or demonstration purposes
  • Users who accept minimal styling and prefer a simple page structure

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    In a Hugo site directory, run git clone https://github.com/J-Siu/hugo-theme-sk2 themes/sk2, or add it with git submodule add

  2. 2

    Set theme = "sk2" in config.toml, and configure mainSections, startdate, subtitle, summary, and toc under Params as needed

  3. 3

    For local testing, clone the repository, run git submodule update --recursive --init to fetch the example site, then run hugo server in the exampleSite directory

  4. 4

    The default favicon can be disabled by creating an empty static/favicon.ico in the site root, or replaced with your own icon file

  5. 5

    Third-party assets such as demo images, fonts, and icons must be checked against their respective licenses; the code's MIT license alone is not sufficient to determine this

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This listing covers the free version in the public repository under the MIT license; the free scope applies to that version's code and does not mean external services or third-party assets are free.

Must comply with when using

  • The code of this version may be used, modified, used commercially, and distributed free of charge.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; the code's MIT license alone is not sufficient to determine this.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis

Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
Hugo Themes
Documentation and maintenance reference score
More documented · 79 / 100
Technologies
Hugo
Website type
Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-05-19
Screenshot last checked
2026-10-03

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: [email protected] · 2026-10-04

Inspect the recorded source material

SHA-256: 5debd13f3c07134b9c6b8c243b4acbec3942d625d9896c4fb15c460f1d0c3c8b

2026-10-03T23:46:26.349Z

Source file / repository
# Hugo Theme - SK2 (Skeleton 2) [![Paypal donate](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/donate/?business=HZF49NM9D35SJ&no_recurring=0&currency_code=CAD)

Demo/Tutorial Hugo theme. Fully functional with minimum css, no javascript, build on top of [hugo-theme-sk1](https://github.com/J-Siu/hugo-theme-sk1).

---

### Table Of Content

<!-- TOC -->

- [SK Themes](#sk-themes)
- [Demo](#demo)
- [Usage](#usage)
- [Testing](#testing)
- [Features](#features)
- [Site Config](#site-config)
- [Default Favicon](#default-favicon)
- [Contributors](#contributors)
- [Change Log](#change-log)
- [License](#license)
<!-- /TOC -->

### SK Themes

| Theme | GitHub                                              | Hugo                                      | Demo                            | Description                                                   |
| ----- | --------------------------------------------------- | ----------------------------------------- | ------------------------------- | ------------------------------------------------------------- |
| SK1   | [hugo-theme-sk1](//github.com/J-Siu/hugo-theme-sk1) | [SK1](//themes.gohugo.io/hugo-theme-sk1/) | [sk1.jsiu.dev](//sk1.jsiu.dev/) | Fully functional basic Hugo theme with no css, no javascript. |
| SK2   | [hugo-theme-sk2](//github.com/J-Siu/hugo-theme-sk2) | [SK2](//themes.gohugo.io/hugo-theme-sk2/) | [sk2.jsiu.dev](//sk2.jsiu.dev/) | Fully functional basic Hugo theme with minimum css.           |
| SK3   | [hugo-theme-sk3](//github.com/J-Siu/hugo-theme-sk3) | [SK3](//themes.gohugo.io/hugo-theme-sk3/) | [sk3.jsiu.dev](//sk3.jsiu.dev/) | Full feature Hugo theme with Google AdSense support.          |

### Demo

SK2 demo site: https://sk2.jsiu.dev/ with content from [hugoBasicExample](https://github.com/J-Siu/hugoBasicExample).

### Usage

- Clone

  In site directory:

  ```sh
  git clone https://github.com/J-Siu/hugo-theme-sk2 themes/sk2
  ```

- Submodule

  In site directory:

  ```sh
  git submodule add https://github.com/J-Siu/hugo-theme-sk2 themes/sk2
  ```

### Testing

```sh
git clone https://github.com/J-Siu/hugo-theme-sk2 sk2
cd sk2

# Pull example site.
git submodule update --recursive --init

cd exampleSite
hugo server -D --bind :: \
--config config.toml,../config.demo.toml \
--disableFastRender \
--renderToMemory \
--theme sk2 \
--themesDir ../../
```

### Features

- [x] Card list
- [x] Collapsible table of content
- [x] Copyright start year
- [x] Git modify date
- [x] Horizontal menu
- [x] Horizontal pagination
- [x] Minimum css
- [x] Sub-title
- [x] Summary

### Site Config

`config.demo.toml`

```toml
baseURL = "https://sk2.jsiu.dev"
theme   = "sk2"
title   = "SK2"

[Params]
mainSections = "post"
startdate = "2012-12-02"
subtitle = "A Hugo Theme"
summary = true
toc = true
```

### Default Favicon

SK themes come with default favicon.

Disable default favicon:

```sh
# At Hugo site root
touch static/favicon.ico
```

Override default favicon:

```sh
# At Hugo site root
cp <your favicon.ico> static/favicon.ico
```

### Contributors

- [John Sing Dao Siu](https://github.com/J-Siu)

### Change Log

- [CHANGELOG.md](CHANGELOG.md)

### License

The MIT License (MIT)

Copyright (c) 2025 John Siu

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-xmin

hugo-xmin

hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.

Hugo · Starter

hugo-theme-gallery

hugo-theme-gallery

A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.

Hugo · Starter

reveal-hugo

reveal-hugo

reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.

Hugo · Starter

anatole

anatole

Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.

Hugo · Starter

hugo-theme-diary

hugo-theme-diary

A Hugo diary-style theme ported from the Hexo theme Journal, with a grid homepage for essays and daily notes. It supports six languages, dark mode, table-of-contents scroll positioning, reading time, code highlighting, and configurable sidebar, fonts, and colors.

Hugo · Starter

risotto

risotto

risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.

Hugo · Starter