0.1.0 development

Author: commitconfirmed

README.md

@@ -1,15 +1,15 @@
 # commitconfirmed.github.io
-Personal Blog using Hugo
 
+My own personal blog. Visit https://commitconfirmed.github.io for the page.
 
-# Random notes
+If you would like to create your own Blog on GitHub pages, see https://commitconfirmed.github.io/posts/hugo-github-pages-starter and the associated starter respository https://github.com/commitconfirmed/hugo-git-pages-starter 
 
-Added the below to the tailwind theme as I wanted a title (layouts/partials/header.html)
+## Random notes
 
-``` html
-  {{ if .Site.Params.header.title }}
-  <div class="hidden md:flex items-center px-2 text-3xl bold text-slate-800 dark:text-slate-200 ">
-    {{ .Site.Params.header.title }}
-  </div>
-  {{ end }}
+Files to update when updating the Hugo version
+
+```bash
+Dockerfile
+.github/worksflows/hugo.yml
+.devcontainer/Dockerfile
 ```

site/content/about/index.md

@@ -1,7 +1,13 @@
 +++
 title = "About"
 description = "About Me"
-date = "2025-03-12"
+date = "2025-03-25"
+tags = [
+    "personal",
+]
+categories = [
+    "personal",
+]
 +++
 
 Testing about page

site/content/posts/hugo-github-pages-starter/images/hugo-giscus-1.png

@@ -11,7 +11,7 @@ tags = [
 categories = [
     "hugo",
 ]
-series = ["Hugo"]
+series = ["Hugo Blog"]
 +++
 
 ## Introduction
@@ -24,12 +24,12 @@ This guide in particular uses a Tailwind CSS theme (ironically called [Tailwind]
 
 - Create a GitHub account
 - Create a new public repo called **username**.github.io replacing username your GitHub username 
-- Clone this repo into your repo
+- Clone my [repo](https://github.com/commitconfirmed/hugo-git-pages-starter) into your repo
 - Update the `~/site/hugo.toml` file with your own personal details
 - Update the `~/site/content/about/index.md` file with your own personal details
 - See the `~/site/content/posts/` directory for an example blog bost. 
   - Create a new folder and `index.md` file to make your own blog post
-- Update your repos Settings/Pages to deploy using Github Actions and create a workflow using the `~/.github/workflows/hugo.yml` file 
+- Update your repos Settings/Pages to deploy using Github Actions and create a workflow using the provided `~/.github/workflows/hugo.yml` file 
   - See the Hugo [Documentation](https://gohugo.io/host-and-deploy/host-on-github-pages/) for detailed instructions
 - Commit some changes and push to Main and your blog should now be available at https://username.github.io
 
@@ -454,3 +454,42 @@ Commit and push these changes.
 
 ### Giscus
 
+Hugo and this theme support comments using giscus. To enable this follow the instructions at https://giscus.app/
+
+When installing the app set it to your username.github.io repository. Once done just enter your repository and it should validate
+
+<img src=./images/hugo-giscus-1.png alt="Giscus Settings #1">
+
+You can ignore the rest of the settings and scroll down to the enable giscus section where you can retrieve your repo, repoID and categoryID
+
+<img src=./images/hugo-giscus-2.png alt="Giscus Settings #1">
+
+Insert the below into your `hugo.toml` params section, replacing the repo, repoID and categoryID with your own
+
+```toml
+  [params.giscus]
+    enabled = true
+    repo = "username/username.github.io"
+    repoID = "R_#####"
+    category = "Announcements"
+    categoryID = "DIC_####"
+    mapping = "pathname"
+    strict = "0"
+    reactionsEnabled = "1"
+    emitMetadata = "0"
+    inputPosition = "bottom"
+    lang = "en"
+```
+
+### Google Analytics
+
+Hugo and this theme support Google Analytics. To enable this create an account at https://analytics.google.com/ then set up a tag for your github.io site. Once setup you'll have a G-XXXXXXXXXX tag which you can put into your `hugo.toml` file
+
+<u>hugo.toml</u>
+
+```toml
+[services]
+  [services.googleAnalytics]
+    ID = "G-XXXXXXXXXX"
+```
+

site/content/posts/hugo-github-pages-starter/images/hugo-giscus-2.png

@@ -7,6 +7,7 @@ languageCode = "en"
 theme = "tailwind"
 enableRobotsTXT = true
 enableEmoji = true
+minify = false
 
 [markup]
   _merge = "deep"
@@ -29,6 +30,19 @@ enableEmoji = true
     since = 2025
     poweredby = true
 
+  [params.giscus]
+    enabled = true
+    repo = "username/username.github.io"
+    repoID = "R_kgDOOC1M0Q"
+    category = "Announcements"
+    categoryID = "DIC_kwDOOC1M0c4Cnijk"
+    mapping = "pathname"
+    strict = "0"
+    reactionsEnabled = "1"
+    emitMetadata = "0"
+    inputPosition = "bottom"
+    lang = "en"
+
     [[params.social_media.items]]
       enabled = true
       title = 'Bluesky'
@@ -67,4 +81,9 @@ series = "series"
 
 [caches]
   [caches.images]
-    dir = ':cacheDir/images'
+    dir = ':cacheDir/images'
+
+[services]
+  [services.googleAnalytics]
+    ID = "G-TMR5HQPCWP"
+