Skip to content

fix(export): Zola TOML escaping, title fallback, date field, mermaid diagrams#140

Merged
avrabe merged 1 commit intomainfrom
fix/zola-export-issues
Apr 13, 2026
Merged

fix(export): Zola TOML escaping, title fallback, date field, mermaid diagrams#140
avrabe merged 1 commit intomainfrom
fix/zola-export-issues

Conversation

@avrabe
Copy link
Copy Markdown
Contributor

@avrabe avrabe commented Apr 13, 2026

Summary

Fixes for Zola export discovered during real-site integration:

  • TOML parse error: Descriptions with newlines used "..." — now uses """...""" triple-quoted strings
  • Empty titles: Artifacts without titles now use first non-empty description line as fallback
  • Taxonomy error: Removed custom artifact_type/artifact_status taxonomies — merges type+status into existing tags taxonomy
  • Date filter error: Added date field to frontmatter from provenance timestamp
  • Mermaid diagrams: Design decisions with diagram field now export as ```mermaid code blocks
  • Rationale: Design decisions include rationale as a section

Implements: REQ-007

🤖 Generated with Claude Code

… field, mermaid

- Use TOML triple-quoted strings for descriptions (handles newlines)
- Fallback to first non-empty description line when title is empty
- Merge artifact type and status into tags taxonomy (no custom taxonomies)
- Add date field to frontmatter (from provenance timestamp)
- Include diagram fields as Mermaid code blocks
- Include rationale fields in design decision pages

Implements: REQ-007

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@avrabe avrabe merged commit 9db1988 into main Apr 13, 2026
12 of 13 checks passed
@avrabe avrabe deleted the fix/zola-export-issues branch April 13, 2026 11:45
@codecov
Copy link
Copy Markdown

codecov Bot commented Apr 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant