marcel
/
congo
mirror of https://github.com/jpanther/congo.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

🔀 Merge pull request #278 from major/cloudflare-deployment-note 

📝 Add deployment note about Cloudflare pages
pull/279/head
James Panther 2022-08-19 08:54:49 +10:00 committed by GitHub
parent ffaca3f5ce e13b30774a
commit 6da8cfbe9b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
exampleSite/content/docs/hosting-deployment/index.md
View File

@ -18,6 +18,7 @@ The official Hugo [Hosting and Deployment](https://gohugo.io/hosting-and-deploym
- [GitHub Pages](#github-pages) - [GitHub Pages](#github-pages)
- [Netlify](#netlify) - [Netlify](#netlify)
- [Render](#render) - [Render](#render)
- [Cloudflare Pages](#cloudflare-pages)
- [Shared hosting, VPS or private web server](#shared-hosting-vps-or-private-web-server) - [Shared hosting, VPS or private web server](#shared-hosting-vps-or-private-web-server)
--- ---
@ -100,7 +101,7 @@ Then in the root of your site repository, create a `netlify.toml` file:
[context.production.environment] [context.production.environment]
HUGO_VERSION = "0.100.2" HUGO_VERSION = "0.100.2"
HUGO_ENV = "production" HUGO_ENV = "production"
[context.deploy-preview.environment] [context.deploy-preview.environment]
HUGO_VERSION = "0.100.2" HUGO_VERSION = "0.100.2"
``` ```
@ -119,6 +120,21 @@ Create a new **Static Site** and link it to your project's code repository. Then
The site will automatically build and deploy whenever you push a change to your repo. The site will automatically build and deploy whenever you push a change to your repo.
## Cloudflare Pages
Cloudflare offers the [Pages](https://pages.cloudflare.com/) service that can host Hugo blogs. It builds the site from a git repository and then hosts it on Cloudflare's CDN. Follow their [Hugo deployment guide](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) to get started.
The Rocket Loader™ feature offered by Cloudflare tries to speed up rendering of web pages with JavaScript, but it breaks the appearance switcher in the theme. It can also cause an annoying light/dark screen flash when browsing your site due to scripts loading in the wrong order.
This problem can be fixed by disabling it:
- Go to the [Cloudflare dashboard](https://dash.cloudflare.com)
- Click on your domain name in the list
- Click _Optimization_ in the _Speed_ section
- Scroll down to _Rocket Loader™_ and disable it
Hugo sites built with Congo still load very quickly, even with this feature disabled.
## Shared hosting, VPS or private web server ## Shared hosting, VPS or private web server
Using traditional web hosting, or deploying to your own web server, is as simple as building your Hugo site and transferring the files to your host. Using traditional web hosting, or deploying to your own web server, is as simple as building your Hugo site and transferring the files to your host.