hugo-geekblog/README.md

36 lines
2.3 KiB
Markdown
Raw Normal View History

2020-09-12 16:04:41 +00:00
# Geekblog
2020-06-27 21:07:52 +00:00
[![Build Status](https://img.shields.io/drone/build/xoxys/hugo-geekblog?logo=drone)](https://cloud.drone.io/xoxys/hugo-geekblog)
[![Hugo Version](https://img.shields.io/badge/hugo-0.65-blue.svg)](https://gohugo.io)
[![GitHub release](https://img.shields.io/github/v/release/xoxys/hugo-geekblog)](https://github.com/xoxys/hugo-geekblog/releases/latest)
2020-09-12 16:04:41 +00:00
[![GitHub contributors](https://img.shields.io/github/contributors/xoxys/hugo-geekblog)](https://github.com/xoxys/hugo-geekblog/graphs/contributors)
[![License: MIT](https://img.shields.io/github/license/xoxys/hugo-geekblog)](https://github.com/xoxys/hugo-geekblog/blob/master/LICENSE)
2020-06-27 21:07:52 +00:00
2020-09-12 16:04:41 +00:00
Geekblog is a simple Hugo theme for personal blogs. It is intentionally designed as a fast and lean theme and may not fit the requirements for more complex websites. 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://hugo-geekblog.geekdocs.de](https://hugo-geekblog.geekdocs.de).
2020-06-27 21:07:52 +00:00
2020-09-12 16:53:25 +00:00
![Desktop and mobile preview](https://github.com/xoxys/hugo-geekblog/blob/master/images/readme.png)
2020-09-12 16:04:41 +00:00
## Build and release process
2020-08-01 18:18:20 +00:00
2020-09-12 16:04:41 +00:00
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](https://gulpjs.com/) and bundled in a release tarball. You can download the latest release from the GitHub [release page](https://github.com/xoxys/hugo-geekblog/releases).
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.
```Shell
# install required packages from package.json
npm install
# run gulp pipeline to build required assets
gulp default
```
2020-06-27 21:07:52 +00:00
2020-09-12 16:04:41 +00:00
See the [Getting Started Guide](https://hugo-geekblog.geekdocs.de/posts/getting-started/) for details about the different setup options.
2020-06-27 21:07:52 +00:00
2020-09-12 16:04:41 +00:00
## Contributors
Special thanks goes to all [contributors](https://github.com/xoxys/hugo-geekblog/graphs/contributors).
## License
2020-06-27 21:07:52 +00:00
2020-09-12 16:04:41 +00:00
This project is licensed under the MIT License - see the [LICENSE](https://github.com/xoxys/hugo-geekblog/blob/master/LICENSE) file for details.