gulp-gh-pages
gulp plugin to publish contents to Github pages
Last updated 4 years ago by shinnn .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install gulp-gh-pages 
SYNC missed versions from official npm registry.

gulp-gh-pages

NPM version Build Status Build status Coverage Status Dependency Status devDependency Status

gulp plugin to publish contents to Github pages

Installation

Use npm.

npm install --save-dev gulp-gh-pages

Usage

Define a deploy task in your gulpfile.js (as below) which can be used to push to gh-pages going forward.

var gulp = require('gulp');
var ghPages = require('gulp-gh-pages');

gulp.task('deploy', function() {
  return gulp.src('./dist/**/*')
    .pipe(ghPages());
});

Now, you should be able to call your task by doing:

gulp deploy

API

var ghPages = require('gulp-gh-pages');

ghPages([options])

options: Object
Return: Object (stream.Transform)

options.remoteUrl

Type: String
Default: URL for the remote of the current dir (assumes a git repository)

By default gulp-gh-pages assumes the current working directory is a git repository and uses its remote url. If your gulpfile.js is not in a git repository, or if you want to push to a different remote url, you can specify it. Ensure you have write access to the repository.

options.origin

Type: String
Default: "origin"

Git remote.

options.branch

Type: String
Default: "gh-pages"

The branch where deploy will by done. Change to "master" for username.github.io projects.

options.cacheDir

Type: String
Default: .publish

Set the directory path to keep a cache of the repository. If it doesn't exist, gulp-gh-pages automatically create it.

options.push

Type: Boolean
Default: true

Allow you to make a build on the defined branch without pushing it to master. Useful for dry run.

options.force

Type: Boolean
Default: false

Force adding files to the gh-pages branch, even if they are ignored by .gitignore or .gitignore_global.

options.message

Type: String
Default: "Update [timestamp]"

Edit commit message.

License

Copyright (c) 2014 Micheal Benedict, 2015 Shinnosuke Watanabe

Licensed under the MIT License.

Current Tags

  • 0.5.4                                ...           latest (4 years ago)
  • 0.6.0-6                                ...           next (a year ago)

25 Versions

  • 0.6.0-6                                ...           a year ago
  • 0.6.0-5                                ...           a year ago
  • 0.6.0-4                                ...           a year ago
  • 0.6.0-3                                ...           a year ago
  • 0.6.0-2                                ...           a year ago
  • 0.6.0-1                                ...           2 years ago
  • 0.6.0-0                                ...           2 years ago
  • 0.5.4                                ...           4 years ago
  • 0.5.3                                ...           4 years ago
  • 0.5.2                                ...           5 years ago
  • 0.5.1                                ...           5 years ago
  • 0.5.0                                ...           5 years ago
  • 0.4.0                                ...           5 years ago
  • 0.3.4                                ...           5 years ago
  • 0.3.3                                ...           6 years ago
  • 0.3.2                                ...           6 years ago
  • 0.3.1                                ...           6 years ago
  • 0.3.0                                ...           6 years ago
  • 0.2.1                                ...           6 years ago
  • 0.2.0                                ...           6 years ago
  • 0.1.4                                ...           6 years ago
  • 0.1.3                                ...           6 years ago
  • 0.1.1                                ...           6 years ago
  • 0.1.0                                ...           6 years ago
  • 0.0.1                                ...           6 years ago
Maintainers (2)
Downloads
Today 0
This Week 48
This Month 223
Last Day 27
Last Week 51
Last Month 269
Dependencies (6)
Dev Dependencies (10)
Dependents (127)

Copyright 2014 - 2016 © taobao.org |