From d5454d4d4000109de764c84d06a456b8fd3af510 Mon Sep 17 00:00:00 2001 From: SukkaW Date: Sat, 9 Nov 2019 21:34:22 +0800 Subject: [PATCH 1/5] docs(deploy): add a overview page --- source/_data/sidebar.yml | 1 + source/docs/deployment.md | 47 +++++++++++++++++++++++++++++++++++++++ 2 files changed, 48 insertions(+) create mode 100755 source/docs/deployment.md diff --git a/source/_data/sidebar.yml b/source/_data/sidebar.yml index e3484bb29b..1740f5804b 100644 --- a/source/_data/sidebar.yml +++ b/source/_data/sidebar.yml @@ -14,6 +14,7 @@ docs: server: server.html generating: generating.html deployment: + deployment: deployment.html github_pages: github-pages.html gitlab_pages: gitlab-pages.html one_command_deployment: one-command-deployment.html diff --git a/source/docs/deployment.md b/source/docs/deployment.md new file mode 100755 index 0000000000..20857eb442 --- /dev/null +++ b/source/docs/deployment.md @@ -0,0 +1,47 @@ +--- +title: Deploy +--- + +As a static site generator, Hexo renders *static* websites. You can host your website on any server, CDN or your favorite development platform. + +## Platforms + +### GitHub Pages + +Deploy Hexo to GitHub Pages as a personal/project site and automate the whole process with Travis CI. [Read More](github-pages). + +### GitLab Pages + +With GitLab's built-in CI runner, you can easy to build your Hexo website and deploy to GitLab Pages service. [Read More](gitlab-pages). + +### Netlify + +Netlify provides free static site hosting service with CDN, CI/CD and Automated SSL. [Read More](one-command-deployment#Netlify). + +### ZEIT Now + +ZEIT Now is a severless cloud platform for websites and serverless APIs. [Read More](one-command-deployment#ZEIT-Now). + +### Heroku + +Heroku is a cloud platform that lets companies build, deliver, monitor and scale apps. [Read More](one-command-deployment#Heroku). + +### OpenShift + +OpenShift is an open source container application platform by Red Hat. [Read More](one-command-deployment#OpenShift) + +## Deployer Plugins + +Besides them, Hexo also provides many plugins that can help you to deploy your Hexo website. Just go to [Plugins List](/plugins) and type `deployer` in the search form and find out! Here are only a few of them: + +### Git + +Deploy your Hexo website to any git-supported platform with [`hexo-deployer-git`](one-command-deployment#Git). + +### Rsync + +Deploy your Hexo website using rsync with [`hexo-deployer-rsync`](one-command-deployment#Rsync). + +### FTP/SFTP + +Deploy your Hexo website to your server using FTP/SFTP with [`hexo-deployer-ftpsync`](one-command-deployment#FTPSync) or [`hexo-deployer-sftp`](one-command-deployment#SFTP). From 4ab0ce10e50d24b0174ed8ad1e752b25e0846d92 Mon Sep 17 00:00:00 2001 From: stevenjoezhang <1119186082@qq.com> Date: Fri, 28 Jul 2023 16:05:55 +0800 Subject: [PATCH 2/5] docs(deploy): reorder services --- source/docs/deployment.md | 50 ++++++----- source/docs/one-command-deployment.md | 114 +++++++++++++------------- 2 files changed, 88 insertions(+), 76 deletions(-) diff --git a/source/docs/deployment.md b/source/docs/deployment.md index 20857eb442..9b8df90814 100755 --- a/source/docs/deployment.md +++ b/source/docs/deployment.md @@ -4,44 +4,52 @@ title: Deploy As a static site generator, Hexo renders *static* websites. You can host your website on any server, CDN or your favorite development platform. -## Platforms +## Deployer Plugins -### GitHub Pages +Besides them, Hexo also provides many plugins that can help you to deploy your Hexo website. Just go to [Plugins List](/plugins) and type `deployer` in the search form and find out! Here are only a few of them: -Deploy Hexo to GitHub Pages as a personal/project site and automate the whole process with Travis CI. [Read More](github-pages). +### Git -### GitLab Pages +Deploy your Hexo website to any git-supported platform with [`hexo-deployer-git`](one-command-deployment#Git). -With GitLab's built-in CI runner, you can easy to build your Hexo website and deploy to GitLab Pages service. [Read More](gitlab-pages). +### Heroku -### Netlify +Heroku is a cloud platform that lets companies build, deliver, monitor and scale apps. [Read More](one-command-deployment#Heroku). -Netlify provides free static site hosting service with CDN, CI/CD and Automated SSL. [Read More](one-command-deployment#Netlify). +### Rsync -### ZEIT Now +Deploy your Hexo website using rsync with [`hexo-deployer-rsync`](one-command-deployment#Rsync). -ZEIT Now is a severless cloud platform for websites and serverless APIs. [Read More](one-command-deployment#ZEIT-Now). +### OpenShift -### Heroku +OpenShift is an open source container application platform by Red Hat. [Read More](one-command-deployment#OpenShift) -Heroku is a cloud platform that lets companies build, deliver, monitor and scale apps. [Read More](one-command-deployment#Heroku). +### FTP/SFTP -### OpenShift +Deploy your Hexo website to your server using FTP/SFTP with [`hexo-deployer-ftpsync`](one-command-deployment#FTPSync) or [`hexo-deployer-sftp`](one-command-deployment#SFTP). -OpenShift is an open source container application platform by Red Hat. [Read More](one-command-deployment#OpenShift) +### RSS3 -## Deployer Plugins +Deploy your Hexo website to RSS3 with [`hexo-deployer-rss3`](one-command-deployment#RSS3). -Besides them, Hexo also provides many plugins that can help you to deploy your Hexo website. Just go to [Plugins List](/plugins) and type `deployer` in the search form and find out! Here are only a few of them: +## Platforms -### Git +### GitHub Pages -Deploy your Hexo website to any git-supported platform with [`hexo-deployer-git`](one-command-deployment#Git). +Deploy Hexo to GitHub Pages as a personal/project site and automate the whole process with GitHub Actions. [Read More](github-pages). -### Rsync +### GitLab Pages -Deploy your Hexo website using rsync with [`hexo-deployer-rsync`](one-command-deployment#Rsync). +With GitLab's built-in CI runner, you can easy to build your Hexo website and deploy to GitLab Pages service. [Read More](gitlab-pages). -### FTP/SFTP +### Netlify -Deploy your Hexo website to your server using FTP/SFTP with [`hexo-deployer-ftpsync`](one-command-deployment#FTPSync) or [`hexo-deployer-sftp`](one-command-deployment#SFTP). +Netlify provides free static site hosting service with CDN, CI/CD and Automated SSL. [Read More](one-command-deployment#Netlify). + +### Vercel + +Vercel is a severless cloud platform for websites and serverless APIs. [Read More](one-command-deployment#Vercel). + +### Edgio + +Edgio (formerly Layer0) is an Internet-scale platform that makes it easy for teams to build, release, protect, and accelerate their web apps and APIs. [Read More](one-command-deployment#Edgio-formerly-Layer0) diff --git a/source/docs/one-command-deployment.md b/source/docs/one-command-deployment.md index 42b86682ff..b1b5faead6 100644 --- a/source/docs/one-command-deployment.md +++ b/source/docs/one-command-deployment.md @@ -29,7 +29,9 @@ deploy: Refer to the [Plugins](https://hexo.io/plugins/) list for more deployment plugins. -## Git +## Deployer Plugins + +### Git 1. Install [hexo-deployer-git]. @@ -61,7 +63,7 @@ Option | Description | Default 4. Navigate to your repository settings and change the "Pages" branch to `gh-pages` (or the branch specified in your config). The deployed site should be live on the link shown on the "Pages" setting. -## Heroku +### Heroku Install [hexo-deployer-heroku]. @@ -83,17 +85,7 @@ deploy: | `repo`, `repository` | Heroku repository URL | | `message` | Customize commit message (Default to `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`) | -## Netlify - -[Netlify](https://www.netlify.com/) provides continuous deployment (Git-triggered builds), an intelligent global CDN, full DNS (including custom domains), automated HTTPS, asset acceleration, and a lot more. It is a unified platform that automates your code to create high-performance, easily maintainable sites and web apps. - -There are two different ways to deploy your sites on Netlify. The most common way is to use the web UI. Go to the [create a new site page](https://app.netlify.com/start), select your project repo from GitHub, GitLab, or Bitbucket, and follow the prompts. - -Alternatively, you can use Netlify's [Node based CLI](https://www.netlify.com/docs/cli/) tool to manage and deploy sites on Netlify without leaving your terminal. - -You can also add a [Deploy to Netlify Button](https://www.netlify.com/docs/deploy-button/) in your README.file to allow others to create a copy of your repository and be deployed to Netlify via one click. - -## Rsync +### Rsync Install [hexo-deployer-rsync]. @@ -125,7 +117,7 @@ deploy: | `verbose` | Display verbose messages | true | | `ignore_errors` | Ignore errors | false | -## OpenShift +### OpenShift Install [hexo-deployer-openshift]. @@ -147,7 +139,7 @@ deploy: | `repo` | OpenShift repository URL | | `message` | Customize commit message (Default to `Site updated: {% raw %}{{ now('YYYY-MM-DD HH:mm:ss') }}{% endraw %}`) | -## FTPSync +### FTPSync Install [hexo-deployer-ftpsync]. @@ -181,7 +173,7 @@ deploy: | `connections` | Connections number | 1 | | `verbose` | Display verbose messages | false | -## SFTP +### SFTP Install [hexo-deployer-sftp]. Deploys the site via SFTP, allowing for passwordless connections using ssh-agent. @@ -217,7 +209,55 @@ deploy: | `forceUpload` | Override existing files | false | | `concurrency` | Max number of SFTP tasks processed concurrently | 100 | -## Vercel +### RSS3 + +[RSS3](https://rss3.io) is an open protocol designed for content and social networks in the Web 3.0 era. + +1. Install [hexo-deployer-rss3]. + +2. Modify the configuration. + + ``` yaml + deploy: # The root configuration block for all deployers + - type: rss3 + endpoint: https://hub.rss3.io + privateKey: 47e18d6c386898b424025cd9db446f779ef24ad33a26c499c87bb3d9372540ba + ipfs: + deploy: true + gateway: pinata + api: + key: d693df715d3631e489d6 + secret: ee8b74626f12b61c1a4bde3b8c331ad390567c86ba779c9b18561ee92c1cbff0 + ``` + +| Parameters | Description | +| ----------------- | ---------------------- | +| `endpoint` | a link to the RSS3 Hub | +| `privateKey` | your private key, 64 bytes | +| `ipfs/deploy` | whether to deploy to IPFS | +| `ipfs/gateway` | IPFS API gateway | +| `ipfs/api/key` | IPFS gateway-related authentication content | +| `ipfs/api/secret` | IPFS gateway-related authentication content | + +3. generate static files + +4. deploy + +For deployment-related considerations, you can refer to [Our documentation](https://github.com/NaturalSelectionLabs/hexo-deployer-rss3/blob/develop/README.md). + +## Platforms + +### Netlify + +[Netlify](https://www.netlify.com/) provides continuous deployment (Git-triggered builds), an intelligent global CDN, full DNS (including custom domains), automated HTTPS, asset acceleration, and a lot more. It is a unified platform that automates your code to create high-performance, easily maintainable sites and web apps. + +There are two different ways to deploy your sites on Netlify. The most common way is to use the web UI. Go to the [create a new site page](https://app.netlify.com/start), select your project repo from GitHub, GitLab, or Bitbucket, and follow the prompts. + +Alternatively, you can use Netlify's [Node based CLI](https://www.netlify.com/docs/cli/) tool to manage and deploy sites on Netlify without leaving your terminal. + +You can also add a [Deploy to Netlify Button](https://www.netlify.com/docs/deploy-button/) in your README.file to allow others to create a copy of your repository and be deployed to Netlify via one click. + +### Vercel [Vercel](https://vercel.com) is a cloud platform that enables developers to host Jamstack websites and web services that deploy instantly, scale automatically, and requires no supervision, all with zero configuration. They provide a global edge network, SSL encryption, asset compression, cache invalidation, and more. @@ -243,7 +283,7 @@ Alternatively, you can click the deploy button below to create a new project: [![Deploy Vercel](https://vercel.com/button)](https://vercel.com/new/hexo) -## Bip +### Bip [Bip](https://bip.sh) is a commercial hosting service which provides zero downtime deployment, a global CDN, SSL, unlimited bandwidth and more for static websites. Plans are available on a pay as you go, per domain basis. @@ -265,43 +305,7 @@ $ hexo generate —deploy && bip deploy After a few moments, your website will be deployed. -## RSS3 - -[RSS3](https://rss3.io) is an open protocol designed for content and social networks in the Web 3.0 era. - -1. Install [hexo-deployer-rss3]. - -2. Modify the configuration. - - ``` yaml - deploy: # The root configuration block for all deployers - - type: rss3 - endpoint: https://hub.rss3.io - privateKey: 47e18d6c386898b424025cd9db446f779ef24ad33a26c499c87bb3d9372540ba - ipfs: - deploy: true - gateway: pinata - api: - key: d693df715d3631e489d6 - secret: ee8b74626f12b61c1a4bde3b8c331ad390567c86ba779c9b18561ee92c1cbff0 - ``` - -| Parameters | Description | -| ----------------- | ---------------------- | -| `endpoint` | a link to the RSS3 Hub | -| `privateKey` | your private key, 64 bytes | -| `ipfs/deploy` | whether to deploy to IPFS | -| `ipfs/gateway` | IPFS API gateway | -| `ipfs/api/key` | IPFS gateway-related authentication content | -| `ipfs/api/secret` | IPFS gateway-related authentication content | - -3. generate static files - -4. deploy - -For deployment-related considerations, you can refer to [Our documentation](https://github.com/NaturalSelectionLabs/hexo-deployer-rss3/blob/develop/README.md). - -## Edgio (formerly Layer0) +### Edgio (formerly Layer0) [Edgio (formerly Layer0)](https://docs.edg.io) is an Internet-scale platform that makes it easy for teams to build, release, protect, and accelerate their web apps and APIs. From e27889ffb830929009dc0997626642482e84e8cb Mon Sep 17 00:00:00 2001 From: stevenjoezhang <1119186082@qq.com> Date: Sat, 29 Jul 2023 00:32:45 +0800 Subject: [PATCH 3/5] docs(deploy): add Bip --- source/docs/deployment.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/docs/deployment.md b/source/docs/deployment.md index 9b8df90814..3e6e8f6d65 100755 --- a/source/docs/deployment.md +++ b/source/docs/deployment.md @@ -50,6 +50,10 @@ Netlify provides free static site hosting service with CDN, CI/CD and Automated Vercel is a severless cloud platform for websites and serverless APIs. [Read More](one-command-deployment#Vercel). +### Bip + +Deploy your website in seconds to your own .bip.sh domain. [Read More](one-command-deployment#Bip). + ### Edgio Edgio (formerly Layer0) is an Internet-scale platform that makes it easy for teams to build, release, protect, and accelerate their web apps and APIs. [Read More](one-command-deployment#Edgio-formerly-Layer0) From 36bd528037df546cdaed54effc361de2aa3633c1 Mon Sep 17 00:00:00 2001 From: Mimi <1119186082@qq.com> Date: Sat, 9 Sep 2023 10:55:10 +0800 Subject: [PATCH 4/5] Fix typo --- source/docs/one-command-deployment.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/docs/one-command-deployment.md b/source/docs/one-command-deployment.md index b1b5faead6..a3884d405d 100644 --- a/source/docs/one-command-deployment.md +++ b/source/docs/one-command-deployment.md @@ -289,7 +289,7 @@ Alternatively, you can click the deploy button below to create a new project: Getting started is quick and easy, as Bip provides out the box support for Hexo. This guide assumes you already have [a Bip domain and Bip CLI installed](https://bip.sh/getstarted). -1: Initialise your project directory +1: Initialize your project directory ```bash $ bip init From a43523d194c9fcd0da5b39d671135def12d6b21d Mon Sep 17 00:00:00 2001 From: Mimi <1119186082@qq.com> Date: Fri, 22 Sep 2023 00:37:01 +0800 Subject: [PATCH 5/5] Rename to overview --- source/_data/sidebar.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_data/sidebar.yml b/source/_data/sidebar.yml index 1740f5804b..76ca2e48a0 100644 --- a/source/_data/sidebar.yml +++ b/source/_data/sidebar.yml @@ -14,7 +14,7 @@ docs: server: server.html generating: generating.html deployment: - deployment: deployment.html + overview: deployment.html github_pages: github-pages.html gitlab_pages: gitlab-pages.html one_command_deployment: one-command-deployment.html @@ -52,4 +52,4 @@ api: migrator: migrator.html processor: processor.html renderer: renderer.html - tag: tag.html \ No newline at end of file + tag: tag.html