https://github.com/evalica/risherry
Customizable personal website built with Bootstrap, Handlebars and Sass
https://github.com/evalica/risherry
css handlebars personal-website sass
Last synced: 9 months ago
JSON representation
Customizable personal website built with Bootstrap, Handlebars and Sass
- Host: GitHub
- URL: https://github.com/evalica/risherry
- Owner: evalica
- License: mit
- Created: 2014-12-06T15:44:59.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-08-21T17:43:33.000Z (over 1 year ago)
- Last Synced: 2025-04-28T11:20:04.811Z (9 months ago)
- Topics: css, handlebars, personal-website, sass
- Language: HTML
- Homepage: http://risherry.ro/
- Size: 11.7 MB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# [risherry](http://risherry.ro/)
[](https://github.com/evalica/risherry/releases) [](https://github.com/evalica/risherry/releases)
Risherry is designed as a customizable personal website.
It's build using [Bootstrap](http://getbootstrap.com/), [Handlebars](http://handlebarsjs.com/) and [JQuery](https://jquery.com/) frameworks. Additionally it uses [Sass](http://sass-lang.com/), [Font Awesome](http://fortawesome.github.io/Font-Awesome/) and [Google Fonts](http://www.google.com/fonts).
## Quick Start
If you want to customize locally the sources you will need [Node.js](https://nodejs.org/) and [Grunt](http://gruntjs.com/).
It's using Grunt plugins like [watch](https://www.npmjs.com/package/grunt-contrib-watch), [sass](https://www.npmjs.com/package/grunt-contrib-sass), [concat](https://www.npmjs.com/package/grunt-contrib-concat), [cssmin](https://www.npmjs.com/package/grunt-contrib-cssmin), [uglify](https://www.npmjs.com/package/grunt-contrib-uglify). The plugins are installed and managed via [npm](https://npmjs.org/), the Node.js package manager.
#### `npm install`
After everything is set up, you can run the `swatch` task that builds all the available themes at once. Themes can be build also one at a time by using `grunt swatch:[theme]`, for example `grunt swatch:rain`.
#### `grunt swatch`
You should run the tasks on the `src/sass` files and commit the results in the `dist` folder.
#### `grunt watch`
Launching the `watch` task that will start a process that listens to file changes and compiles and minifies the CSS and JavaScript sources.
## Customizing
### Content
The content it's easily customizable since it reads the data from JSON.
```
risherry/
├── src/
├── data/
│ ├── config.json
│ ├── content.json
├── js/
└── sass/
```
### Themes
By default, there are default available themes.
Each of these themes have a `custom.scss` and a `variables.scss` file, that contain the theme's definition. New themes can be created and used.
```
risherry/
├── src/
├── data/
├── js/
└── sass/
├── skin/
├── style.scss
└── themes/
└── default/
├── custom.scss
└── variables.scss
```
Version `0.2.0` provides the `Bliss`, `Bordo`, `Rain` and `Moss` themes:
## Testing
Test your changes using a [local web server](https://stackoverflow.com/a/21608670/444320). Depending on your configuration there might be changes between the `master` and the `ghpages` branches.