<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Hugo on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/hugo/</link>
    <description>Recent content in Hugo on D. Sébastien Taggart</description>
    <generator>Hugo</generator>
    <language>en</language>
    <lastBuildDate>Sun, 04 Oct 2026 23:02:59 -0400</lastBuildDate>
    <atom:link href="https://www.sebastientaggart.com/tags/hugo/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Hugo Custom Deployment Script Using rsync With Version Checking</title>
      <link>https://www.sebastientaggart.com/writing/hugo-custom-deployment-script-using-rsync-with-version-checking/</link>
      <pubDate>Tue, 25 Mar 2025 15:09:57 -0400</pubDate>
      <guid>https://www.sebastientaggart.com/writing/hugo-custom-deployment-script-using-rsync-with-version-checking/</guid>
      <description>&lt;p&gt;You know, there are moments in life that spark a bit of annoyance—like when you see double quotes misaligned on a shop sign. My wife has a talent for identifying these little quirks, often asking, &amp;ldquo;Do you know what I hate?&amp;rdquo; It&amp;rsquo;s endearing, really. While I might not keep a formal list of grievances with the world at large, I certainly have a catalog of digital frustrations.&lt;/p&gt;
&lt;p&gt;Take, for example, the maintenance of my personal website. I cherish having a digital space to call my own, but the upkeep? Not so much. After a few weeks away, I find myself grappling with the intricacies of updating git submodules or deciphering the commit hashes that seem to have a vendetta against me. It&amp;rsquo;s enough to make anyone wish for a bit of automation.&lt;/p&gt;</description>
      <content:encoded><![CDATA[<p>You know, there are moments in life that spark a bit of annoyance—like when you see double quotes misaligned on a shop sign. My wife has a talent for identifying these little quirks, often asking, &ldquo;Do you know what I hate?&rdquo; It&rsquo;s endearing, really. While I might not keep a formal list of grievances with the world at large, I certainly have a catalog of digital frustrations.</p>
<p>Take, for example, the maintenance of my personal website. I cherish having a digital space to call my own, but the upkeep? Not so much. After a few weeks away, I find myself grappling with the intricacies of updating git submodules or deciphering the commit hashes that seem to have a vendetta against me. It&rsquo;s enough to make anyone wish for a bit of automation.</p>
<p>So, like any seasoned developer, I channeled my frustration into productivity and crafted a script to make my life easier. Below is a streamlined solution that not only checks the installed versions of Hugo and PaperMod but also updates them if necessary—because who has time for manual updates?</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="cp">#!/bin/bash
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># ===============================================</span>
</span></span><span class="line"><span class="cl"><span class="c1"># Hugo Update &amp; Deployment Script</span>
</span></span><span class="line"><span class="cl"><span class="c1"># ===============================================</span>
</span></span><span class="line"><span class="cl"><span class="c1"># This script checks the installed version of Hugo and PaperMod,</span>
</span></span><span class="line"><span class="cl"><span class="c1"># compares them to the latest available versions, and provides</span>
</span></span><span class="line"><span class="cl"><span class="c1"># an option to update them if an update is available.</span>
</span></span><span class="line"><span class="cl"><span class="c1">#</span>
</span></span><span class="line"><span class="cl"><span class="c1"># Usage:</span>
</span></span><span class="line"><span class="cl"><span class="c1">#   ./deploy.sh            # Default: Checks versions and deploys if up to date</span>
</span></span><span class="line"><span class="cl"><span class="c1">#   ./deploy.sh --help     # Show this help message</span>
</span></span><span class="line"><span class="cl"><span class="c1">#</span>
</span></span><span class="line"><span class="cl"><span class="c1"># How It Works:</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 1. It checks the installed and latest versions of Hugo and PaperMod.</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 2. If both are up to date, the script automatically deploys the site.</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 3. If an update is available, it:</span>
</span></span><span class="line"><span class="cl"><span class="c1">#    - Displays the installed and latest versions.</span>
</span></span><span class="line"><span class="cl"><span class="c1">#    - Asks if you want to update Hugo.</span>
</span></span><span class="line"><span class="cl"><span class="c1">#    - Asks if you want to update PaperMod.</span>
</span></span><span class="line"><span class="cl"><span class="c1">#    - Asks if you want to deploy after updating.</span>
</span></span><span class="line"><span class="cl"><span class="c1">#</span>
</span></span><span class="line"><span class="cl"><span class="c1"># Requirements:</span>
</span></span><span class="line"><span class="cl"><span class="c1"># - Hugo installed and accessible via `hugo version`</span>
</span></span><span class="line"><span class="cl"><span class="c1"># - Homebrew installed (for updating Hugo)</span>
</span></span><span class="line"><span class="cl"><span class="c1"># - Git installed (for checking/updating the PaperMod submodule)</span>
</span></span><span class="line"><span class="cl"><span class="c1">#</span>
</span></span><span class="line"><span class="cl"><span class="c1"># Example Runs:</span>
</span></span><span class="line"><span class="cl"><span class="c1"># - Default behavior (check and deploy if up to date):</span>
</span></span><span class="line"><span class="cl"><span class="c1">#     ./deploy.sh</span>
</span></span><span class="line"><span class="cl"><span class="c1"># - Show help:</span>
</span></span><span class="line"><span class="cl"><span class="c1">#     ./deploy.sh --help</span>
</span></span><span class="line"><span class="cl"><span class="c1"># ===============================================</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to display help message</span>
</span></span><span class="line"><span class="cl">show_help<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    sed -n <span class="s1">&#39;2,34p&#39;</span> <span class="s2">&#34;</span><span class="nv">$0</span><span class="s2">&#34;</span> <span class="p">|</span> sed <span class="s1">&#39;s/# //&#39;</span>
</span></span><span class="line"><span class="cl">    <span class="nb">exit</span> <span class="m">0</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Handle the --help option</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$1</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;--help&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    show_help
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to get installed Hugo version</span>
</span></span><span class="line"><span class="cl">get_installed_hugo_version<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nv">hugo_version</span><span class="o">=</span><span class="k">$(</span>hugo version 2&gt;/dev/null <span class="p">|</span> awk <span class="s1">&#39;{print $2}&#39;</span> <span class="p">|</span> cut -d<span class="s1">&#39;+&#39;</span> -f1<span class="k">)</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;</span><span class="si">${</span><span class="nv">hugo_version</span><span class="p">#v</span><span class="si">}</span><span class="s2">&#34;</span>  <span class="c1"># Remove leading &#39;v&#39; if present</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to get latest stable Hugo version</span>
</span></span><span class="line"><span class="cl">get_latest_hugo_version<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nv">latest_version</span><span class="o">=</span><span class="k">$(</span>curl -s https://api.github.com/repos/gohugoio/hugo/releases/latest <span class="p">|</span> grep <span class="s1">&#39;&#34;tag_name&#34;:&#39;</span> <span class="p">|</span> cut -d <span class="s1">&#39;&#34;&#39;</span> -f 4<span class="k">)</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;</span><span class="si">${</span><span class="nv">latest_version</span><span class="p">#v</span><span class="si">}</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to get installed PaperMod version (commit hash)</span>
</span></span><span class="line"><span class="cl">get_installed_papermod_version<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    git submodule status themes/PaperMod 2&gt;/dev/null <span class="p">|</span> awk <span class="s1">&#39;{print $1}&#39;</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to get the latest PaperMod version (commit hash from the latest release)</span>
</span></span><span class="line"><span class="cl">get_latest_papermod_version<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nv">latest_papermod_tag</span><span class="o">=</span><span class="k">$(</span>curl -s https://api.github.com/repos/adityatelange/hugo-PaperMod/releases/latest <span class="p">|</span> jq -r .tag_name<span class="k">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&#34;</span><span class="nv">$latest_papermod_tag</span><span class="s2">&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        <span class="nb">echo</span> <span class="s2">&#34;Error: Could not fetch latest PaperMod release tag.&#34;</span>
</span></span><span class="line"><span class="cl">        <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="nv">latest_commit</span><span class="o">=</span><span class="k">$(</span>git ls-remote https://github.com/adityatelange/hugo-PaperMod.git <span class="s2">&#34;refs/tags/</span><span class="nv">$latest_papermod_tag</span><span class="s2">^{}&#34;</span> <span class="p">|</span> awk <span class="s1">&#39;{print $1}&#39;</span><span class="k">)</span>
</span></span><span class="line"><span class="cl">    
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&#34;</span><span class="nv">$latest_commit</span><span class="s2">&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        <span class="nb">echo</span> <span class="s2">&#34;Error: Could not retrieve commit hash for latest PaperMod release.&#34;</span>
</span></span><span class="line"><span class="cl">        <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;</span><span class="nv">$latest_commit</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to update Hugo using Homebrew</span>
</span></span><span class="line"><span class="cl">update_hugo<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Updating Hugo...&#34;</span>
</span></span><span class="line"><span class="cl">    brew upgrade hugo <span class="o">||</span> <span class="nb">echo</span> <span class="s2">&#34;Homebrew upgrade failed.&#34;</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to update PaperMod theme</span>
</span></span><span class="line"><span class="cl">update_papermod<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Updating PaperMod to the latest release...&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="nb">cd</span> themes/PaperMod <span class="o">||</span> <span class="o">{</span> <span class="nb">echo</span> <span class="s2">&#34;Error: PaperMod submodule not found.&#34;</span><span class="p">;</span> <span class="nb">exit</span> 1<span class="p">;</span> <span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    git fetch --tags origin
</span></span><span class="line"><span class="cl">    <span class="nv">latest_papermod_tag</span><span class="o">=</span><span class="k">$(</span>curl -s https://api.github.com/repos/adityatelange/hugo-PaperMod/releases/latest <span class="p">|</span> jq -r .tag_name<span class="k">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> -z <span class="s2">&#34;</span><span class="nv">$latest_papermod_tag</span><span class="s2">&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        <span class="nb">echo</span> <span class="s2">&#34;Error: Could not fetch latest PaperMod release tag.&#34;</span>
</span></span><span class="line"><span class="cl">        <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    git checkout <span class="s2">&#34;</span><span class="nv">$latest_papermod_tag</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="nb">cd</span> - &gt;/dev/null
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Committing updated PaperMod submodule reference...&#34;</span>
</span></span><span class="line"><span class="cl">    git add themes/PaperMod
</span></span><span class="line"><span class="cl">    git commit -m <span class="s2">&#34;Updated PaperMod submodule to latest </span><span class="nv">$latest_papermod_tag</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Function to deploy Hugo site</span>
</span></span><span class="line"><span class="cl">deploy_hugo<span class="o">()</span> <span class="o">{</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Deploying Hugo site...&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    hugo --cleanDestinationDir
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> <span class="nv">$?</span> -ne <span class="m">0</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        <span class="nb">echo</span> <span class="s2">&#34;Hugo Build command failed!  Exit...&#34;</span>
</span></span><span class="line"><span class="cl">        <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl">    rsync -av /papermod/public/* root@REMOTESYSTEM/path/to/public_html/ --delete
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> <span class="nv">$?</span> -ne <span class="m">0</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        <span class="nb">echo</span> <span class="s2">&#34;Rsync command failed!  Exit...&#34;</span>
</span></span><span class="line"><span class="cl">        <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl"><span class="o">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Get current and latest versions</span>
</span></span><span class="line"><span class="cl"><span class="nv">installed_hugo_version</span><span class="o">=</span><span class="k">$(</span>get_installed_hugo_version<span class="k">)</span>
</span></span><span class="line"><span class="cl"><span class="nv">latest_hugo_version</span><span class="o">=</span><span class="k">$(</span>get_latest_hugo_version<span class="k">)</span>
</span></span><span class="line"><span class="cl"><span class="nv">installed_papermod_version</span><span class="o">=</span><span class="k">$(</span>get_installed_papermod_version<span class="k">)</span>
</span></span><span class="line"><span class="cl"><span class="nv">latest_papermod_version</span><span class="o">=</span><span class="k">$(</span>get_latest_papermod_version<span class="k">)</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="nv">hugo_outdated</span><span class="o">=</span><span class="nb">false</span>
</span></span><span class="line"><span class="cl"><span class="nv">papermod_outdated</span><span class="o">=</span><span class="nb">false</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Check if updates are needed</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$installed_hugo_version</span><span class="s2">&#34;</span> !<span class="o">=</span> <span class="s2">&#34;</span><span class="nv">$latest_hugo_version</span><span class="s2">&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nv">hugo_outdated</span><span class="o">=</span><span class="nb">true</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$installed_papermod_version</span><span class="s2">&#34;</span> !<span class="o">=</span> <span class="s2">&#34;</span><span class="nv">$latest_papermod_version</span><span class="s2">&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nv">papermod_outdated</span><span class="o">=</span><span class="nb">true</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># If everything is up to date, deploy immediately</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$hugo_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">false</span> <span class="o">&amp;&amp;</span> <span class="s2">&#34;</span><span class="nv">$papermod_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">false</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Hugo and PaperMod are up to date.&#34;</span>
</span></span><span class="line"><span class="cl">    deploy_hugo
</span></span><span class="line"><span class="cl">    <span class="nb">exit</span> <span class="m">0</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Show version differences if any updates are available</span>
</span></span><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s2">&#34;Updates Available:&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$hugo_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">true</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;  - Hugo:&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;      Installed = </span><span class="nv">$installed_hugo_version</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;      Latest    = </span><span class="nv">$latest_hugo_version</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$papermod_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">true</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;  - PaperMod:&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;      Installed = </span><span class="nv">$installed_papermod_version</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;      Latest    = </span><span class="nv">$latest_papermod_version</span><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Prompt the user for updates</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$hugo_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">true</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nb">read</span> -p <span class="s2">&#34;Do you want to update Hugo? (y/n): &#34;</span> update_hugo_choice
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$update_hugo_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;y&#34;</span> <span class="o">||</span> <span class="s2">&#34;</span><span class="nv">$update_hugo_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;Y&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        update_hugo
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$papermod_outdated</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="nb">true</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    <span class="nb">read</span> -p <span class="s2">&#34;Do you want to update PaperMod? (y/n): &#34;</span> update_papermod_choice
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$update_papermod_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;y&#34;</span> <span class="o">||</span> <span class="s2">&#34;</span><span class="nv">$update_papermod_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;Y&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">        update_papermod
</span></span><span class="line"><span class="cl">    <span class="k">fi</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Ask if the user wants to deploy after updating</span>
</span></span><span class="line"><span class="cl"><span class="nb">read</span> -p <span class="s2">&#34;Do you want to deploy the site now? (y/n): &#34;</span> deploy_choice
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> <span class="s2">&#34;</span><span class="nv">$deploy_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;y&#34;</span> <span class="o">||</span> <span class="s2">&#34;</span><span class="nv">$deploy_choice</span><span class="s2">&#34;</span> <span class="o">==</span> <span class="s2">&#34;Y&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">    deploy_hugo
</span></span><span class="line"><span class="cl"><span class="k">else</span>
</span></span><span class="line"><span class="cl">    <span class="nb">echo</span> <span class="s2">&#34;Skipping deployment.&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span></code></pre></div><p>This script is more than just a convenience; it’s a safeguard against the vagaries of version management and deployment. By automating these processes, we can reclaim time and mental energy—allowing us to focus on what truly matters: creating and sharing our ideas. So, the next time you find yourself frustrated by a minor detail, remember: there’s always a way to streamline your workflow. Happy scripting!</p>
]]></content:encoded>
    </item>
    <item>
      <title>Step-by-Step Guide to Install Hugo on a Mac Using Homebrew</title>
      <link>https://www.sebastientaggart.com/writing/step-by-step-guide-to-install-hugo-on-a-mac-using-homebrew/</link>
      <pubDate>Sun, 12 Jun 2022 07:45:52 -0500</pubDate>
      <guid>https://www.sebastientaggart.com/writing/step-by-step-guide-to-install-hugo-on-a-mac-using-homebrew/</guid>
      <description>&lt;p&gt;Hugo is a powerful static site generator built with Go, designed for those who crave flexibility and control over their web applications. Whether you&amp;rsquo;re a blogger, developer, or a tech enthusiast, Hugo offers a streamlined way to bring your ideas to life online.&lt;/p&gt;
&lt;h2 id=&#34;what-is-homebrew&#34;&gt;What is Homebrew?&lt;/h2&gt;
&lt;p&gt;Homebrew is a widely-used package manager for macOS that simplifies the software installation process. Think of it as the Swiss Army knife for your Mac—one command can install a plethora of software, saving you from the drudgery of lengthy setups and configurations.&lt;/p&gt;</description>
      <content:encoded><![CDATA[<p>Hugo is a powerful static site generator built with Go, designed for those who crave flexibility and control over their web applications. Whether you&rsquo;re a blogger, developer, or a tech enthusiast, Hugo offers a streamlined way to bring your ideas to life online.</p>
<h2 id="what-is-homebrew">What is Homebrew?</h2>
<p>Homebrew is a widely-used package manager for macOS that simplifies the software installation process. Think of it as the Swiss Army knife for your Mac—one command can install a plethora of software, saving you from the drudgery of lengthy setups and configurations.</p>
<h2 id="prerequisites">Prerequisites</h2>
<p>Before diving into the installation, ensure you have a Mac running macOS and Homebrew installed. If you haven&rsquo;t set up Homebrew yet, head over to the <a href="https://brew.sh">Homebrew website</a> and follow their straightforward installation instructions.</p>
<h2 id="installing-hugo-using-homebrew">Installing Hugo Using Homebrew</h2>
<p>With Homebrew ready to go, let’s get Hugo up and running. Open your terminal and follow these steps:</p>
<h3 id="step-1--update-homebrew">Step 1 – Update Homebrew</h3>
<p>First things first—make sure your Homebrew is up-to-date. This ensures you’re working with the latest packages:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">brew update
</span></span></code></pre></div><h3 id="step-2--install-hugo">Step 2 – Install Hugo</h3>
<p>Now, let’s install Hugo. Simply run the following command in your terminal:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">brew install hugo
</span></span></code></pre></div><p>Once the installation is complete, you can verify that everything went smoothly by checking the installed version of Hugo:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo version
</span></span></code></pre></div><p>You should see the version number displayed, confirming that Hugo is ready for action.</p>
<h2 id="basic-hugo-commands">Basic Hugo Commands</h2>
<p>With Hugo installed, you’re poised to create dynamic web content. Here are a few essential commands to kickstart your journey:</p>
<ul>
<li>
<p><strong>Create a New Site</strong><br>
To set up a new Hugo site, use the following command, replacing <code>[site_name]</code> with your desired name:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new site <span class="o">[</span>site_name<span class="o">]</span>
</span></span></code></pre></div><p>Example:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new site myFirstSite
</span></span></code></pre></div></li>
<li>
<p><strong>Create New Content</strong><br>
To create new content, such as a blog post, use this command. Simply replace <code>[path_to_content]</code> with your preferred path and filename:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new <span class="o">[</span>path_to_content<span class="o">]</span>
</span></span></code></pre></div><p>Example:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new posts/myFirstPost.md
</span></span></code></pre></div></li>
<li>
<p><strong>Start the Hugo Server</strong><br>
To see your site in action, start the Hugo server with the command below. Your site will be accessible at <code>http://localhost:1313</code>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo server
</span></span></code></pre></div></li>
</ul>
<p>With Hugo installed and these commands at your disposal, you’re well on your way to crafting fast, efficient web content. Whether you&rsquo;re focused on personal blogging, developing comprehensive web applications, or simply exploring programming concepts, the world of Hugo is yours to navigate.</p>
<p>Happy coding!</p>
]]></content:encoded>
    </item>
    <item>
      <title>Streamlining Hugo Post Creation with Bash</title>
      <link>https://www.sebastientaggart.com/writing/bash-helper-script-to-create-hugo-academic-posts/</link>
      <pubDate>Tue, 11 Aug 2020 12:46:08 +0000</pubDate>
      <guid>https://www.sebastientaggart.com/writing/bash-helper-script-to-create-hugo-academic-posts/</guid>
      <description>If you find it annoying to have to manually create a specific directory structure every time you want to create a post in Hugo using the Academic theme, then you need this simple bash script to do the steps for you!</description>
      <content:encoded><![CDATA[<p>Creating content in Hugo using the Academic Theme can sometimes feel like navigating a maze of directories and file structures. As a seasoned technical program manager, I’ve experienced firsthand the inefficiencies that can arise from a seemingly straightforward process. Let&rsquo;s explore how we can simplify the creation of new posts and reclaim our time for more meaningful tasks.</p>
<h3 id="the-challenge">The Challenge</h3>
<p>Hugo&rsquo;s Academic Theme imposes a specific directory structure that, while logical, can feel contrived. If you&rsquo;ve ever attempted to create a new post, you might have found yourself facing a series of steps that can lead to errors if not executed with precision:</p>
<ol>
<li>Create a directory with a URL-friendly name (no spaces or special characters).</li>
<li>Create a subdirectory for assets.</li>
<li>Create an <code>index.md</code> file with the necessary front matter.</li>
<li>Modify <code>index.md</code> to include the title, summary, and other details.</li>
</ol>
<p>The multi-step process can become tedious, especially when a simple solution is at hand.</p>
<h3 id="why-it-matters">Why It Matters</h3>
<p>In the world of content creation, efficiency is key. It’s not just about saving time; it’s about enabling creativity and reducing friction in the workflow. By streamlining the post creation process, we empower ourselves to focus on what truly matters: crafting compelling content that resonates with our audience.</p>
<h3 id="a-simple-solution">A Simple Solution</h3>
<p>Imagine if you could condense all those steps into a single command. Enter our Bash script, which automates the creation of a new post with just one line:</p>
<pre tabindex="0"><code>./new &#34;Title of My Awesome New Post&#34;
</code></pre><p>This script does the heavy lifting for you, setting up the necessary directory structure and pre-filling your <code>index.md</code> file with the appropriate front matter.</p>
<p>Here’s how the magic happens:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="cp">#!/bin/bash
</span></span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Script to create a new post for Hugo Academic&#39;s expected directory structure.</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="nv">TARGETDIR</span><span class="o">=</span><span class="s2">&#34;./content/post&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Ensure a title is provided</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[</span> -z <span class="s2">&#34;</span><span class="nv">$1</span><span class="s2">&#34;</span> <span class="o">]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">  <span class="nb">echo</span> <span class="s1">&#39;You must supply a post title, e.g.&#39;</span>
</span></span><span class="line"><span class="cl">  <span class="nb">echo</span> <span class="s1">&#39;  ./new &#34;The Cool Title of My New Post&#34;&#39;</span>
</span></span><span class="line"><span class="cl">  <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Sanitize the input for directory naming</span>
</span></span><span class="line"><span class="cl"><span class="nv">TITLE</span><span class="o">=</span><span class="si">${</span><span class="nv">1</span><span class="si">}</span>
</span></span><span class="line"><span class="cl"><span class="nv">SANIN</span><span class="o">=</span><span class="si">${</span><span class="nv">1</span><span class="p">// /-</span><span class="si">}</span>
</span></span><span class="line"><span class="cl"><span class="nv">SANIN</span><span class="o">=</span><span class="si">${</span><span class="nv">SANIN</span><span class="p">//_/-</span><span class="si">}</span>
</span></span><span class="line"><span class="cl"><span class="nv">SANIN</span><span class="o">=</span><span class="si">${</span><span class="nv">SANIN</span><span class="p">//[^a-zA-Z0-9</span><span class="se">\-</span><span class="p">]/</span><span class="si">}</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Pre-fill the new file with Hugo Academic theme Front Matter</span>
</span></span><span class="line"><span class="cl"><span class="nv">ISOTIME</span><span class="o">=</span><span class="k">$(</span>date -u +<span class="s1">&#39;%Y-%m-%dT%H:%M:%SZ&#39;</span><span class="k">)</span>
</span></span><span class="line"><span class="cl"><span class="nv">PREFILLTPL</span><span class="o">=</span><span class="s2">&#34;---
</span></span></span><span class="line"><span class="cl"><span class="s2">title: &#39;</span><span class="si">${</span><span class="nv">TITLE</span><span class="si">}</span><span class="s2">&#39;
</span></span></span><span class="line"><span class="cl"><span class="s2">subtitle: &#39;&#39;
</span></span></span><span class="line"><span class="cl"><span class="s2">summary: 
</span></span></span><span class="line"><span class="cl"><span class="s2">authors:
</span></span></span><span class="line"><span class="cl"><span class="s2">tags:
</span></span></span><span class="line"><span class="cl"><span class="s2">categories:
</span></span></span><span class="line"><span class="cl"><span class="s2">date: \&#34;</span><span class="si">${</span><span class="nv">ISOTIME</span><span class="si">}</span><span class="s2">\&#34;
</span></span></span><span class="line"><span class="cl"><span class="s2">lastmod: \&#34;</span><span class="si">${</span><span class="nv">ISOTIME</span><span class="si">}</span><span class="s2">\&#34;
</span></span></span><span class="line"><span class="cl"><span class="s2">draft: false
</span></span></span><span class="line"><span class="cl"><span class="s2">projects: []
</span></span></span><span class="line"><span class="cl"><span class="s2">---
</span></span></span><span class="line"><span class="cl"><span class="s2">&#34;</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Create directories and files if they don&#39;t exist</span>
</span></span><span class="line"><span class="cl"><span class="k">if</span> <span class="o">[[</span> ! -e <span class="s2">&#34;</span><span class="si">${</span><span class="nv">TARGETDIR</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">SANIN</span><span class="si">}</span><span class="s2">/&#34;</span> <span class="o">]]</span><span class="p">;</span> <span class="k">then</span>
</span></span><span class="line"><span class="cl">  mkdir -p <span class="s2">&#34;</span><span class="si">${</span><span class="nv">TARGETDIR</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">SANIN</span><span class="si">}</span><span class="s2">/assets/&#34;</span>
</span></span><span class="line"><span class="cl">  touch <span class="s2">&#34;</span><span class="si">${</span><span class="nv">TARGETDIR</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">SANIN</span><span class="si">}</span><span class="s2">/index.md&#34;</span>
</span></span><span class="line"><span class="cl">  <span class="nb">echo</span> <span class="s2">&#34;</span><span class="si">${</span><span class="nv">PREFILLTPL</span><span class="si">}</span><span class="s2">&#34;</span> &gt;&gt; <span class="s2">&#34;</span><span class="si">${</span><span class="nv">TARGETDIR</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">SANIN</span><span class="si">}</span><span class="s2">/index.md&#34;</span>
</span></span><span class="line"><span class="cl"><span class="k">else</span>
</span></span><span class="line"><span class="cl">  <span class="nb">echo</span> <span class="s2">&#34;The directory </span><span class="si">${</span><span class="nv">TARGETDIR</span><span class="si">}</span><span class="s2">/</span><span class="si">${</span><span class="nv">SANIN</span><span class="si">}</span><span class="s2">/ already exists! Aborting.&#34;</span>
</span></span><span class="line"><span class="cl">  <span class="nb">exit</span> <span class="m">1</span>
</span></span><span class="line"><span class="cl"><span class="k">fi</span>
</span></span></code></pre></div><h3 id="how-to-implement">How to Implement</h3>
<ol>
<li>Create a text file named <code>new</code> in your Hugo root directory.</li>
<li>Paste the script above into this file and save it.</li>
<li>Run <code>chmod +x new</code> to make the script executable.</li>
<li>Execute the script with your desired post title using <code>./new &quot;Name of My New Post&quot;</code>.</li>
</ol>
<p>And just like that, you’ve automated a repetitive task, allowing you to shift your focus back to what you do best: creating engaging content.</p>
<h3 id="final-thoughts">Final Thoughts</h3>
<p>This simple Bash script is more than just a tool; it’s a reminder that technology, when used thoughtfully, can enhance our creative processes. By approaching our workflows with curiosity and a willingness to iterate, we can continuously improve our efficiency and the quality of our output.</p>
<p>So, the next time you find yourself bogged down by repetitive tasks, consider how you might simplify, streamline, and innovate. After all, progress isn’t just about moving forward; it’s about finding smarter ways to navigate the journey.</p>
]]></content:encoded>
    </item>
    <item>
      <title>Hugo for Beginners</title>
      <link>https://www.sebastientaggart.com/writing/hugo-for-beginners/</link>
      <pubDate>Fri, 20 Dec 2019 20:58:11 -0500</pubDate>
      <guid>https://www.sebastientaggart.com/writing/hugo-for-beginners/</guid>
      <description>&lt;p&gt;Hugo is a powerful static site generator that stands out for its speed and simplicity. If you’re looking to create a website quickly and efficiently, you&amp;rsquo;ve landed in the right place.&lt;/p&gt;
&lt;h3 id=&#34;quickstart&#34;&gt;Quickstart&lt;/h3&gt;
&lt;p&gt;Let’s get you up and running:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Clone the Repository&lt;/strong&gt;&lt;br&gt;
Start by cloning the repository:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git clone &amp;lt;this repository&amp;gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Initialize Submodules&lt;/strong&gt;&lt;br&gt;
Update your local copy of the academic theme:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git submodule init  
&lt;/span&gt;&lt;/span&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;git submodule update --recursive --remote  
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Install Hugo&lt;/strong&gt;&lt;br&gt;
If you&amp;rsquo;re using Homebrew, a simple installation command will suffice:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; class=&#34;chroma&#34;&gt;&lt;code class=&#34;language-bash&#34; data-lang=&#34;bash&#34;&gt;&lt;span class=&#34;line&#34;&gt;&lt;span class=&#34;cl&#34;&gt;brew install hugo  
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;/ol&gt;</description>
      <content:encoded><![CDATA[<p>Hugo is a powerful static site generator that stands out for its speed and simplicity. If you’re looking to create a website quickly and efficiently, you&rsquo;ve landed in the right place.</p>
<h3 id="quickstart">Quickstart</h3>
<p>Let’s get you up and running:</p>
<ol>
<li>
<p><strong>Clone the Repository</strong><br>
Start by cloning the repository:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">git clone &lt;this repository&gt;
</span></span></code></pre></div></li>
<li>
<p><strong>Initialize Submodules</strong><br>
Update your local copy of the academic theme:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">git submodule init  
</span></span><span class="line"><span class="cl">git submodule update --recursive --remote  
</span></span></code></pre></div></li>
<li>
<p><strong>Install Hugo</strong><br>
If you&rsquo;re using Homebrew, a simple installation command will suffice:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">brew install hugo  
</span></span></code></pre></div></li>
</ol>
<h3 id="running-your-site-locally">Running Your Site Locally</h3>
<p>To see your work in action, launch the site locally:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo serve  
</span></span></code></pre></div><p>You can view it at <a href="http://localhost:1313/">http://localhost:1313/</a>. To stop the server, simply press <code>Ctrl + C</code>.</p>
<p>If you encounter caching issues, consider using the following command:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo serve --disableFastRender --disableLiveReload --gc  
</span></span></code></pre></div><p>When you&rsquo;re ready to deploy, push your changes to the <code>master</code> branch to trigger a build.</p>
<h3 id="creating-content">Creating Content</h3>
<p>Creating new posts is straightforward. Use this command:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new post/&lt;long-name-of-post&gt;/  
</span></span></code></pre></div><p>For instance, to create a post about terminal configuration on macOS, you could run:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">hugo new post/configuring-the-perfect-terminal-experience-in-osx/  
</span></span></code></pre></div><p>This will generate an <code>_index.md</code> file within the &ldquo;posts&rdquo; directory, complete with a preconfigured structure ready for your content.</p>
<h3 id="upgrading-hugo">Upgrading Hugo</h3>
<p>To keep your Hugo installation current, simply run:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">brew upgrade hugo  
</span></span></code></pre></div><p>If you installed via a different method, check the <a href="https://gohugo.io/getting-started/installing/">Hugo documentation</a> for guidance. For upgrading the Academic theme itself, follow the same principles.</p>
<p>For a comprehensive list of content management tips and available fields, refer to <a href="https://sourcethemes.com/academic/docs/managing-content/">this documentation</a>.</p>
<h3 id="understanding-categories-and-tags">Understanding Categories and Tags</h3>
<p>You might be wondering about the difference between <strong>Categories</strong> and <strong>Tags</strong>. While they are functionally similar—both serve as Hugo taxonomies—there are some distinctions worth noting:</p>
<ul>
<li>
<p><strong>Tags</strong>: These act as “Topics” in the word cloud on the homepage and are displayed as links at the bottom of individual posts. For example, clicking on a tag like <code>/tags/bash/</code> will lead to a listing page of related posts.</p>
</li>
<li>
<p><strong>Categories</strong>: Think of categories as broader groupings. They allow users to filter posts and are clickable links displayed on posts, including on previews on your homepage.</p>
</li>
</ul>
<p>Here’s how you can structure them in your front matter for clarity:</p>
<pre tabindex="0"><code>---
categories: [&#39;OSX&#39;]
tags: [&#39;OSX Tweaking&#39;, &#39;TEST&#39;]
---
</code></pre><h3 id="the-academic-theme">The Academic Theme</h3>
<p>If you&rsquo;re using the Academic theme, you can find more details here: <a href="https://sourcethemes.com/academic/">Academic Theme Homepage</a> and <a href="https://github.com/gcushen/hugo-academic">GitHub Repository</a>.</p>
<h3 id="handling-images">Handling Images</h3>
<p>When working with images in the Academic theme, follow this structure:</p>
<ul>
<li>Place your images in the <code>./assets</code> directory.</li>
<li>Use relative links in your markdown, like this:<br>
<code>![](assets/my-image.png)</code></li>
</ul>
<p>Many markdown editors, such as Typora and Atom, can be configured to follow this setup automatically.</p>
<h4 id="typora-example">Typora Example</h4>
<p><img alt="Typora Configuration" loading="lazy" src="/writing/hugo-for-beginners/assets/index-6a260c96.png"></p>
<h4 id="atom-example">Atom Example</h4>
<p>As you embark on your Hugo journey, remember that experimentation is key. Embrace the learning process, and don’t hesitate to explore the rich ecosystem that Hugo offers. Happy building!</p>
]]></content:encoded>
    </item>
  </channel>
</rss>
