72 lines
2.1 KiB
Markdown
72 lines
2.1 KiB
Markdown
# 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
|