xfy
5dceb39544
问题:经 Tiptap 编辑器保存的数学公式,矩阵/分段函数等服务端 KaTeX 渲染失败。 根因:@tiptap/markdown 的 MarkdownManager.encodeTextForMarkdown 对所有非代码 文本节点做 escapeMarkdownSyntax + encodeHtmlEntities,把 LaTeX 的 \→\\、 _→\_、&→&。编辑器内公式走普通文本路径,经 getMarkdown() 序列化后存库即损坏。 解法:把公式建模成 atom Node(InlineMath/DisplayMath),LaTeX 存 attrs.latex 而非子文本;声明 markdownTokenizer/parseMarkdown/renderMarkdown 顶层 spec 字段, 序列化时 renderMarkdown 直接拼 $...$/$$...$$,绕过 encodeTextForMarkdown 转义路径(MarkdownManager 有 handler 的非文本节点不走 escape)。 NodeView 内用客户端 katex.renderToString 渲染预览(类 Notion/Typora),双击编辑 LaTeX 源码。KaTeX CSS 已由 Dioxus.toml 全局注入,无需额外接线。 - 新增 katex ^0.16.22 依赖(workspace 已 hoisted) - 11 个回归测试覆盖矩阵/分段函数/round-trip 序列化往返
Yggdrasil
基于 Dioxus 0.7 的全栈博客系统，Rust 单一代码库同时编译为 WASM 前端和原生服务端。
技术栈
- 框架: Dioxus 0.7 (fullstack)
- 数据库: PostgreSQL + tokio-postgres
- 样式: Tailwind CSS v4
- 密码: Argon2
- 会话: UUID token + cookie
功能
- 邮箱注册 / 登录（单管理员模式，首次注册后关闭）
- 会话管理与自动过期清理
- 暗色 / 亮色主题切换
- 后台文章撰写（Tiptap Markdown 编辑器）
- 文章归档与标签浏览
开发
依赖 Rust 1.95+、wasm32 目标、dx CLI、tailwindcss CLI v4 和 PostgreSQL。
# 配置数据库
DATABASE_URL=postgres://postgres:postgres@localhost:5432/yggdrasil
# 运行迁移（自动创建数据库并按顺序执行 migrations/ 下所有 SQL）
./migrate.sh
# 启动开发服务器
make dev
构建
make build
生产部署
生产环境必须前置反向代理（nginx/Caddy）做 TLS 终结，并设置 APP_BASE_URL、
COOKIE_SECURE=true、TRUSTED_PROXY_COUNT=1。详见 部署指南。