How to make a website with Hugo and Gitlab

I recently uploaded a video explaining how to make a website using the Hugo Generator and Gitlab’s CI/CD function. Check it out and let me know what you think!

8 Likes

If you had a channel with 1,000 videos I still wouldn’t have expected one that professional.

Welcome to my newsboat, hope it’s not the last video.

Thank you! I appreciate it.

Not entirely sure what to make next. Probably something Ansible or Chezmoi related.

@rwaltr thank you for posting this for a couple of reasons.

  1. I really would like to start my own static site blog using static generator / asciidoc (similar to markdown but my preferred plaintext markup) / github. Your presentation shows me some of the steps that weren’t clicking in my head from other tutorials.
  • I noticed that you have a github account. Is there a reason why you went with gitlab for your blog hosting instead of github pages? Is their tooling better on gitlab?
  1. I checked out your blog and realized that you were the author of the Fedora Magazine article on Chezmoi which was one of my favorite articles on Fedora Magazine recently, so thank you for this article. It got me thinking about actually doing something to manage all of my dotfiles between my different linux boxes. I’ve been using syncthing but I need to manually remember to copy from the home root folder the dotfiles I update into the syncthing folder that gets synced. Your method seems much better, but I would have to break the habit of quickly typing “vim .bashrc or .vimrc”.

  2. You are a Fedora user and it is always fun to find another Fedora user.

  3. You showed “toolbox” in your video which I have never heard of before or seen used, and now I have another new thing to learn :slight_smile:

You are providing great content and lots of food for thought. Your tutorials and articles really make me think, “Self you should get to work on that too! It would be fun and useful.” Thanks for all that you are adding to the Open Source community with your tutorials both in video and written form.

1 Like

@rwaltr this seems like it should be on FPL :smiley: I will send you a PM to discuss this further. :sunglasses: :+1:

1 Like

I really would like to start my own static site blog using static generator / asciidoc… Your presentation shows me some of the steps that weren’t clicking in my head from other tutorials

AsciiDoc is pretty awesome from what I understand from it, You might find Antora intresting.

I noticed that you have a github account. Is there a reason why you went with gitlab for your blog hosting instead of github pages? Is their tooling better on gitlab?

Mostly pedantic, Gitlab is not bound to Microsoft. But I do like how I can self host Gitlab in the future and my workflow would not change too much,

Another reason is that this is really a tutorial to show how Gitlab’s CI/CD works, disguised as a website tutorial. It was originally meant to be a crash course for those who might be shy at TXLF about attending CI/CD talks, thinking that it is much more complex than it is.

I checked out your blog and realized that you were the author of the Fedora Magazine article on Chezmoi which was one of my favorite articles on Fedora Magazine recently, … but I would have to break the habit of quickly typing “vim .bashrc or .vimrc”.

It took me a while to do adopt this as well, I use the Neovim plugin Plug 'Lilja/vim-chezmoi' to help out with that, It allows neovim to instantly apply any changes I make with chezmoi edit <file> sometimes I also just edit directly in the source, you can easily get there using chezmoi cd

You are a Fedora user and it is always fun to find another Fedora user.

Fedora 4 lyfe! :tophat:

Thank you for the Feedback! I’m glad you are enjoying everything! :slight_smile:

Sounds good! We will be in touch.

Really well done. This is exactly what I was looking for to manage an quick and easy website.

One small thing I ran into - I didn’t have a public SSH key, I had to generate one for use with GitLab with,

ssh-keygen -t rsa -C "my_email_here@gmail.com" 
cat ~/.ssh/id_rsa.pub  

then copy the public key to the https://gitlab.com/profile/keys page

After that, I was good to go with the rest of the tutorial.

WordPress was a pain for me and was constantly getting hacked, I tried Google Sites, but found it to be slow and clunky. I already have a bunch of notes and documents I wrote in “Jolpin” and HackMD, and now being able to share those online in such an easy way with Hugo and GitLab is awesome.
Markdown is really easy to learn for new people who are unfamiliar with website creation. It allows you to focus on writing content, without having to worry about all the HTML formatting.

Cheers for contributing to the community. :beer:

1 Like

You could also use https://gitlab.com/supashang/hugotest.git as an upstream, but if you have a basic git config it will prompt you for username/password each time without caching

You might find my https://blackphidora.gitlab.io/rybook project interesting, it uses the same overall CI/CD design as Hugo, but it uses MKDOCS instead. which is a static generator aimed at documents.

There are also themes aimed at documents.

1 Like

Thanks for the feedback, I’ll check it out.

Shoutout to @MichaelTunnell for helping me get my video on Front Page Linux!

3 Likes

Dude! This was an AMAZING video. It helped me fill in the last couple of GitLab configs I needed to automate updates. I was blown away by the quality and professionalism. Great work!

1 Like

Thank you!