Hugo - My First Post - Using Hugo with GitHub Pages

This is my first Hugo/GitHub Pages post. And here is how it was done.

Initial setup

1. Install Chocolatey

   1. Open Elevated PowerShell prompt

   Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
   

2. Install Hugo using Chocolatey

   1. From Elevated PowerShel prompt

   choco install hugo
   

3. Create a GitHub repo to host your site

4. Create a Hugo Static site in a local folder

   hugo new site mySubdomain.myDomain.com
   

5. Use the Hugo quickstart guide to fill in the blanks https://gohugo.io/getting-started/quick-start/

6. Make sure to add a theme!

   git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke;\
   echo 'theme = "ananke"' >> config.toml
   

7. Add a post

   hugo new posts/my-first-post.md
   

8. Edit the .toml file to fix it up for GitHub https://gohugo.io/hosting-and-deployment/hosting-on-github/

   • publishDir = "docs"
   • baseURL = "http://blog.lukebtaylor.com/"

9. Start the Hugo server locally with drafts enabled

   hugo server -D
   

10. Build with Hugo

    hugo
    

11. Add the static site folder to Git

    git add --all
    

12. Commit the changes

    git commmit -m "my first hugo post"
    

13. Push it to Git

    git push -u origin master
    

14. Get up the repo as a GitHub Page

15. Set up DNS to point to new repo

16. End

Adding content

1. Add your content using Hugo

2. Rebuild using hugo

3. When you’re satisfied git add --all

4. git commit -m "I made a new post"

5. git push -u origin master

Next Steps

Automated builds with Travis CI