🚀 Release Notes v2025.09.17

📅 Release Date: September 17, 2025

🏷️ Version Tag: 2025.09.17

🎯 Update Type: Major Feature Update + Bug Fixes

📋 Update Overview

This update primarily addresses the core issue of Hugo image rendering failure in multilingual environments, while also providing comprehensive optimizations for the website’s project showcase functionality, multilingual support, and development configuration. This is an important technical upgrade that significantly improves user experience and development efficiency.

✨ New Features

🆕 Hugo Image Rendering Fix (Major Update)

Problem Description: In multilingual environments, cover images using relative paths fail to load properly, returning 404 errors

Specific Symptoms:

1
2
3

❌ http://127.0.0.1:1313/cover.jpg          # 404 error
❌ Multilingual environment image loading failure
❌ Page bundle resource parsing errors

Solution:

• Created custom layouts/partials/helper/image.html to override theme default implementation
• Implemented intelligent path parsing algorithm, prioritizing page bundle resources
• Added multilingual path processing logic to ensure both Chinese and English versions load correctly

Technical Implementation:

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

{{/* First try using page resources (most reliable method) */}}
{{ $pageResourceImage := .Context.Resources.GetMatch (printf "%s" ($imageValue | safeURL)) }}

{{ if $pageResourceImage }}
    {{/* If page resource found, use its relative path */}}
    {{ $correctPath = $pageResourceImage.RelPermalink }}
{{ else }}
    {{/* Build correct path based on filesystem path */}}
    {{ $pageFilePath := .Context.File.Path }}
    {{ $contentPath := strings.TrimPrefix "content/" $pageFilePath }}
    {{ $pageDir := path.Dir $contentPath }}
    {{ $correctPath = path.Join "/" $pageDir $imageValue }}
{{ end }}

Fix Results:

1
2
3
4

✅ http://127.0.0.1:1313/post/arbitration/cover.jpg  # 200 OK
✅ http://127.0.0.1:1313/post/test/cover.jpg          # 200 OK
✅ Both Chinese and English versions load images correctly
✅ Debug logs show correct path parsing

🆕 Multilingual Date Formatting

New Feature: Automatically adjust date display format based on current language environment

Implementation File: layouts/partials/article/components/footer.html

Format Comparison:

• Chinese Environment: 2025-09-17 15:30:00 (Conforms to Chinese reading habits)
• English Environment: Sep 17, 2025 15:30:00 (Conforms to English reading habits)

🆕 Project Showcase Upgrade

New Styles: assets/scss/custom.scss (+375 lines of code)

Core Features:

• 📱 Responsive Grid Layout: 2-column → 1-column adaptive
• 🎭 Card Hover Animations: translateY(-10px) + shadow enhancement
• 🌈 Modern Design: 16px rounded corners + gradient shadows + borders
• 📐 Flexbox Layout: Perfect content alignment

Style Code Example:

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

.project-card {
    display: flex;
    flex-direction: column;
    background-color: var(--card-background);
    border-radius: 16px;
    box-shadow: 0 8px 16px rgba(0, 0, 0, 0.08);
    transition: all 0.4s ease;

    &:hover {
        transform: translateY(-10px);
        box-shadow: 0 12px 24px rgba(0, 0, 0, 0.12);
    }
}

🔧 Feature Optimizations

⚡ Article Archetype Optimization

File: archetypes/post.md

Optimization Content:

• ✅ Added image field support for direct cover image path specification
• ✅ Simplified archetype structure, removed redundant resources configuration
• ✅ Optimized field naming standardization
• ✅ Added practical article structure template

Optimization Comparison:

1
2
3
4
5
6
7

# Before: Complex resources configuration
resources:
  - name: "featured-image"
    src: ""

# After: Simple image field
image: "cover.jpg"

⚡ Enhanced Configuration Support

File: config/_default/config.toml

New Configuration Items:

1
2
3
4
5
6
7
8

[build]
  writeStats = true  # Enable build statistics for performance optimization

[debug]
  logging = true     # Enable debug logging for development

[params]
  featuredImageField = "image"  # Explicitly specify image field usage

⚡ Development Environment Optimization

