<?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>Academic Theme on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/academic-theme/</link>
    <description>Recent content in Academic Theme 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/academic-theme/index.xml" rel="self" type="application/rss+xml" />
    <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>
  </channel>
</rss>
