Deploy Hugo Blog to Github Pages via Github Actions w/ a Custom Domain

We will build and deploy a blog powered by Hugo to Github Pages via a custom Github Actions and link a custom domain to the pages.
Blog post: theplaybook.dev/docs/deploy-h...
Repo: github.com/dhij/theplaybook
PaperMod theme installation: github.com/adityatelange/hugo...
Managing a custom domain for Github Pages: docs.github.com/en/pages/conf...
Linking domain to Github Pages: www.namecheap.com/support/kno...

[@dhij]

0:00 Intro
0:33 Install Hugo, create a new site & a page
1:48 Install the PaperMod theme & add the theme in config.yml
3:03 Add minimal content in docs/test.md and run locally
3:52 Create a git repository
4:52 Create a gh-pages branch in the repo *important*
5:20 Set read & write permissions for workflow *important*
5:33 Create the github actions deploy file
6:21 Edit the baseurl in config.yml to .github.io//
7:16 Explain the steps in Github Actions workflow
10:53 Link custom domain to Github Pages

[@staur19]

Very helpful. Thanks for the detailed tutorial!

[@natsudl575]

Thanks for the video. The explanation of the steps were very easy and clear.

[@dhij]

Glad that helped!

[@biboyog]

Appreciated the tutorial!!!!!!

[@GustavAgar]

Thank you so much for your script to make the deployment by github. Just an observation: i had to modify the version of hugo you are using in the script, because it told me that its deprecated that version, so i modify with the last one and it worked flawlessly

[@dhij]

Awesome, glad that helped!

[@canon1cal]

Could you tell where to add this?

[@linarkhilazhev5131]

thanks. good and usefull video.

[@giaochan504]

What CMS would you recommend to connect to the blog?

[@hoosier-daddy465]

Random question - what's the name of the iterm (terminal) theme? I like the way it shows the dates, colors, and branches etc

[@tomvice]

powerlevel10k ohmyzsh

[@TheLightBulp]

Hi , Great video.
Do you happen to know how to enlarge the width of text on pages and posts ? thanks

[@alexcricles]

my hugo site deployed very well, but the look was bad, may I ask you for help?

[@kadewu7291]

I follwing the stps but I don't know why after I created the test.md it doesn't shows in the homepage

[@abhijaiswal312]

it will appear inside contents/docs

[@hoherspatz9573]

wow thanks. I'm a GitHub noob but I always wanted to create my own blog for free.

[@dhij]

Glad that helped!

[@michaelmiller7181]

Thanks for this! I have been trying for days to get Hugo and Github running.
I am stuck at 5:27
Somehow I can not set my workflow permissions to "read and write permissions". The setting is not clickable for me.
Permission denied, fatal: unable to access … and "Process completed with exit code 128".
Can you help me out?

[@dhij]

Hmm, thats weird; is that your own repo though?

[@AshwaniYadavIIT]

Liquid Exception: Liquid syntax error (line 468): Variable '{{??}'
getting this error on action

[@hidayat_pcd]

I had this one too. It's gotta do with Jekyll trying to build the site anyway even though we are using hugo. This is the consequences of using the method in the video.
You can add `touch .nojekyll` to deploy.yml just before `git add .` The site finally builds and gets deployed properly.

[@wannabeAPT]

@@hidayat_pcd dude you are a life saver i was scratching my head for hours on this one, thanks so much!!!!

[@pasza]

Hello. A nice tut. Reproducing the steps, I found a tiny mistake: "--format" should be used instead of "-f". Probably they've changed it.

[@reno2077]

yes. and the config.yaml is changed to hugo.yaml

[@IvanaStastna]

Hello Pasza, I have tried to follow this tut but when I get to 3:33 to run Hugo server to display the site locally, I get a blank screen. I have noticed your comment about --format instead of -f and then @reno2077 comment about the config.yaml being Hugo.yaml now. But still, I get a blank screen. What should I do??? :(

[@faraz2023]

Thanks a lot!

[@CSEAJMALAKRAMS]

How to add content in it..

[@diegoarteaga166]

What would be the ideal work flow for making a new post?

[@dhij]

All you have to do would be to add an md file to your repository and push to the main branch!

[@chris0617]

Tysm :)
Do you know what to do if the images are not displayed?

[@hoherspatz9573]

I have the same problem :(

[@chris0617]

@@hoherspatz9573 i solved it deploying on netlify

[@beenii9373]

Sugo 했엉

[@dhij]

Thank you! 🙂

[@sugoonese4024]

Lol my page just shows a my readme file
is the gh-brand repo meant to not have the same content as main branch? I'm a complete git, github noob
my gh branch just have a readme lmao

[@sugoonese4024]

nvm i restarted everything and jus followed the docs on Hugo and it worked

[@CSEAJMALAKRAMS]

How to add content in it.!? Actually I done all the thing he said.. I want to update daily as well.. Can u do in it..

[@sugoonese4024]

@@CSEAJMALAKRAMS I pushed my website using the steps from Hugo documentations
if I want to make changes I just push a commit to github and it automatically changes the website

[@CSEAJMALAKRAMS]

@@sugoonese4024 thanks bro

[@0xShakhawat]

No url found for submodule path 'themes/PaperMod' in .gitmodules

[@Mike-ie6ku]

did you solve it?

[@0xShakhawat]

@@Mike-ie6ku Yes!! I solved that. But, can't remember right now

[@Mike-ie6ku]

@@0xShakhawat oh(