You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+19-13Lines changed: 19 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -7,18 +7,19 @@
7
7
8
8
<hr>
9
9
10
-
Angular CLI addon. Publish to any gh-pages branch on GitHub (or any other branch on any other remote).
10
+
This __was__ an angular CLI addon (until they [removed addon support](https://github.com/angular/angular-cli/pull/3695)).
11
+
Now it's just a wrapper around [tschaub/gh-pages](https://github.com/tschaub/gh-pages).
12
+
13
+
Publish to any gh-pages branch on GitHub (or any other branch on any other remote).
11
14
Made for Travis-CI. Brought to you by the [angular-buch.com](https://angular-buch.com/) team!
12
15
13
16
## About
14
17
15
-
This is similar to the normal `github-pages:deploy` command.
18
+
This script is similar to the normal `github-pages:deploy` command.
16
19
But by design, the command is limited to the `gh-pages` branch of the same repository.
17
20
18
-
In contrast to this, the [angular-buch/angular-cli-ghpages](https://github.com/angular-buch/angular-cli-ghpages) addon is able to push to any branch on any repository. It's made on top of [tschaub/gh-pages](https://github.com/tschaub/gh-pages).
19
-
__This addon works great on [Travis-CI](https://travis-ci.org/).__ No git credentials must be set up in before. Specific environment variables of Travis-CI are evaluated, too. You will like it!
20
-
21
-
angular-cli-ghpages was sucessfully tested against __`angular-cli@1.0.0-beta.22-1`__.
21
+
In contrast to this, the [angular-buch/angular-cli-ghpages](https://github.com/angular-buch/angular-cli-ghpages) script is able to push to any branch on any repository. It's made on top of [tschaub/gh-pages](https://github.com/tschaub/gh-pages).
22
+
__This script works great on [Travis-CI](https://travis-ci.org/).__ No git credentials must be set up in before. Specific environment variables of Travis-CI are evaluated, too. You will like it!
22
23
23
24
24
25
## Installation & Setup
@@ -27,24 +28,29 @@ This addon has the following prerequisites:
27
28
28
29
- Node.js 4.x
29
30
- Git 1.7.6 or higher
30
-
- Angular project created via [angular-cli](https://github.com/angular/angular-cli)
31
+
-Optional: Angular project created via [angular-cli](https://github.com/angular/angular-cli)
31
32
32
33
To install this addon run the following command:
33
34
34
35
```sh
35
-
cd<your-angular-cli-project>
36
-
npm install angular-cli-ghpages --save-dev
36
+
npm i -g angular-cli-ghpages
37
37
```
38
38
39
39
## Usage
40
40
41
-
Execute `ng ghpages` in order to deploy the project with a build from `dist` folder.
41
+
Execute `angular-cli-ghpages` in order to deploy the project with a build from `dist` folder.
42
42
Note: you have to create the folder in before (e.g. `ng build --prod`)
43
43
44
44
Usage:
45
45
46
46
```sh
47
-
ng ghpages [OPTIONS]
47
+
angular-cli-ghpages [OPTIONS]
48
+
```
49
+
50
+
there is also a shorter `ngh` command available
51
+
52
+
```sh
53
+
ngh [OPTIONS]
48
54
```
49
55
50
56
## Options
@@ -64,7 +70,7 @@ Some handy additional text is always added, if the environment variable `process
64
70
65
71
Example:
66
72
```sh
67
-
ng ghpages --message="What could possibly go wrong?"
73
+
angular-cli-ghpages --message="What could possibly go wrong?"
68
74
```
69
75
70
76
@@ -116,7 +122,7 @@ For your convenience, the addon will recognize the [environment variable](https:
116
122
In example, the following command runs [on our Travis-CI](https://travis-ci.org/angular-buch/book-monkey2):
117
123
118
124
```sh
119
-
ng ghpages --repo=https://GH_TOKEN@github.com/organisation/your-repo.git --name="Displayed Username" --email=mail@example.orf
.option('-d, --dir <dir>', 'Directory for all published sources, relative to the project-root. Most probably no change is required here.', 'dist')
9
+
.option('-r, --repo <repo>', 'The commit message to include with the build, must be wrapped in quotes.')
10
+
.option('-m, --message <message>', 'The commit message, must be wrapped in quotes.', 'Auto-generated commit')
11
+
.option('-b, --branch <branch>', 'The git branch to push your pages to.', 'gh-pages')
12
+
.option('-n, --name <name>', 'The git user-name which is associated with this commit.')
13
+
.option('-e, --email <email>', 'The git user-email which is associated with this commit')
14
+
.option('-x, --silent', 'Suppress console logging. This option should be used if the repository URL or other information passed to git commands is sensitive! Default: true')
15
+
.option('-t, --dotfiles', 'Includes dotfiles by default. When set to `false` files starting with `.` are ignored. Default: true')
"description": "Angular CLI addon. Publish to any gh-pages branch on GitHub (or any other branch on any other remote).",
3
+
"version": "0.4.0",
4
+
"description": "Wrapper around gh-pages, made for angular-cli users. Publish to any gh-pages branch on GitHub (or any other branch on any other remote).",
0 commit comments