olehomelchenko.com/MIGRATION-CHECKLIST.md

Migration Checklist

📋 Content Migration

Blog Posts (8 total)

• dataviz-blogs.md → posts/dataviz-blogs/index.qmd (lang: uk)
• dataviz-books-ua.md → posts/dataviz-books-ua/index.qmd (lang: uk)
• entso-e-ukraine-energy-transfer-viz.md → posts/entso-e-ukraine-energy-transfer-viz/index.qmd (lang: uk, showcase)
• forbes-50-foundations.md → posts/forbes-50-foundations/index.qmd (lang: uk, showcase)
• my-first-post.md → posts/my-first-post/index.qmd (lang: uk)
• vega-altair-hugo-shortcodes.md → posts/vega-altair-hugo-shortcodes/index.qmd (lang: uk, showcase)
• bar-charts-makeover.md (English) → posts/bar-charts-makeover/index.qmd (lang: en, showcase)
• Convert all Vega-Lite shortcodes to code fences

TILs (2 total)

• inspired-by-blogs.md → til/inspired-by-blogs.qmd (lang: uk)
• obsidian-paperless.md → til/obsidian-paperless.qmd (lang: uk)

🎨 Customization

• Update about/index.qmd with your actual bio
• Add contact information to About page
• Add any real projects to projects/ section
• Customize homepage (index.qmd) if desired
• Review and adjust theme colors in styles.css if needed

🧹 Cleanup

• Delete posts/sample-ukrainian-post/
• Delete posts/sample-english-post/
• Delete posts/sample-visualization-post/
• Delete til/sample-til-ukrainian.qmd
• Delete til/sample-til-english.qmd
• Delete projects/sample-project-1/

✅ Testing

• Run quarto preview and check all pages
• Verify all blog posts render correctly
• Verify all TILs render correctly
• Check all Vega-Lite visualizations display properly
• Test portfolio page shows showcase items
• Test navigation between all sections
• Check responsive design on mobile
• Verify analytics scripts load (check browser console)

🚀 Deployment

• Run quarto render successfully
• Check build output in _site/
• Test old /en/* URL redirects
• Deploy _site/ to hosting
• Verify production site works correctly
• Update DNS if needed

🗑️ Final Cleanup (After Successful Deployment)

• Archive or delete Hugo content/ directory
• Delete archetypes/, layouts/, themes/
• Delete hugo.yaml
• Delete public/, resources/
• Keep .git/ and version control as-is

---

Tip: Test with one post first to validate the workflow before batch-migrating everything!