Document static assets and image handling

- Add detailed section on image storage location and serving
- Document image URL rewriting from Windows paths to HTTP URLs
- Include examples of image content (robotics, running, technical diagrams)
- Update file structure with image handling details
This commit is contained in:
Paul Huliganga 2026-03-03 11:22:14 -05:00
parent be1a25c6fb
commit 22081a068b
1 changed files with 20 additions and 1 deletions

View File

@ -11,7 +11,7 @@ There are two related projects:
1. **thingamablog-api** (`projects/thingamablog-api/`): Contains the Java export tool for data extraction 1. **thingamablog-api** (`projects/thingamablog-api/`): Contains the Java export tool for data extraction
2. **thingamablog-v2** (`projects/thingamablog-v2/`): Contains the web app for browsing the extracted data 2. **thingamablog-v2** (`projects/thingamablog-v2/`): Contains the web app for browsing the extracted data
No Git repositories are set up for these folders yet. No Git repositories are set up for these folders.
## Problem Statement ## Problem Statement
@ -157,6 +157,25 @@ App
| Frontend | React/Material-UI | Modern, component-based UI | | Frontend | React/Material-UI | Modern, component-based UI |
| Images | Static serving | Direct file access for performance | | Images | Static serving | Direct file access for performance |
### Static Assets & Image Handling
#### Image Storage Location
- **Path:** `/home/paulh/.openclaw/workspace/docs/pauls-blogs/Paul/1096292361887/web`
- **Contents:** ~3.2MB of image files (JPG, GIF) from original blog posts
- **Examples:** Robotics photos, running/training images, technical diagrams, circuit schematics
- **Date Range:** Images from 2004-2009 blog posts
#### Image Serving
- **URL Path:** `/1096292361887/web/*` (preserves original blog structure)
- **Implementation:** Express.static middleware serves files directly
- **Fallback:** Root path `/` also serves images for compatibility
#### Image URL Rewriting
- **Problem:** Original blog posts contain Windows file paths (`file:///\\paulspc2\...\Weblogs/FILENAME.jpg`)
- **Solution:** Backend rewrites image src attributes to HTTP URLs (`http://localhost:3637/FILENAME.jpg`)
- **Regex Pattern:** Converts Windows UNC paths to web-accessible URLs
- **Benefit:** Images display correctly without manual editing of HTML content
### File Structure ### File Structure
``` ```
projects/ projects/