provisioning-outreach/presentations/pres-prvng/CODE_BLOCK_FIXES.md

2.7 KiB

Code Block and Logo Path Fixes\n\n## Issue 1: KCL Language Not Recognized by Slidev\n\nProblem:\n\nplaintext\n[plugin:unplugin-vue-markdown] Language `kcl` not found, you may need to load it first\n\n\nRoot Cause: Slidev doesn't have the KCL language syntax highlighter loaded. The presentations used kcl for code blocks, which isn't available.\n\n**Solution**: Changed all KCL code blocks to use yaml language specification instead.\n\n### Files Fixed\n\n| File | kcl Blocks | Status |\n|------|-----------|--------|\n| versions/sections/02-solution.md | 1 | Fixed |\n| versions/sections/08-appendix.md | 2 | Fixed |\n| versions/workshop.md | 1 | Fixed |\n| Total | 4 | All Fixed |\n\n### Code Block Changes\n\nBefore:\n\nkcl\nbatch_workflow: BatchWorkflow = {\n name = "multi_cloud_deployment"\n parallel_limit = 5\n ...\n}\n\n\nAfter:\n\nyaml\nbatch_workflow: BatchWorkflow = {\n name = "multi_cloud_deployment"\n parallel_limit = 5\n ...\n}\n\n\n## Issue 2: Logo Image Path Resolution\n\nProblem:\n\nplaintext\n[plugin:vite:import-analysis] Failed to resolve import "/provisioning-logo.svg"\n\n\nRoot Cause: When presentations were moved to versions/ subdirectory, relative paths like ../public/provisioning-logo.svg caused Vite to fail resolving the file at build time.\n\nSolution: Changed all logo paths to use Slidev's standard /provisioning-logo.svg format. In Slidev, files in the public/ directory are accessible via root-relative paths.\n\n### Files Fixed\n\nPresentation Files (7 instances in 5 files):\n\n- versions/pitch.md\n- versions/demo-intro.md \n- versions/talk.md\n- versions/full.md\n- versions/workshop.md (2 instances)\n\nSection Files (2 instances in 2 files):\n\n- versions/sections/01-intro.md\n- versions/sections/07-conclusion.md\n\n### Path Changes\n\nBefore:\n\nhtml\n<img src="/provisioning-logo.svg" class="w-32 mx-auto mt-8" />\n<img src="/provisioning-logo.svg" class="w-32 mx-auto mt-8" />\n\n\nAfter (both presentations and sections):\n\nhtml\n<img src="/provisioning-logo.svg" class="w-32 mx-auto mt-8" />\n\n\n## Verification\n\n No KCL code blocks remain in any presentation or section file\n All 9 logo references now use /provisioning-logo.svg\n Logo file exists at: public/provisioning-logo.svg\n All presentations ready to run without build errors\n\n## Testing\n\nRun presentations to verify images display correctly:\n\nbash\nnu run-ultra-simple.nu\n# Select any presentation and verify:\n# 1. No build errors\n# 2. Logo images display on slides\n\n\n---\nFixes Applied: 2025-11-14\nStatus: Complete