/cryptozealot.github.io

Free Automatic deployment of a Hugo generated website using Github Actions Workflows, Github Pages, and Netlify

Primary LanguageHTMLMIT LicenseMIT

Netlify Status
example workflow
Website cryptozealot.github.io

A dynamic staticly generated HTML website using Hugo and Hugo-Resume theme built and deployed with Github Actions Workflows to Github Pages and adminstered with Netlify CMS admin panel.

AKA a free automatically deployed dynamic website hosted on Github without a database.

To create your own free website at "{yourgituser}.github.io":

  1. Fork this repo and rename it while being forked
  2. Rename the repository to {yourgituser}.github.io
  3. IMPORTANT: While at your new repo, Go to Settings > Go to Pages > At "Build and deployment - Source" select "Github Actions" from the dropdown!
  4. IMPORTANT: While at your new repo, Go to Settings > Go to Actions > Click Enable Actions
  5. Do a manual change in one of the files to force a commit and start the pipeline. Just change something in config.toml
  6. Go to {yourgituser}.github.io

    (optional for netlify)

  7. Register and create a new site at Netlify. Edit --baseURL in netlify.toml to match your newly created site in netlify.

NOTE: If there are issues with the module, clone locally, run cmd below, and push back to remote.

git submodule add https://github.com/cryptozealot/cryptozealot.github.io.git /themes/hugo-resume/

Changes made to original repo:

  1. Added .github/workflows/ "Github Actions" workflow to build and deploy on Github Pages.
  2. Added netlify.toml - for Netlify deployment and admin panel
  3. Created theme file, moved folders from exampleSite, cleanup

Resources:
https://02dev.com/post/learn/61d8edb69c67d2983d96fae8
https://www.netlifycms.org/docs/github-backend/
https://www.netlifycms.org/docs/git-gateway-backend/
https://preview-auth-doc--netlify-cms-www.netlify.app/docs/authentication-backends/#github-backend
https://docs.netlify.com/visitor-access/oauth-provider-tokens/#using-an-authentication-provider
https://docs.netlify.com/visitor-access/oauth-provider-tokens/#netlify-ui-settings
https://cloud.gov/pages/documentation/getting-started-with-netlify-cms/