2020-09-12 16:34:39 -04:00
|
|
|
|
2020-08-23 02:55:34 -04:00
|
|
|
# Hugo Theme Stack
|
2020-09-12 07:33:36 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
> Card-style Hugo theme designed for bloggers.
|
2020-08-24 17:22:38 -04:00
|
|
|
|
2020-09-07 06:13:51 -04:00
|
|
|
## Demo
|
|
|
|
|
|
2020-09-08 17:49:06 -04:00
|
|
|
[Example Site](https://theme-stack.jimmycai.com/)
|
2020-09-07 06:13:51 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
[](https://app.netlify.com/sites/hugo-theme-stack/deploys)
|
|
|
|
|
|
2020-09-12 07:33:36 -04:00
|
|
|
## Documentation & more information
|
|
|
|
|
|
2020-12-04 11:38:14 -05:00
|
|
|
[Documentation](https://docs.stack.jimmycai.com/) | [中文文档](https://docs.stack.jimmycai.com/v/zh-cn/)
|
2020-09-12 07:33:36 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
## Introduction
|
2020-09-07 06:13:51 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
Stack is a simple card-style Hugo theme designed for bloggers, some of its features are:
|
2020-09-07 06:13:51 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
- Responsive images support
|
|
|
|
|
- Lazy load images
|
|
|
|
|
- Dark mode
|
|
|
|
|
- [PhotoSwipe](https://photoswipe.com/) integration
|
|
|
|
|
- Archive page template
|
|
|
|
|
- Full native JavaScript, no jQuery or any other frameworks are used
|
|
|
|
|
- No CSS framework, keep it simple and minimal
|
|
|
|
|
- External dependencies (like PhotoSwipe's library) are being loaded selectively, or asynchronously
|
|
|
|
|
- Properly cropped thumbnails
|
2020-08-23 02:55:34 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
The only JavaScript library being used is [node-vibrant](https://github.com/Vibrant-Colors/node-vibrant) for generating colour schemes for articles.
|
2020-08-23 02:55:34 -04:00
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
2020-09-13 06:16:43 -04:00
|
|
|
This theme uses SCSS and TypeScript. For that reason, it's necessary to use **Hugo ≥ 0.74.0**.
|
|
|
|
|
|
2020-10-10 03:50:28 -04:00
|
|
|
Use Hugo Extended version if you want to:
|
|
|
|
|
|
|
|
|
|
* Use the latest feature/fix from `master` branch
|
|
|
|
|
* Edit SCSS files
|
|
|
|
|
|
|
|
|
|
**Compiled CSS are updated once per release.**
|
2020-08-23 02:55:34 -04:00
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
Clone / Download this repository to `theme` folder, and edit your site config following `exampleSite/config.toml`.
|
|
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
Check [documentation](https://www.notion.so/jimmycai/Hugo-Theme-Stack-511aec5b9ed845ce9b6e3ae0bf7fb6d4) for more details.
|
|
|
|
|
|
2020-08-23 02:55:34 -04:00
|
|
|
## Copyright
|
|
|
|
|
|
2020-09-07 06:13:51 -04:00
|
|
|
**Licensed under the GNU General Public License v3.0**
|
|
|
|
|
|
|
|
|
|
Please do not remove the "*Theme Stack designed by Jimmy*" text and link.
|
|
|
|
|
|
2020-09-12 16:34:39 -04:00
|
|
|
If you want to port this theme to another blogging platform, please let me know🙏.
|
|
|
|
|
|
2020-10-04 18:32:57 -04:00
|
|
|
## Sponsoring
|
|
|
|
|
|
|
|
|
|
If you like this theme, consider supporting its development:
|
|
|
|
|
|
2020-12-23 07:20:53 -05:00
|
|
|
[](https://ko-fi.com/C0C530AXX)
|
2020-10-04 18:32:57 -04:00
|
|
|
|
|
|
|
|
Your support is greatly appreciated :)
|
|
|
|
|
|
2020-09-07 06:13:51 -04:00
|
|
|
## Thanks to
|
2020-08-23 02:55:34 -04:00
|
|
|
|
|
|
|
|
- [Vibrant-Colors/node-vibrant](https://github.com/Vibrant-Colors/node-vibrant)
|
|
|
|
|
- [Normalize.css](https://necolas.github.io/normalize.css/)
|
|
|
|
|
- [Tabler icons](https://tablericons.com/)
|
|
|
|
|
- [Pure CSS implementation of Google Photos / 500px image layout](https://github.com/xieranmaya/blog/issues/6)
|
2020-09-07 06:13:51 -04:00
|
|
|
- [jonsuh/hamburgers](https://github.com/jonsuh/hamburgers)
|
|
|
|
|
- [PhotoSwipe](https://photoswipe.com/)
|
2020-08-23 02:55:34 -04:00
|
|
|
- [artchen/hexo-theme-element](https://github.com/artchen/hexo-theme-element)
|
2020-09-06 15:04:51 -04:00
|
|
|
- [MunifTanjim/minimo](https://github.com/MunifTanjim/minimo)
|
2020-09-09 07:23:18 -04:00
|
|
|
- [lepture/yue.css](https://github.com/lepture/yue.css)
|
2020-10-04 18:32:57 -04:00
|
|
|
- Markdown gallery syntax from [Typlog](https://typlog.com/)
|
