From dd18d9cc9ddcac01b8b99e68e455cc46816b42d0 Mon Sep 17 00:00:00 2001 From: Major Hayden Date: Thu, 18 Aug 2022 07:55:58 -0500 Subject: [PATCH] :memo: Add deployment note about Cloudflare pages Per the discussion in jpanther/congo#266. Signed-off-by: Major Hayden --- .../content/docs/hosting-deployment/index.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/exampleSite/content/docs/hosting-deployment/index.md b/exampleSite/content/docs/hosting-deployment/index.md index cc38643f..4d860845 100644 --- a/exampleSite/content/docs/hosting-deployment/index.md +++ b/exampleSite/content/docs/hosting-deployment/index.md @@ -18,6 +18,7 @@ The official Hugo [Hosting and Deployment](https://gohugo.io/hosting-and-deploym - [GitHub Pages](#github-pages) - [Netlify](#netlify) - [Render](#render) +- [Cloudflare Pages](#cloudflare-pages) - [Shared hosting, VPS or private web server](#shared-hosting-vps-or-private-web-server) --- @@ -119,6 +120,23 @@ 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. +# 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 the site on Cloudflare's CDN. +Follow their [Hugo deployment guide](https://developers.cloudflare.com/pages/framework-guides/deploy-a-hugo-site) to get started. + +The Rocker Loader™ feature offered by Cloudflare tries to speed up rendering of web pages with javascript, but it breaks the appearance switcher. +It can also cause an annoying light/dark screen flash when browsing your site due to javascript loading in the wrong order. +Fix this problem 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 with the Congo theme still load very quickly even with this feature disabled. + ## 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.