Setting up this Blog
Hugo is the static site generator I’m using for this blog. Here’s how I installed it on my Windows computer:
- Went to https://gohugo.io/getting-started/installing
- Decided to just download the binary (as opposed to using a package manager), so went to https://github.com/gohugoio/hugo/releases to download the ZIP file.
- Found there was a “regular” Hugo and a hugo_extended. Decided to use “regular” (find out why below).
- Downloaded the ZIP and copied the extracted folder to c:\program files
- Added the full path of that folder to the PATH environment variable
Initializing the blog
After having installed Hugo I can now use it to initialize my blog. The steps listed below resulted in a working blog containing the single post
- Opened CMD, cd’ed into the directory I wanted to put my new site into and entered
hugo new site adw1blog
- A new directory
adw1blogwas created and in the CMD window some helpful info about next steps were displayed
- Added .gitignore file to the
- Went to look for a theme at https://themes.gohugo.io. Overwhelmed with choice.
- After comparing themes according to a weighted criteria matrix I decided to use the minimo theme.
- Cd’ed into
adw1blogand executed the
git submodule addfor the theme as in
git submodule add https://github.com/mismith0227/hugo_theme_pickles themes/hugo_theme_pickles
- Added the line
theme = "hugo_theme_pickles"to
- Created a new post by entering
hugo new posts/setting-up-this-blog.md. Note that the
.mdis important. If you forget it, Hugo will not include this post when generating the site.
hugo server -D
- Opened the indicated URL (e.g.
http://localhost:1313/) in the browser
- Blog landing page appeared
adw1blog/staticfolder and set
favicon = "favicon.ico"in the
- There is no need to install the Go programming language and tools to use hugo.
- Hugo is just one file: hugo.exe. (How nice is that!)
Regular vs Extended Hugo
There is a “regular” and an “extended” version of Hugo. What’s the difference?
On the Hugo Q & A Site, user “bep” (the leader of the Hugo project) says:
- The extended version is only needed if you want to do SASS/SCSS changes.
- PostCSS support is in the regular version
- You can use themes that use SASS/SCSS with the regular version provided that they have added the compiled styles to /resources in the theme