/ember-cli-github-pages

Easily manage gh-pages of your ember-cli addon

Primary LanguageJavaScriptMIT LicenseMIT

ember-cli-github-pages

npm version Ember Observer Score Code Climate Dependency Status devDependency Status

If you need to throw up a quick example of your addon in action, this is the addon for you!

This addon provides new command(s) to help manage a gh-pages branch for your addon. It's an addon for addons.

Installation & Setup

First you need to install ember-cli-github-pages:

ember-cli - 0.2.3 or newer

ember install ember-cli-github-pages

ember-cli - 0.1.5 to 0.2.3

ember install:addon ember-cli-github-pages

ember-cli - 0.1.4 and below

npm install --save-dev ember-cli-github-pages
ember generate ember-cli-github-pages

Then you need to make the sure gh-pages branch is created and the unnecessary files are removed:

git checkout --orphan gh-pages && rm -rf `ls -a | grep -vE '.gitignore|.git|node_modules|bower_components|\.\/|\.\.\/'` && git add . && git commit -m "initial gh-pages commit"

Usage

Once that's done, you can checkout the branch you want to create the gh-page from(likely master) and run the command to build and commit it.

Then run ember github-pages:commit --message "some commit message" in order to rebuild gh-pages branch.

git checkout master
ember github-pages:commit --message "Initial gh-pages release"

A note about Org and User Pages

While in general, github repo pages will serve the content in the gh-pages branch, org and user pages serve content in the master branch. When using this addon, please remember to add the --branch master option to the ember github-pages:commit command

Advanced Usage

You may optionally specify an ember build environment and a branch name as parameters

git checkout master
ember github-pages:commit --message "Initial demo app release" \
                          --branch="my-demo-app" \
                          --environment=development
Optional Argument Default Value Description
environment production Ember build environment (i.e., development, production)
branch gh-pages Branch to commit your app to

Important

In order to have any assets you have in your repo load correctly you need to add the following to your tests/dummy/config/environment.js file:

if (environment === 'production') {
  ENV.baseURL = '/name-of-your-repo'
}

You will still need to push the gh-pages branch up to github using git. Once you do that you can access the repo at http://username.github.io/repo-name. It may take a few minutes after pushing the code to show up.

Authors

We are very thankful for our many contributors

Legal

Licensed under the MIT license