Hugo on Svtter's Blog

Hugo Admin - A Lightweight Hugo Blog Management Interface

Tue, 23 Dec 2025 16:00:00 +0800

When managing a Hugo blog, you often need to switch back and forth between the terminal and editor. To simplify this process, I developed hugo-admin, a lightweight web management interface based on Flask.

Why It’s Needed

The typical workflow for writing Hugo blogs is:

Execute hugo new post/xxx.md in terminal
Open the file with an editor to write content
Start hugo server in terminal to preview
Switch to browser to check the effect
If not satisfied, return to editor to modify

This workflow is fine, but it would be more convenient if all operations could be completed in one place.

Main Features

hugo-admin provides the following features:

Dashboard: Blog statistics overview
Article Management: Browse, search, filter articles
Markdown Editor: Online editing with auto-save support
Hugo Server Control: Start/stop server, view logs in real-time
Image Management: Upload and manage article images

Interface Display

Tech Stack

Backend uses Flask + Flask-SocketIO, frontend uses Tailwind CSS + Alpine.js. Real-time log pushing is implemented based on WebSocket.

1
2
3
4
5
6
7
8


hugo-admin/
├── app.py # Flask application
├── services/ # Business logic layer
│ ├── hugo_service.py # Hugo server management
│ ├── post_service.py # Article operations
│ └── cache_service.py # Cache layer
├── templates/ # Jinja2 templates
└── static/ # Static resources

Installation and Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# Clone repository
git clone https://github.com/Svtter/hugo-admin.git
cd hugo-admin

# Install dependencies
pip install -r requirements.txt

# Configure Hugo directory
cp config.py config_local.py
# Edit config_local.py to set HUGO_ROOT

# Start
python app.py

After starting, visit http://127.0.0.1:5000.

Core Implementation

The Python version uses SQLite for caching to avoid scanning the file system every time:

1

post_service = PostService(app.config['CONTENT_DIR'], use_cache=True)

Hugo server control manages processes based on psutil, supporting real-time log pushing:

1

hugo_manager = HugoServerManager(app.config['HUGO_ROOT'], socketio)

Advanced Version

Besides the open-source Python version, I also developed a Go language implementation of the advanced version. Compared to the open-source version, the Go version has the following advantages:

Higher performance: Compiled Go language executes more efficiently
Lower resource usage: Less memory and CPU usage
Single file deployment: Compiled into a single executable file, no need for dependency environment
More features: Includes more advanced features
Direct Hugo API usage: No need for SQLite3 cache, directly calls Hugo API to get article information, more lightweight and efficient

The advanced version is priced at $10 USD. Click here to purchase to get complete source code. If you have higher requirements for performance and deployment convenience, consider the advanced version.

Future Plans

Git operations interface
Batch operation support
Docker deployment

The project is open source, welcome to Star and PR.

Developing Fried Rice Theme with Claude Code

Tue, 23 Dec 2025 15:00:00 +0800

Recently, I used Claude Code to add some SEO features to my own blog theme Fried Rice, and the overall experience was quite good.

Background

Fried Rice is a theme forked from hugo-theme-stack. Previously, I had already added some basic JSON-LD structured data, and this time I wanted to continue improving it.

What Was Done This Time

Mainly enhancing SEO structured data:

WebSite schema (supports search action)
Organization schema (includes founder, contact point, address)
FAQ schema (supports inline FAQ in articles)
Enhanced Article/BlogPosting schema (added accessibility metadata)

Claude Code’s Performance

The entire development process took about 2 hours. Claude Code helped me:

Write code - Hugo template syntax is cumbersome, letting AI write it saves a lot of effort
Review code - After I committed, I asked it to check, and it found several issues:
- datePublished was defined 3 times
- founder object was defined repeatedly
- JSON output had double escaping issues
- Variable scope errors
Fix issues - After finding issues, I asked it to fix them directly, all fixed at once
Create PR, tag, write CHANGELOG - These trivial tasks can also be done

A pleasant surprise was that it could find logical issues in the code. For example, Hugo’s jsonify output was HTML-escaped causing JSON format errors, and it found the correct solution (using safeJS).

Shortcomings

Sometimes needs multiple reminders to use the correct tools
Not very familiar with Hugo template syntax in some places, needs several iterations

Summary

For this kind of “add feature + fix bug” task, Claude Code is quite useful. Especially for tedious syntax like Hugo templates, having AI write it is much more efficient.

Based on:

Update the Hugo

Fri, 07 Mar 2025 11:39:32 +0800

Since the previously used Hugo version was too low and updating it would require significant effort, I have now updated Hugo, allowing me to focus solely on writing articles.

The new theme I am currently using is hugo-theme-stack.

Because my Hugo source files and <username>.github.io are not in the same repository—meaning I cannot directly configure gh-pages using a branch—I have adjusted the workflow to suit my situation. Here is my workflow configuration file:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53



name: Deploy to Github Pages

on:
 push:
 branches: [master]
 pull_request:
 branches: [master]

jobs:
 build:
 runs-on: ubuntu-latest

 permissions:
 # Give the default GITHUB_TOKEN write permission to commit and push the
 # added or changed files to the repository.
 contents: write

 steps:
 - uses: actions/checkout@v4
 with:
 fetch-depth: 0

 - name: Cache Hugo resources
 uses: actions/cache@v4
 env:
 cache-name: cache-hugo-resources
 with:
 path: resources
 key: ${{ env.cache-name }}

 - uses: actions/setup-go@v5
 with:
 go-version: "^1.17.0"
 - run: go version

 - name: Setup Hugo
 uses: peaceiris/actions-hugo@v2
 with:
 hugo-version: "latest"
 extended: true

 - name: Build
 run: hugo --minify --gc

 - name: Deploy
 uses: peaceiris/actions-gh-pages@v3
 with:
 personal_token: ${{ secrets.
ACCESS_TOKEN }}
 external_repository: svtter/svtter.github.io
 publish_branch: master
 publish_dir: ./public