Skip to main content

Using Hugo, a Static Website Builder

 Hugo is both a delightful movie from 2011 and a flexible, fast, open source static website builder. I'm no stranger to static websites, so I'm giving it a try! 

 

-> You will need git installed. 

 

Steps.

1. Install Powershell

2. Use Hugo

3. Using a Domain

4.Publishing a Hugo Site (GitHub Pages)

 

 

Installing Powershell

Powershell is not the same as Windows Powershell. I'm using WinGet, the Windows Package Manager. It's a tool that does everything you do in a GUI for Windows Clients, but in the command line.

 WinGet also installs Hugo.

 

Using Hugo

All of this work is in Powershell. 

`hugo new site quickstart` 

The command makes a new folder called quickstart while populating it with the Hugo things we need.

 `git init` 

Initializes git.  

`git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke`

It clones the repo into the quickstart directory.

 `echo "theme = 'ananke'" >> hugo.toml`

 copies the theme to the .toml file.

 `hugo server`

opens the webpage on a localhost link. Mine looks like this;

 

 

 The anaki theme looks similar to whatever theme I have on my Google Site;

 


The steps in the documentation are here.

 

Let's add and populate another page with the following new content command;

` hugo new content content/posts/my-first-post.md` 

 

Names and places the page in the subdirectory content and posts. I open this in VS Code, deep the `draft = true` tag in place, and edit the file with markdown to get this;

 

 Adding a new page and image

 I made a second post with the new content command, moved an image into the assets directory. There were four or five suggestions to how to post an image, and amazingly, none worked for me. 
 
I asked Bluesky, a Slack Channel, and searched Stack Overflow.
 
I put the image in the same directory as the post, in quickstart/static/images, and in quickstart/static. 
 
 
Any suggestions?  

Using a Domain

 `baseURL = 'https://example.org/'` Would do the trick in the toml file.

 I have a domain - it points to another website. Adjusting CNAME records (These tell DNS servers where to send people when they put in runtcpip.com) is a pain, so I will pass for now, but it is easy.  

 Publishing a Hugo Site to GitHub Pages

 After making a repo, first I reinitialize git in the quickstart directory. 

Second, I make a local git repo while putting the files from quickstart in.

 Third, by pushing them from local to the main branch I add the files to the newly made GitHub repo.

With these instructions and this in-depth look at using Git. I couldn't get the images working, so I went through the steps and took it down again.

Closing Thoughts

Was this similar to the old internet? A collection of pages hosted locally, an open port to a directory isolated enough so bad agents did not see your (primitive, at the time) desktop? This was a good exercize in using git to push, add notes, and make a remote repository

Labels:

Comments

Post a Comment

Popular posts from this blog

Making KPI Dashboards with PowerBI

 While this is the free tier, I cannot share or collaborate with others, nor can I publish content to other people's workspaces, but they will not stop me from screenshooting and recording these self-taught adventures,so! I'm doing this because I idly searched "Mattel careers" and "Information Technology", and seeing a bulletpoint saying the following: Analytical and reporting skills such as creating dashboards and establishing KPIs such as experience with PowerBI, Cognos, Tableau, and Google Data Lake/AWS is preferred And thought "Well, I've used Tableau, and I've heard about PowerBI,  even if its in-demandness is questionable , so how similar is it? And can I write about it?"  First, PowerBI (PIB) does have a downloadable, local version, but apparently Windows-only. I could download the .exe but I couldn't run it / drag it to applications on my MacBook.  Not a problem, we'll use the online SaaS version, and a dataset found here, ...
Post a Comment
Read more

A 2-week Trial of T-Mobile Home Internet

     The Xfinity app showed usage of the past 3 months: We used less than 40% each month, for about $80 USD a month.   No thanks! That cuts into the movie budget! Before we save some money (about $15/mo), let's test how T-Mobile Internet unlimited data works for 2 weeks.    There are 15 devices for this test; Smart TVs: 4 Laptops: 4 Printer: 1 Smart Home Speakers: 3 Game Consoles: 1 Phones: 1 (There are other phones in the home but they stick with data) Other: 1 Total : 15  I made tables for 3 entries a day across 3 days to test the Xfinity service we have. Here's one;   Xfinity is pretty speedy - Download times are between 227 - 236 Mbps, Latency between 24.5 - 25.5, Jitter between 5 - 6.68, and 0 packet loss.  Let's quickly define the terms in the table;    Date/Time - The date and time of the data gathered. Download (Mpbs) - How fast your network gets data. Upload (Mbps) - How fast your network uploads data. Latency ...
Post a Comment
Read more

Recon and SSID - Mapping With VisiWave Site Survey

My laptop is refurbished. I've written about how there are a few ... quirks. Being a technology professional, I felt okay with adopting an older machine, knowing I had the skill to fix moderate issues. From dying drivers to monitor massacres, I've ID'd, solved, and documented a lot of issues.  The newest one was my Wi-Fi adapter dropping the connection to a specific extender. While troubleshooting, I was curious about doing recon of WiFi networks and broadcasting devices anyway. That issue? A power setting. It was so determined to save power, it would disconnect. The extender is also flirting with the older end of 6 years old.  The battery needs to be replaced, but that's new to me. As a Windows laptop, there are a plethora of options to pick. How do you decide which one is safest?  I am suddenly concerned about this despite having 3 unofficial, 15$ Macbook Air chargers from eBay, and no explosions. But let's move onto the Site Survey - Where can I find the stronges...
Post a Comment
Read more