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.de...
Repo: github.com/dhi...
PaperMod theme installation: github.com/adi...
Managing a custom domain for Github Pages: docs.github.co...
Linking domain to Github Pages: www.namecheap....

[@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

[@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?

[@wa2k360]

Thanks for the comment bro, helped me out.

[@natsudl575]

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

[@dhij]

Glad that helped!

[@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!

[@staur19]

Very helpful. Thanks for the detailed tutorial!

[@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

[@biboyog]

Appreciated the tutorial!!!!!!

[@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!!!!

[@hoherspatz9573]

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

[@dhij]

Glad that helped!

[@linarkhilazhev5131]

thanks. good and usefull video.

[@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

[@TheLightBulp]

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

[@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?

[@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

[@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!

[@_elifilen]

I followed all the steps (I had to change some commandes becouse I don"t have touch and vim ) but it give a blank page. also my project folder didn't upload

[@dhij]

i could take a look if you have a public github repo 👍

[@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

[@alexcricles]

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

[@giaochan504]

What CMS would you recommend to connect to the blog?

[@wa2k360]

My paper theme is insanely broken for some reason

[@dhij]

:(

[@wa2k360]

@@dhij Lol it's like the css isn't getting pushed somehow

[@faizanmohammed7687]

Couldn't do it, it sucks how confusing git and github is. actions and all.

[@dhij]

oh no, do take your time to learn one thing at a time! let me know if you have any specific question 👍

[@DesignerYeb]

Sugo 했엉

[@dhij]

Thank you! 🙂

[@CSEAJMALAKRAMS]

How to add content in it..

[@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(