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>
82 lines
3.2 KiB
Markdown
82 lines
3.2 KiB
Markdown
# Tasks
|
|
|
|
## Content Extraction & Analysis
|
|
1. **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
|
|
|
|
2. **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
|
|
3. **Download all images from live site**
|
|
- Download each catalogued image
|
|
- Verify image integrity (no corrupted downloads)
|
|
- **Validation**: All images downloaded successfully, checksums verify
|
|
|
|
4. **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
|
|
5. **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
|
|
|
|
6. **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 server` displays homepage content correctly
|
|
|
|
7. **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
|
|
|
|
8. **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
|
|
9. **Verify all internal links**
|
|
- Check all links between pages work
|
|
- Verify anchor links if used
|
|
- **Validation**: No broken internal links, `hugo server` navigation works
|
|
|
|
10. **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
|
|
|
|
11. **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
|
|
|
|
12. **Accessibility check for images**
|
|
- Add alt text to all images
|
|
- Ensure image references are semantic
|
|
- **Validation**: All `<img>` tags have descriptive alt attributes
|
|
|
|
## Documentation
|
|
13. **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
|