38d0786a8b
hash css/js assets by default |
||
---|---|---|
.github | ||
archetypes | ||
assets/js | ||
data | ||
exampleSite | ||
images | ||
layouts | ||
src | ||
static | ||
.dictionary | ||
.drone.yml | ||
.gitignore | ||
.jsbeautifyrc | ||
.lighthouserc.yml | ||
.markdownlint.yml | ||
.prettierignore | ||
.prettierrc | ||
.tarignore | ||
CHANGELOG.md | ||
gulpfile.js | ||
LICENSE | ||
package-lock.json | ||
package.json | ||
README.md | ||
renovate.json | ||
theme.toml |
Geekdoc
Geekdoc is a simple Hugo theme for documentations. It is intentionally designed as a fast and lean theme and may not fit the requirements of complex projects. If a more feature-complete theme is required there are a lot of got alternatives out there. You can find a demo and the full documentation at https://geekdocs.de.
Build and release process
This theme is subject to a CI driven build and release process common for software development. During the release build, all necessary assets are automatically built by gulp and bundled in a release tarball. You can download the latest release from the GitHub release page.
Due to the fact that gulp
is used as pre-processor the theme cannot be used from the master branch by default. If you want to use the theme from a cloned branch instead of a release tarball you'll need to install gulp
locally and run the default pipeline once to create all required assets.
# install required packages from package.json
npm install
# run gulp pipeline to build required assets
gulp default
See the Getting Started Guide for details about the different setup options.
Contributors
Special thanks goes to all contributors.
Geekdoc is inspired and partially based on the hugo-book theme, thanks Alex Shpak for your work.
License
This project is licensed under the MIT License - see the LICENSE file for details.