웹사이트 재단장

Date: 2025-10-07

Cursor를 사용하여 웹사이트를 새단장하였습니다. 아래는 Cursor가 쓴 변경사항 모음입니다.

🚀 Website Architecture Revamp - Complete Build System & Markdown Support

📋 Summary

This PR introduces a complete architectural overhaul of the personal website, transforming it from a manual HTML management system to a sophisticated, automated build system with markdown support and component-based architecture.

🔄 Major Changes

1. New Build System (build.sh)

• 1,238 lines of comprehensive build automation
• One-command workflow: ./build.sh build-all handles everything
• Markdown support with Pandoc integration for professional HTML conversion
• Component injection system for navigation and footer
• Index management with automatic post discovery and cleanup
• Validation system for HTML structure and links

2. Asset Reorganization

• Moved all assets to organized public/assets/ structure:
  • fonts/ → assets/fonts/ (Neo둥근모 font files)
  • badges/ → assets/images/ (all badge images)
  • style.css → assets/css/style.css
• Improved path management for better deployment compatibility

3. Component-Based Architecture

• New navigation system with multiple levels:
  • nav-root.html - Root level pages
  • nav-level1.html - Microblog pages
    
  • nav-level2.html - Post pages
• Centralized footer component with automatic path adjustment
• Template system for consistent post creation

4. Content Structure Overhaul

• Organized post categories:
  • posts/thoughts/ - Personal thoughts and experiences
  • posts/travel-food/ - Travel and food content
• Markdown support with dedicated markdown/ directories
• New microblog system with markdown-based entries
• Index pages for each category with automatic post discovery

5. New Content & Features

• New blog post: “Cursor” (251007_cursor.html)
• New microblog entry: “Daily Thoughts” (2025-10-07)
• Markdown templates for both blog posts and microblog
• Deployment checklist for Neocities deployment
• Git ignore rules for macOS development

📁 File Changes Summary

Change Type	Count	Description
Added	15 files	New build system, components, templates, content
Modified	4 files	Updated README, index, microblog, not_found pages
Moved	12 files	Asset reorganization and content restructuring
Deleted	5 files	Removed old structure and unused files

🛠️ New Build Commands

# Content creation
./build.sh new-post [category] [filename]           # Create HTML blog post
./build.sh new-post-md [category] [filename]       # Create markdown blog post  
./build.sh new-microblog [filename]                # Create microblog entry

# Content processing
./build.sh build-microblog                         # Convert microblog markdown
./build.sh build-posts                             # Convert blog post markdown
./build.sh rebuild-indexes                         # Rebuild all indexes

# One-command workflow
./build.sh build-all                               # Complete build process

# Maintenance
./build.sh inject-nav                              # Update navigation
./build.sh inject-footer                           # Update footer
./build.sh validate                                # Validate HTML
./build.sh deploy                                  # Prepare for deployment

🎯 Key Benefits

1. 🚀 Automation: Single command handles entire build process
2. 📝 Markdown Support: Write in markdown, get professional HTML
3. 🧩 Component System: Reusable navigation and footer components
4. 📁 Better Organization: Logical asset and content structure
5. 🔧 Developer Experience: Comprehensive tooling and validation
6. 📱 Deployment Ready: Optimized for Neocities static hosting

📊 Impact

• +2,690 lines added (primarily build system and documentation)
• -476 lines removed (old manual structure)
• 48 files changed (complete architectural overhaul)
• Zero breaking changes to existing content
• Enhanced maintainability with automated workflows

🧪 Testing

• Build system validation
• HTML structure validation
  
• Navigation component injection
• Markdown conversion with Pandoc
• Asset path verification
• Deployment checklist creation

📚 Documentation

• Comprehensive README with usage examples and troubleshooting
• Deployment checklist for Neocities deployment
• Template documentation for content creation
• Build script help with ./build.sh help

This PR transforms the website from a manual HTML management system into a modern, automated, markdown-enabled static site generator while maintaining full backward compatibility with existing content.