docs(05): capture phase context

2026-04-21 11:22:39 +02:00
parent 468661e5ec
commit c0724e8537
2 changed files with 166 additions and 0 deletions
@@ -0,0 +1,71 @@
+# Phase 5: @nuxt/content Setup & Renderer - Discussion Log
+
+> **Audit trail only.** Do not use as input to planning, research, or execution agents.
+> Decisions are captured in CONTEXT.md — this log preserves the alternatives considered.
+
+**Date:** 2026-04-21
+**Phase:** 05-nuxt-content-setup-renderer
+**Areas discussed:** Style du rendu markdown, Callouts / Alerts, Structure content/, Syntax highlighting
+
+---
+
+## Style du rendu markdown
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| @tailwindcss/typography | Plugin officiel Tailwind — classe `prose dark:prose-invert`, dark mode natif | ✓ |
+| Nuxt UI prose styles | Via `UProse`, cohérent avec le design system existant | |
+| CSS custom à la main | Tout écrire dans assets/css/ — contrôle total, effort élevé | |
+
+**User's choice:** @tailwindcss/typography  
+**Notes:** —
+
+---
+
+## Callouts / Alerts
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| MDC Components | Syntaxe `::alert{type}` dans le markdown, composant Vue dédié | ✓ |
+| HTML dans le markdown | `<div class="callout">` directement dans les .md | |
+
+**User's choice:** MDC Components  
+**Notes:** —
+
+---
+
+## Structure content/
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| content/fr/ + content/en/ | Un dossier par langue, aligné avec @nuxtjs/i18n | ✓ |
+| content/blog/ avec champ locale | Fichiers `.fr.md` / `.en.md` dans un seul dossier | |
+
+**User's choice:** content/fr/ + content/en/  
+**Notes:** —
+
+---
+
+## Syntax highlighting
+
+| Option | Description | Selected |
+|--------|-------------|----------|
+| Shiki intégré | Zéro config, langues déclarées dans nuxt.config.ts, thème dark/light | ✓ |
+| Prism | Alternative plus ancienne, moins performante | |
+
+**User's choice:** Shiki intégré  
+**Notes:** Langages prioritaires : Kotlin, Java, TypeScript, Shell
+
+---
+
+## Claude's Discretion
+
+- Thème Shiki exact (dark/light)
+- Types de callouts MDC à créer (minimum : info, warning, tip)
+- Frontmatter schema des articles
+
+## Deferred Ideas
+
+- Pages /blog et /blog/[slug] → Phase 6
+- SEO par article → Phase 7
+- Articles Hytale réels → Phase 8