Skip to content

evalica/risherry

Repository files navigation

Version Release Data

Risherry is designed as a customizable personal website.

It's build using Bootstrap, Handlebars and JQuery frameworks. Additionally it uses Sass, Font Awesome and Google Fonts.

Quick Start

If you want to customize locally the sources you will need Node.js and Grunt.

It's using Grunt plugins like watch, sass, concat, cssmin, uglify. The plugins are installed and managed via npm, 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. Depending on your configuration there might be changes between the master and the ghpages branches.