Structuring and Preparing Your Blog for Hugo Themes

Table of Contents

Introduction
#

When transitioning to a new Hugo theme, it’s essential to have a well-organized blog structure. This guide will help you merge all your files into a format suitable for the new Hugo theme.

Step 1: Renaming Markdown Files
#

Start by renaming all your Markdown files to index.md for a cleaner structure. Execute the following command in your blog’s root directory:

find . -type f -name "*.md" -exec bash -c 'mv "$0" "${0%/*}/index.md"' {} \;

This simplifies your file structure and aligns it with Hugo’s expectations.

Step 2: Managing Thumbnails
#

For thumbnails, ensure they are named as featured.* for compatibility with your Hugo theme. If your index.md files include URLs for thumbnails, you can use the following script to download and rename them:

#!/bin/bash

find . -type f -name "index.md" -exec awk 'NR<=10 && /thumbnail: .+/{print $2, FILENAME}' {} \; | while read -r url filepath; do
    if [[ $url == https* ]]; then
        url=$(echo "$url" | tr -d '[:space:]')
        filename=$(basename "$url")
        dirpath=$(dirname "$filepath")

        cd "$dirpath" || exit
        wget "$url" -O "./featured.${filename##*.}"

        if [ $? -eq 0 ]; then
            echo "Downloaded and renamed to featured.${filename##*.}"
        else
            echo "Failed to download $filename"
        fi

        cd - || exit
    else
        echo "Skipping non-HTTPS URL: $url"
    fi
done