98 lines
2.6 KiB
Markdown
98 lines
2.6 KiB
Markdown
|
# 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 links(Twitter,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 Pickles’s 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.
|