File: .gitignore

New Ignore Items:

1
2
3
4

.claude          # Claude configuration files
_vendor         # Hugo module cache directory
*.log           # Log files
hugo_stats.json # Hugo build statistics files

🐛 Bug Fixes

🔨 Core Bug: Hugo Image Rendering Failure

Problem Details: See the 【Hugo Image Rendering Fix】section above

Fix Status: ✅ Fully Resolved

🔨 Minor Bug: Inconsistent Date Formatting

Fix Status: ✅ Optimized

🔨 Development Environment Issues

Fix Status: ✅ Improved

📁 File Changes Details

New Files

• layouts/partials/helper/image.html - Hugo image rendering fix core logic
• layouts/partials/helper/multilingual-path.html - Multilingual path processing helper function
• archetypes/release-notes.md - Release notes article archetype
• content/post/release-notes/v2025-09-17.md - This release log
• content/post/arbitration/ - Arbitration legal articles directory
• content/post/test/ - Test content directory
• content/projects/ - Multiple project showcase content

Modified Files

• .gitignore - Added development environment ignore configuration
• archetypes/post.md - Optimized article archetype structure
• assets/scss/custom.scss - Added project showcase styles (+375 lines)
• config/_default/config.toml - Enhanced build and debug configuration
• layouts/partials/article/components/footer.html - Multilingual date formatting
• layouts/partials/head/custom.html - Custom head content

📊 Update Statistics

• New Code Lines: ~469 lines
• Modified Files: 9 core files
• New Content Files: 15+ items
• Commit Count: Multiple consecutive commits
• Impact Scope: Site-wide functionality upgrade

🎯 Technical Highlights

🏆 Intelligent Path Parsing Algorithm

Implemented dual parsing mechanism based on page bundle + filesystem path, ensuring correct image resource loading in various complex environments.

🏆 Multilingual Adaptation Solution

Perfectly solved Hugo multilingual environment resource path issues, providing a reliable solution for international website development.

🏆 Modern UI Design

Utilizing latest CSS3 features, achieved smooth interactive animations and responsive layouts, significantly enhancing user experience.

📸 Effect Demonstration

Before Modification Status

1
2
3
4

❌ Image Path: /cover.jpg (404 error)
❌ Date Format: Fixed English format
❌ Project Showcase: Basic list layout
❌ Dev Environment: Missing debugging support

After Modification Effects

1
2
3
4

✅ Image Path: /post/arbitration/cover.jpg (200 OK)
✅ Date Format: Chinese-English intelligent adaptation
✅ Project Showcase: Modern cards + hover animations
✅ Dev Environment: Complete debugging + statistics support

Debug Logs

1

WARN  [Image Helper] Processing image: cover.jpg -> Final path: /post/arbitration/cover.jpg

📝 Usage Guide

Image Usage

1
2
3

---
image: "cover.jpg"  # Relative path, automatically resolved
---

Multilingual Support

The system automatically based on current language environment:

• Adjust date display format
• Process image resource paths
• Adapt localized content

Project Showcase

When creating new projects, modern card styles are automatically applied, supporting:

• Hover animation effects
• Responsive layout
• Elegant visual design

🔮 Future Plans

🎯 Short-term Goals

• Perfect project showcase page functionality
• Add more interactive components
• Optimize mobile user experience

🎯 Long-term Vision

• Build complete project management system
• Integrate comments and social features
• Develop personalized theme customization

📞 Feedback and Suggestions

We highly value your opinions and suggestions! If you encounter any problems during use or have new feature requirements, please contact us through the following methods:

• 💬 Leave Comments: Share your thoughts in the comment section below the article
• 🐛 Report Issues: GitHub Issues
• ⭐ Support Project: Give our GitHub repository a Star

💡 Tips: Follow our release notes category to get timely updates on the latest features and fixes.

🔗 Related Links:

• Technical Blog - In-depth technical articles
• Project Showcase - Project portfolio
• About Us - Learn more about us
• GitHub Repository - Source code and contributions

Version Info: v2025.09.17 | Last Updated: September 17, 2025

Thank you for your continued support and attention! 🙏✨