mirror of
https://github.com/JamesIves/github-pages-deploy-action.git
synced 2023-12-15 20:03:39 +08:00
README Changes
This commit is contained in:
parent
7fcdab3380
commit
b11907137d
@ -1,8 +1,8 @@
|
|||||||
# GitHub Pages Deploy Action :rocket:
|
# GitHub Pages Deploy Action :rocket:
|
||||||
|
|
||||||
[![Actions Status](https://github.com/JamesIves/github-pages-deploy-action/workflows/integration/badge.svg)](https://github.com/JamesIves/github-pages-deploy-action/actions) [![View Action](https://img.shields.io/badge/view-action-blue.svg)](https://github.com/marketplace/actions/deploy-to-github-pages) [![Issues](https://img.shields.io/github/issues/JamesIves/github-pages-deploy-action.svg)](https://github.com/JamesIves/github-pages-deploy-action/issues)
|
[![Actions Status](https://github.com/JamesIves/github-pages-deploy-action/workflows/integration/badge.svg)](https://github.com/JamesIves/github-pages-deploy-action/actions) [![View Action](https://img.shields.io/badge/view-action-blue.svg?logo=github)](https://github.com/marketplace/actions/deploy-to-github-pages) [![Issues](https://img.shields.io/github/issues/JamesIves/github-pages-deploy-action.svg)](https://github.com/JamesIves/github-pages-deploy-action/issues)
|
||||||
|
|
||||||
This [GitHub action](https://github.com/features/actions) will handle the deploy process of your project to [GitHub Pages](https://pages.github.com/). It can be configured to upload your production-ready code into any branch you'd like, including `gh-pages` and `docs`. This action is built on [Node](https://nodejs.org/en/), which means that you can call any optional build scripts your project requires prior to deploying.
|
This [GitHub action](https://github.com/features/actions) will handle the deploy process of your project to [GitHub Pages](https://pages.github.com/). It can be configured to upload your production-ready code into any branch you'd like, including `gh-pages` and `docs`.
|
||||||
|
|
||||||
## Getting Started :airplane:
|
## Getting Started :airplane:
|
||||||
You can include the action in your workflow to trigger on any event that [GitHub actions supports](https://help.github.com/en/articles/events-that-trigger-workflows). If the remote branch that you wish to deploy to doesn't already exist the action will create it for you. Your workflow will also need to include the `actions/checkout` step before this workflow runs in order for the deployment to work.
|
You can include the action in your workflow to trigger on any event that [GitHub actions supports](https://help.github.com/en/articles/events-that-trigger-workflows). If the remote branch that you wish to deploy to doesn't already exist the action will create it for you. Your workflow will also need to include the `actions/checkout` step before this workflow runs in order for the deployment to work.
|
||||||
@ -60,6 +60,6 @@ With the action correctly configured you should see the workflow trigger the dep
|
|||||||
|
|
||||||
### Build Files
|
### Build Files
|
||||||
|
|
||||||
This action maintains the full Git history of the deployment branch. Therefore if you're using a custom domain, or require the use of a `.nojekyll` file, you can safely commit these files directly into deployment branch without them being overridden after each deployment.
|
This action maintains the full Git history of the deployment branch. Therefore if you're using a custom domain and require a `CNAME` file, or if you require the use of a `.nojekyll` file, you can safely commit these files directly into deployment branch without them being overridden after each deployment.
|
||||||
|
|
||||||
![Example](screenshot.png)
|
![Example](screenshot.png)
|
||||||
|
@ -53,7 +53,7 @@ export async function generateBranch(): Promise<any> {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Runs the neccersary steps to make the deployment.
|
/** Runs the necessary steps to make the deployment.
|
||||||
* @returns {Promise}
|
* @returns {Promise}
|
||||||
*/
|
*/
|
||||||
export async function deploy(): Promise<any> {
|
export async function deploy(): Promise<any> {
|
||||||
@ -82,8 +82,8 @@ export async function deploy(): Promise<any> {
|
|||||||
);
|
);
|
||||||
|
|
||||||
/*
|
/*
|
||||||
Pushes all of the action.build files into the deployment directory.
|
Pushes all of the build files into the deployment directory.
|
||||||
Allows the user to specify the root if '.' is provided. */
|
Allows the user to specify the root if '.' is provided. */
|
||||||
await cp(`${action.build}/.`, temporaryDeploymentDirectory, {
|
await cp(`${action.build}/.`, temporaryDeploymentDirectory, {
|
||||||
recursive: true,
|
recursive: true,
|
||||||
force: true
|
force: true
|
||||||
|
@ -4,7 +4,6 @@ import { init, deploy } from "./git";
|
|||||||
/** Initializes and runs the action. */
|
/** Initializes and runs the action. */
|
||||||
(async function() {
|
(async function() {
|
||||||
try {
|
try {
|
||||||
// Initializes the action.
|
|
||||||
await init();
|
await init();
|
||||||
await deploy();
|
await deploy();
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
|
Loading…
Reference in New Issue
Block a user