Your next documentation theme...
Build a simple, modular but customizable technical documentation.
Build the website without using node/npm or any external frameworks(CSS, JS, icon, font).
Demo
Responsive and adaptive layouts.
Built-in light and dark modes.
Customizable sidebars using Hugo data templates.
Support for multiple documentation sets.
Implement a menu via Hugo configs.
Integrate search or AI assistant.
Install Hugo.
Use prebuilt binaries via https://github.com/gohugoio/hugo/releases/latest
Verify the installation via hugo version
Create a new Hugo site with the E25DX theme.
add newsite/content/en/docs/_overview.md
for overview
---title: Overviewurl: "docs/overview"aliases: - "/docs"---
add newsite/content/en/docs/a1.hello-world.md
as the first page of first section
---title: Hello Worldslug: hello-world---
add newsite/content/en/docs/b1.modules.md
as the first page of second section
---title: Modulesslug: modules---
add newsite/data/en/docs/sidebar.yml
for section titles and page titles
- title: Documentation pages:- title: Overview- title: Basics pages:- title: Hello World- title: Beyond The Basics pages:- title: Modules
newsite/hugo.yaml
newsite/static/sw.js
newsite/static/manifest.json
languages: en:title and en:description
params: project, author and home
cacheName prefix: ex. todo-
name, short_name, description
Foundation
hugo new site newsitecd newsite git init git submodule add https://github.com/dumindu/E25DX.git themes/E25DX rm hugo.toml && cp themes/E25DX/hugo.yaml .cp themes/E25DX/static/sw.js ./static/ cp themes/E25DX/static/manifest.json ./static/
We don't need generated
archetypes
,assets
,i18n
,layouts
folders in thenewsite
folder
Configuration
Sample content and sidebar
Run hugo server
Change
newsite/hugo.yaml
->enableGitInfo: false
, if you want to runhugo server
before commit the changes.