1
0
Fork 0
hswro_org/README.md

95 lines
3.2 KiB
Markdown
Executable File

# Jekyll Serif Theme
Serif is a modern business theme for Jekyll. It contains multiple content types for a typical business website. The theme is fully responsive, blazing fast and artfully illustrated.
[Live Demo](https://jekyll-serif.netlify.app/) |
[Zerostatic Themes](https://www.zerostatic.io)
![Jekyll Serif Theme screenshot](https://www.zerostatic.io/theme/jekyll-serif/jekyll-serif-screenshot.png)
### Theme features
- Jekyll 4.1
- Services (Collection)
- Team (Collection)
- Features (Data)
- SCSS
- Responsive design
- Bootstrap 4.3 grid and media queries only
- Responsive menu
- 100/100 Google Lighthouse speed score
- 100/100 Google Lighthouse seo score
- 100/100 Google Lighthouse accessibility score
- 100/100 Google Lighthouse best practices score
- Under 50KB without images or 80KB with images and illustrations ⚡
- Under 20KB without Google fonts ⚡⚡⚡
- Robust example content included
- Royalty free illustrations included
- Netlify & Github Pages ready
## Installation
### Installing Ruby & Jekyll
If this is your first time using Jekyll, please follow the [Jekyll docs](https://jekyllrb.com/docs/installation/) and make sure your local environment (including Ruby) is setup correctly.
### Installing Theme
Download or clone the theme.
To run the theme locally, navigate to the theme directory and run:
```
bundle install
```
To start the Jekyll local development server.
```
bundle exec jekyll serve
```
To build the theme.
```
bundle exec jekyll build
```
## Deployment
### Stackbit
Use Stackbit to deploy this theme. This theme contains a valid and tested `stackbit.yaml`
[![Create with Stackbit](https://assets.stackbit.com/badge/create-with-stackbit.svg)](https://app.stackbit.com/create?theme=https://github.com/zerostaticthemes/jekyll-serif-theme)
### Netlify
Use Netlify to deploy this theme. This theme contains a valid and tested `netlify.toml` - Feel free to use the 1-click deploy below.
[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/zerostaticthemes/jekyll-serif-theme)
### Github Pages
This theme has been tested to work with Github Pages (and Github Project Pages). When using Github Pages you will need to update the `baseurl` in the `_config.yml` otherwise all the css, images and paths will be broken.
For example the site https://zerostaticthemes.github.io/jekyll-serif-theme would have `baseurl: "/jekyll-serif-theme/"`
## License & Credits
### Credits
- Beautiful royalty free Illustrations by Icons8 - https://icons8.com/illustrations/style--pixeltrue
- Stock images by Unsplash - https://unsplash.com/
- Feature icons by Noun Project - https://thenounproject.com/
### License
This theme is open source under the MIT license. Please be respectful 🙏🏽 Leave me as an original author in the LICENSE file if you fork or copy this theme.
> Do not create ports of this theme. Do You can't re-distribute or re-sell this theme as a theme, stock, in a tool or as a template.
### Other Versions
- [Hugo Serif Theme](https://github.com/zerostaticthemes/hugo-serif-theme) (official)
- [Gatsby Serif Theme](https://github.com/zerostaticthemes/gatsby-serif-theme) (official)