peruna/README.md

98 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Pickles [![Build Status](https://travis-ci.org/mismith0227/hugo_theme_pickles.svg?branch=master)](https://travis-ci.org/mismith0227/hugo_theme_pickles) [![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/mismith0227/hugo_theme_pickles/blob/master/license.md) [![Standard - JavaScript Style Guide](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard)
Pickles is a modern, simple and beautiful Hugo theme.
![screenshot](https://github.com/mismith0227/hugo_theme_pickles/blob/master/images/screenshot.png)
## Overview
* Modern, Simple and beautiful design
* Medium's Image Zoom[zoom.js](https://github.com/fat/zoom.js/))
* Social linksTwitter,Facebook,Instagram,Google+,GitHub,GitLab,npm,Codepen,Dribbble,500px,Flickr,Pinterest,Tumblr,Vimeo,YouTube,Linkedin
* Support for Related Content
* Support for tags
* Analytics with Google Analytics
* Responsive design
* SVG Sprite
Use short code for Image Zoom.
```
{{% zoom-img src="/images/default.jpg" %}}
```
## Features
* gulp
* webpack
* PostCSS
* Babel
* SVG Sprite
* Standard
## Installation
In your hugo site directory, run:
```shell
$ mkdir themes
$ cd themes
$ git clone -b release https://github.com/mismith0227/hugo_theme_pickles
```
Or download it from the release branch
[release](https://github.com/mismith0227/hugo_theme_pickles/tree/release)
## Usage
Use hugo's -t hugo_theme_pickles or --theme=hugo_theme_pickles option with hugo commands. Example:
```shell
$ hugo server -t hugo_theme_pickles -w -D
```
## Configuration
You may specify following options in `config.toml` of your site to make use of
this theme's features.
For getting started with Pickles, copy the [config.toml](https://github.com/mismith0227/hugo_theme_pickles/blob/master/exampleSite/config.toml) file from the exampleSite directory inside Pickless repository to your site repository.
```shell
$ cp themes/hugo_theme_pickles/exampleSite/config.toml .
```
Now, you can start editing this file and add your own information!
## Contributing
Pull requests, bug fixes and new features are welcome!
Please create feature branches from [develop](https://github.com/mismith0227/hugo_theme_pickles/tree/develop) and submit a PR for any change.
## Development
1. Install Node modules
$ yarn
1. Run gulp. You don't need to install gulp globally.
// Development
$ yarn run dev
$ // On another tab
$ hugo server
// Production (compress)
$ yarn run prod
$ // On another tab
$ hugo server
// Build
$ yarn run build
## License
Open sourced under the MIT license.