Hugo tutorial

.gitignore

@@ -9,4 +9,5 @@ public/
 .vscode
 search-index.json
 redirect_aliases.json
-.Rproj.user
+.Rproj.user
+*.swp

content/topics/Collaborate-share/Share-your-work/Hugo-tutorial/1-index.md

@@ -0,0 +1,33 @@
+---
+type: "hugo-tutorial"
+title: "Hugo Tutorial: Start Here"
+description: "Choose your platform to install Hugo and get started"
+keywords: ["hugo", "static site", "website generator", "markdown", "tutorial"]
+draft: false
+weight: 1
+date: 2025-07-07
+author: "Harold Miesen"
+categories: ["Tutorials"]
+tags: ["hugo", "markdown", "deployment", "static site"]
+---
+
+## Welcome to the Hugo Tutorial
+
+In this step-by-step tutorial, you'll learn how to:
+
+- Install __**Hugo Extended**__ on your platform
+- Create and configure a Hugo site
+- Run a local development server
+- Deploy your static site to a remote server (bonus)
+- Add content to your Hugo site using Markdown and HTML
+
+### Choose Your Installation Platform
+
+Please choose your operating system to begin installation:
+
+- [Install on Windows](../2-install-windows/)
+- [Install on Linux](../3-install-linux/)
+
+Once installed, you may continue to the
+[Using Hugo Guide](../4-launch-site/) for
+building and deploying your site.

content/topics/Collaborate-share/Share-your-work/Hugo-tutorial/2-install-windows.md

@@ -0,0 +1,78 @@
+---
+type: "hugo-tutorial"
+title: "Install Hugo Extended on Windows using winget"
+description: "Instructions for installing Hugo Extended on Windows using winget"
+draft: false
+weight: 2
+date: 2025-07-07
+author: "Harold Miesen"
+---
+
+## Install Hugo Extended on Windows using winget
+
+Use winget to easily install and update the latest system-wide version of Hugo on Windows
+via the command line. __**Winget**__ (Windows Package Manager) is Microsoft’s official
+command-line tool for installing software on Windows, much like brew on macOS or apt on Linux.
+
+### Step 1: Open PowerShell
+
+Search for PowerShell in the Start Menu and open it.
+
+### Step 2: Install Git (if not already installed)
+
+```
+winget install --id Git.Git -e --source winget
+```
+
+> If `git` is not yet installed, the command above will install it.
+
+Check Git installation:
+```
+git --version
+```
+
+You should see a version number if Git is correctly installed.
+
+### Step 3: Install Hugo Extended
+
+Uninstall any previous Hugo version first to avoid conflicts.
+
+```
+winget uninstall Hugo.Hugo.Extended
+```
+
+After removal, check:
+
+```
+hugo version
+```
+
+If Hugo has been succesfully removed from your system, you should see the following error
+message: `hugo : The term 'hugo' is not recognized...`. 
+
+Next, install Hugo Extended by means of the following command:
+
+```
+winget install Hugo.Hugo.Extended
+```
+### Step 4: Confirm Installation
+
+After install, check:
+
+```
+hugo version
+```
+
+You should see a version number if Hugo is correctly installed.
+E.g., `hugo v0.148.2-40c3d8233d4b123eff74725e5766fc6272f0a84d+extended linux/amd64 
+BuildDate=...
+
+Look for `+extended` in the output.
+Hugo Extended is now installed on Windows!
+
+---
+
+Done installing? Proceed to the 
+[Launch Site](../4-launch-site/) page
+or go back to
+[Hugo Tutorial: Start Here](../1-index/).

content/topics/Collaborate-share/Share-your-work/Hugo-tutorial/3-install-linux.md

@@ -0,0 +1,74 @@
+---
+title: "Install Hugo Extended on Linux using snap"
+description: "Install Hugo on a Linux environment using snap"
+draft: false
+weight: 3
+date: 2025-07-07
+author: "Harold Miesen"
+---
+
+## Install Hugo Extended on Linux using snap
+
+Snap is a universal package manager developed by Canonical (the makers of Ubuntu). It allows you to
+install software in isolated containers, which include all necessary dependencies—making it easy
+to run the latest versions of applications across different Linux distributions.
+
+Using snap to install Hugo ensures:
+
+- You get the Extended version by default,
+- Automatic updates,
+- Fewer dependency issues across distros.
+
+### Step 1: Update Your System
+
+```
+sudo apt update && sudo apt upgrade
+```
+
+### Step 2: Install Required Packages
+
+```
+sudo apt install git curl wget tar snapd
+```
+
+> If `git` is not yet installed, the command above will install it.
+> `snapd` is the background service used to manage snap packages.
+
+### Step 2.1: Verify Git Installation
+
+```
+git --version
+```
+
+You should see a version number if Git is correctly installed.
+
+### Step 3: Install Hugo Extended via Snap
+
+```
+sudo snap install hugo --channel=extended --classic
+```
+
+> The `--channel=extended` flag ensures you get the Hugo Extended version (required for SCSS/SASS).
+> The `--classic` flag gives Hugo permission to access the full system, which is necessary for many
+real-world use cases.
+
+### Step 4: Verify Installation
+
+```
+hugo version
+```
+
+You should see output like:
+
+```
+hugo v0.124.1+extended linux/amd64 BuildDate=...
+```
+
+Look for `+extended` in the output.
+Hugo Extended is now installed on Linux!
+
+---
+
+Done installing? Proceed to the 
+[Launch Site](../4-launch-site/) page or go back
+ to [Hugo Tutorial: Start Here](../1-index/).