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

Perplexity AI: The App, For The Everyday Person

   Perplexity AI, according to BuiltIn , is an AI-powered search engine - and it's now valued at 1 8$Billion dollars, with a B. I had it on my phone for research testing - something I do between contracts for money - and simply kept it all this time. With it making a resurgence, I can show you if it's viable for every day use cases.  I did not use it to generate "art" or writing.  Screen Reading and Photo Identification. I have used Perplexity to read Chinese characters on my screen, asking to point out the radicals, tone, and meaning of unfamiliar characters. There are minor differences between what Perplexity answers with and what Duolingo and DuChinese deal with, but I know enough Chinese* to figure out the difference - though a recent study calls the accuracy into question. For instance, below I've asked it what the radical is in  æ°´ (shui, water)      [alt: The character in your image is  æ°´ , which is the Chinese character for "wate...
Post a Comment
Read more

Log Sorting with AWS CloudWatch, AWS CloudWatch Insights

 The cool thing is, I was contracted to make these videos in collaboration with CloudAvail Technology Consulting to help people decide which service they wanted to use for their logging - AWS CloudWatch, AWS CloudWatch Insights, DataDog, or New Relic. I'm searching through nginx logs. I have accompanying videos of each service that you can find on the CloudAvail Youtube page; See these links to go to the DataDog and NewRelic posts.   The idea was to be subjective in the videos, but I can be objective on my personal blog.     CloudWatch     The syntax is odd, but easy to grasp. Sort log data by IP addresses, message codes, and status codes. The simplest query system, but not quite robust.   Insights       The syntax has changed - Vastly. I see major SQL influences. You can see that in how the parse function works - in this case, it's often taken pieces of a pre-existing standard - in this case, message - and breaking them into their own c...
Post a Comment
Read more