https://github.com/braginteractive/kickoff-bootstrap-3
_s + Gulp + Bower starter WordPress theme
https://github.com/braginteractive/kickoff-bootstrap-3
Last synced: 12 months ago
JSON representation
_s + Gulp + Bower starter WordPress theme
- Host: GitHub
- URL: https://github.com/braginteractive/kickoff-bootstrap-3
- Owner: braginteractive
- Created: 2015-05-08T18:12:20.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2015-07-07T16:04:40.000Z (almost 11 years ago)
- Last Synced: 2023-02-27T04:51:34.507Z (over 3 years ago)
- Language: CSS
- Homepage:
- Size: 770 KB
- Stars: 12
- Watchers: 6
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Kickoff - Bootstrap 3
===
Kickoff is a fork of Automattic's [_s](https://github.com/Automattic/_s) WordPress starter theme that includes Gulp and Bower.
# Pre-Installation
Basic knowledge of the command line and the following dependencies are required to use kickoff:
- Node ([http://nodejs.org/](http://nodejs.org/)) -`npm install`
- Gulp ([http://gulpjs.com/](http://gulpjs.com/)) - `npm install --global gulp`
- Bower ([http://bower.io/](http://bower.io/)) -`npm install -g bower`
## Manual Installation
##### 1) Navigate to the /themes folder of your project
`cd /your-project/wordpress/wp-content/themes`
##### 2) Clone
`git clone https://github.com/braginteractive/kickoff-bootstrap-3.git`
##### 3) Find & Replace
You'll need to change all instances of the names: `kickoff` to your project name.
- Search for: `'kickoff'` and replace with: `'project-name'` (inside single quotations) to capture the text domain
- Search for: `kickoff_` and replace with: `project-name_` to capture all the function names
- Search for: `Text Domain: kickoff` and replace with: `Text Domain: project-name` in style.css
- Search for (and include the leading space): kickoff and replace with: Project Name(with a space before it) to capture DocBlocks
- Search for: `kickoff-` and replace with: `project-name-` to capture prefixed handles
##### 4) Install Gulp and Dependencies
- Run `npm install && bower install` from the command line to install Gulp and pull down any dependencies via Bower.
That's it! Now you can begin using Gulp.
# Usage
After you've installed kickoff, and run `npm install` and `gulp` from the command line you can start using gulp.
## Gulp
##### 1) Navigate to your new theme
`cd /your-project/wordpress/wp-content/themes/your-new-theme`
##### 2) Gulp tasks available:
`gulp` - Installs Bower Components and Font Awesome
`gulp watch` - Automatically handle changes to CSS, javascript, php, and image optimization. Also Livereload!
`gulp scripts` - Concatenate and minify javascript files
`gulp sass` - Compile, prefix, and minify CSS files
`gulp bower` - Install bower components
`gulp icons` - creates /fonts/ directory and adds Font Awesome font files