summaryrefslogtreecommitdiffstats
path: root/HANDOFF.md
blob: 946b3589bc42487be9077acff9199dbe16864586 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Who this is for:
  You are Danilo (danix), building a Hugo theme for danix.xyz — a bilingual (Italian/English) hacker-themed portfolio/blog site. You just completed a major article import and processing pipeline, moving ~36 articles from the old site into the new theme structure.

What we covered:
  The session covered article import strategy and execution. We discussed asset organization using static/uppies/year/month/ folder structure, confirmed Italian and English articles should share the same slug with different translations, and then executed a complete import workflow:
  ran the importer script to copy articles from the old site, audited imported articles for frontmatter issues, fixed type field values (remapping article → life/tech/quote), fixed minor issues like tags="" and draft="true" strings, migrated all co-located assets to static/uppies/
  organized by publication date, created Italian article stubs with TODO placeholders, and created seven missing shortcodes (strike, em, dropcap, figure, highlight, img, youtube, gal-img) to allow articles to render. All 36 articles now build successfully with hugo server.

What was confirmed:
  All 36 English articles are now in content/en/articles/ with corrected frontmatter. 1 article is type="quote", 2 are type="tech", 33 are type="life" (default when in doubt). 21 image/media files moved to static/uppies/ organized by year/month from article publication dates. All image paths in frontmatter updated to /uppies/year/month/filename. Italian stubs created in content/it/articles/ with matching slugs and draft=true status. Hugo builds without errors and articles render with correct type badges. Images load correctly from /uppies/ paths on the
  article list page. Shortcodes for typora-root-url are preserved as requested.

Still in progress:
  All 36 Italian article stubs remain untranslated (marked draft=true). No CSS changes were needed for the import, so npm run build was not required.

Next steps:
  Commit the imported articles, asset migrations, and new shortcodes. Translate Italian article stubs and set their draft=false when ready. Test articles end-to-end in the browser to verify all content, images, and features render correctly across both languages. Consider publishing a few translated articles to make the bilingual site live.