Categories: Hugo-Sewing

---

Hugo-Sewing is a simple, clean, and flexible Hugo theme suitable for personal blogs and group websites.

Background

Hugo-Sewing is heavily based on Hugo-Xmin, with modifications mainly inspired by Shayan Hosseini’s website, Hugo-Astatine-Theme, and Hugo-Holy:

• The base of Hugo-ht is Yihui Xie’s Hugo-Xmin.
• The academic layout (“Home”, “Project”, “Publication”, and “People”) is modified the code from Shayan Hosseini’s website by Shayan Hosseini and Hugo-Astatine-Theme by Hugo Cisneros
• The visual styles (navigation, index list, and footer) based on the Hugo-Holy theme by SerKo.
• Markdown style based on Hugo-HT theme by Hongtao Hao.
• Shortcode ported from: tutorial by https://www.sleepymoon.cyou/ and tutorial by https://fourxiajiao.github.io/.
• Toc style ported from: tutorial by Kevin Xu.
• ……

This amalgamation of influences led to the name “Hugo-Sewing,” symbolizing the process of intricately stitching together these diverse elements to create a cohesive theme.

Installation

This theme requires Hugo Extended >= 0.128.0.

Note: If you encounter a “443: Timed out” error when using either method, it’s likely due to internet connectivity issues. In that case, you can download the repository and place the hugo-sewing folder inside the themes directory. Then, simply copy the files from hugo-sewing/exampleSite to the root folder and run hugo server -D.

Direct Clone

hugo new site demosite
cd demosite/themes
git clone https://github.com/HaiyanKong/hugo-sewing
cd ..
cp -r themes/hugo-sewing/exampleSite/* .

hugo server -D

Then, open http://localhost:1313/, then you will see the website.

Submodule

You can also add hugo-sewing as a submodule:

hugo new site demosite
cd demosite
git init
git submodule add https://github.com/HaiyanKong/hugo-sewing.git themes/hugo-sewing
cp -r themes/hugo-sewing/exampleSite/* .

hugo server -D

Then, open http://localhost:1313/, then you will see the website.

Update with submodule

cd themes/hugo-sewing
git checkout main && git pull
cd ..
git add hugo-sewing
git commit -m "updating submodule to latest"
cd ..

The above code copied from hongtaoh/hugo-ht The difference between two methods:

If you add it as a submodule, the hugo-sewing theme you use is connected to this repository. The benefit is that you can keep it updated, but there is a caveat: if you make lots of changes to the styles based on your personal preferences, these changes might be lost.

Simply git clone is recommended if:

• You pretty satisfied with the current version of hugo-sewing; and/or
• You are going to make changes according to your personal taste; and/or
• You are not familiar with Git and do not know how to update the submodule.

To update the submodule, run the following codes at the root directory of your hugo project:

cd themes/hugo-sewing
git checkout main && git pull
cd ..
git add hugo-ht
git commit -m "updating submodule to latest"
cd ..

The above codes came from paularmstrong.

---