Skip to content

Commit

Permalink
Update readme.
Browse files Browse the repository at this point in the history
  • Loading branch information
seothemes committed Apr 2, 2017
1 parent 5b340e8 commit 139099d
Show file tree
Hide file tree
Showing 2 changed files with 107 additions and 42 deletions.
137 changes: 101 additions & 36 deletions README.md
@@ -1,56 +1,79 @@
# Genesis Starter Theme

Github project link: https://github.com/seothemes/genesis-starter/
A search engine optimized starter theme for the Genesis Framework with a modern development workflow.


## Theme installation
## Features

* Optimized HTML, CSS & JS output
* Sass for stylesheets
* Gulp for compiling assets, optimizing images
* Customizer toolkit
* WooCommerce support
* Hero section
* Video background
* Page templates


## Requirements

* PHP > 5.6
* WordPress > 4.7
* Genesis Framework > 2.0
* Node.js > 6.9
* Gulp.js > 3.9


## Installation

1. Upload the Genesis Starter theme folder via FTP to your wp-content/themes/ directory. (The Genesis parent theme needs to be in the wp-content/themes/ directory as well.)
2. Go to your WordPress dashboard and select Appearance.
3. Activate the Genesis Starter theme.
4. Inside your WordPress dashboard, go to Genesis > Theme Settings and configure them to your liking.
5. Inside your WordPress dashboard, go to Appearance > Customize and customize to your liking.


## Structure

## Theme structure
```shell
theme/
├── assets
├── demo/
├── fonts/
├── images/
├── scripts/
└── styles/
├── demo/
├── fonts/
├── images/
├── scripts/
└── styles/
├── languages
└── genesis-starter.pot
└── genesis-starter.pot
├── lib/
├── classes/
├── class-genesis-hero.php
└── class-require-plugins.php
├── clean-up/
├── clean-body-class.php
├── clean-gallery.php
├── clean-genesis.php
├── clean-jquery.php
├── clean-wordpress.php
└── clean.php
├── customize/
├── customize-colors.php
├── customize-header.php
├── customize-typography.php
├── class-starter-kirki.php
├── include-kirki.php
└── customize.php
├── demo-import.php
├── header-functions.php
├── theme-defaults.php
├── theme-setup.php
├── widget-areas.php
└── woocommerce.php
├── classes/
├── class-genesis-hero.php
└── class-require-plugins.php
├── clean-up/
├── clean-body-class.php
├── clean-gallery.php
├── clean-genesis.php
├── clean-jquery.php
├── clean-wordpress.php
└── clean.php
├── customize/
├── customize-colors.php
├── customize-header.php
├── customize-typography.php
├── class-starter-kirki.php
├── include-kirki.php
└── customize.php
├── demo-import.php
├── header-functions.php
├── theme-defaults.php
├── theme-setup.php
├── widget-areas.php
└── woocommerce.php
├── node_modules/
├── templates/
├── image-widget.php/
├── page-narrow.php/
└── page-wide.php/
├── image-widget.php/
├── page-narrow.php/
└── page-wide.php/
├── .editorconfig
├── CHANGELOG.md
├── functions.php
Expand All @@ -63,7 +86,49 @@ theme/
```


## Theme support
## Development

Genesis Starter uses [Gulp](http://gulpjs.com/) as a build tool and [npm](https://www.npmjs.com/) to manage front-end packages.

### Install dependencies

From the command line on your host machine, navigate to the theme directory then run `npm install`:

```shell
# @ themes/your-theme-name/
$ npm install
```

You now have all the necessary dependencies to run the build process.

### Build commands

* `gulp sass` — Compile, autoprefix and minify Sass files.
* `gulp scripts` — Minify javascript files.
* `gulp images` — Compress and optimize images.
* `gulp watch` — Compile assets when file changes are made, start Browsersync
* `gulp` — Default task - runs all of the above tasks.


#### Additional commands

* `gulp i18n` — Scan the theme and create a POT file.
* `gulp zip` — Package theme into zip file for distribution.

### Using Browsersync

To use Browsersync you need to update `dev_url` on line 43 of `gulpfile.js` to reflect your local development hostname.

If your local development URL is `my-site.dev`, update the file to read:

```javascript
...
var dev_url = 'my-site.dev',
...
```


## Support

Please visit https://seothemes.net/support/ for theme support.

12 changes: 6 additions & 6 deletions gulpfile.js
Expand Up @@ -40,7 +40,7 @@ var php_src = ['./*.php', './**/*.php', './**/**/*.php'];
var php_dest = './';

// Set BrowserSync proxy url.
var bs_url = 'genesis-starter.dev';
var dev_url = 'genesis-starter.dev';
var reload = browserSync.reload;

/**
Expand Down Expand Up @@ -117,13 +117,13 @@ gulp.task( 'sass', function () {
} );

/**
* Minify javascripts after they're concatenated.
* Minify javascript files.
*
* https://www.npmjs.com/package/gulp-uglify
*/
gulp.task( 'scripts', function () {

gulp.src(js_src)
gulp.src( js_src )
// Notify on error.
.pipe( plumber( { errorHandler: notify.onError( "Error: <%= error.message %>" ) } ) )

Expand Down Expand Up @@ -199,11 +199,11 @@ gulp.task( 'i18n', function() {
*
* https://www.npmjs.com/package/browser-sync
*/
gulp.task( 'browsersync', function() {
gulp.task( 'watch', function() {

// Kick off BrowserSync.
browserSync( {
proxy: bs_url,
proxy: dev_url,
notify: false,
open: false
} );
Expand Down Expand Up @@ -238,6 +238,6 @@ gulp.task( 'zip', function() {
/**
* Create default task.
*/
gulp.task( 'default', ['browsersync'], function() {
gulp.task( 'default', ['watch'], function() {
gulp.start( 'sass', 'scripts', 'images' );
} );

0 comments on commit 139099d

Please sign in to comment.