<?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>Static Site Generators on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/static-site-generators/</link>
    <description>Recent content in Static Site Generators on D. Sébastien Taggart</description>
    <generator>Hugo</generator>
    <language>en</language>
    <lastBuildDate>Sun, 04 Oct 2026 22:13:05 -0400</lastBuildDate>
    <atom:link href="https://www.sebastientaggart.com/tags/static-site-generators/index.xml" rel="self" type="application/rss+xml" />
    <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>
