Adds a minimal amount of CSS on top of SK1, uses no JavaScript
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.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Provides card lists, collapsible table of contents, horizontal menus, and horizontal pagination
Supports subtitles, summaries, a copyright start year, and Git modification dates
Configures mainSections, startdate, subtitle, summary, and toc through Params in config.toml
Includes a default favicon that can be overridden or disabled in the site root
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.
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
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
Set theme = "sk2" in config.toml, and configure mainSections, startdate, subtitle, summary, and toc under Params as needed
- 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
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
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
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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
https://github.com/J-Siu/hugo-theme-sk2/blob/master/LICENSEhttps://github.com/J-Siu/hugo-theme-sk2/blob/master/README.mdPermission is hereby granted, free of charge
Original License Text
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) [](https://www.paypal.com/donate/?business=HZF49NM9D35SJ&no_recurring=0¤cy_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.
Explore similar templates
Compare previews and descriptions within the same stack and category.

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
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 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 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
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 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
