Markus GrafandClaude
11401552b6
Create comprehensive proposal to migrate all content from live markusgraf.ch to the Hugo project, including text content, images, and structure. - Add proposal.md with rationale and impact analysis - Add design.md with content extraction strategy and trade-offs - Add tasks.md with 13 ordered, verifiable implementation tasks - Add content-migration spec with 5 requirements and 11 scenarios - Add image-assets spec with 5 requirements and 10 scenarios Validated with: openspec validate migrate-site-content --strict 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
3.2 KiB
3.2 KiB
Tasks
Content Extraction & Analysis
-
Obtain HTML source from live markusgraf.ch
- User provides saved HTML file or content extraction
- Parse and analyze the structure and sections
- Identify all text content blocks (bio, projects, etc.)
- Validation: HTML source file available and readable
-
Catalog all images and assets
- Extract all image URLs from live site HTML
- Document image filenames, paths, and purposes
- Create asset inventory list
- Validation: Complete list of images with URLs
Image Migration
-
Download all images from live site
- Download each catalogued image
- Verify image integrity (no corrupted downloads)
- Validation: All images downloaded successfully, checksums verify
-
Organize images in static directory
- Create appropriate subdirectories in static/ (e.g., static/images/)
- Place images with consistent naming
- Document the organization structure
- Validation: Images accessible via Hugo static path convention
Content Migration
-
Extract and convert homepage content
- Parse homepage HTML to identify content sections
- Convert HTML to markdown format
- Preserve formatting (bold, italic, links, etc.)
- Validation: Markdown content matches original HTML structure
-
Update _index.md with actual content
- Replace placeholder content in content/_index.md
- Add proper front matter
- Integrate all homepage sections
- Update image references to Hugo paths
- Validation:
hugo serverdisplays homepage content correctly
-
Migrate projects/portfolio content
- Extract project descriptions and details
- Create appropriate content structure (individual files or sections)
- Add project images and link them correctly
- Validation: All projects visible with complete information
-
Update or create additional content pages
- Create/update about page if present on live site
- Ensure all pages from live site are represented
- Validation: Page structure matches live site
Verification & Quality Assurance
-
Verify all internal links
- Check all links between pages work
- Verify anchor links if used
- Validation: No broken internal links,
hugo servernavigation works
-
Verify all image references
- Build Hugo site
- Check that all images display correctly
- Verify no 404 errors in browser console
- Validation: All images load, no missing assets
-
Content parity verification
- Compare Hugo build output with live markusgraf.ch
- Verify all text content is present
- Check that layout and sections match
- Validation: Side-by-side comparison confirms identical content
-
Accessibility check for images
- Add alt text to all images
- Ensure image references are semantic
- Validation: All
<img>tags have descriptive alt attributes
Documentation
- Document content structure
- Update project documentation with content organization
- Note any deviations from live site (if applicable)
- Document image organization scheme
- Validation: README or docs reflect current content structure