新UI测试 封面

新UI测试

新UI测试 #新UI测试
本文系统展示并自检 ModernBlog 可视化编辑器内置的全部 31 种模块化组件——涵盖基础排版、提示高亮、结构布局、技术学术与媒体资源五大分类,同时支持在后台可视化编辑器中 100% 无损二次编辑。
31 种创作者模块Apple HIG 扁平美学KaTeX 数学公式Mermaid 流程图定制音频播放器零渐变设计

一、基础排版(7 种)

正文段落支持完整的行内富文本语法:加粗强调、斜体语气、删除线修订、下划线标注、荧光高亮、inline_code()、按键组合 Ctrl + S、行内公式 $E = mc^2$ 与 $\alpha + \beta = \gamma$,以及 ModernBlog 开源仓库 行内超链接。

  • 无序列表:适合快速罗列要点与灵感
  • 支持多行自由编辑,自动生成语义化列表
  • 清晰紧凑的行距与左侧对齐
  1. 打开 ModernBlog 后台可视化编辑器
  2. 按分类挑选所需模块并拖拽排序
  3. 一键构建静态站点并预览最终效果
  • 完成 31 种可视化创作者模块与 5 大分类标签页
  • 修复块级与行内 KaTeX 数学公式、删除线、高亮与下划线渲染
  • 修复折叠面板内边距、松散列表待办复选框与多行模块往返解析
  • 继续创作更多高质量原创内容

好的工具应当隐于内容之后,让创作者专注于表达本身,而不是与排版和样式搏斗。


二、提示高亮(5 种)

[!TIP]
提示框(Callout)支持 NOTE、TIP、IMPORTANT、WARNING、CAUTION 五种语义类型,适合在技术教程或评测中突出关键注意事项。

核心结论横幅(Banner)
提供蓝 / 绿 / 琥珀 / 红 / 紫五种语义色调,适合放置在章节开头或结尾,用于提炼核心观点或重要公告。
点击展开折叠面板(Details)— 查看排版细节 折叠面板展开后会自动将正文包裹进 .details-body 容器并保持舒适的四周内边距,适合收纳长段补充说明、更新日志或附录配置。
剧透内容 · 点击查看
防剧透遮罩(Spoiler):默认模糊隐藏,点击即可清晰展开或再次收起,适合影评、游戏剧情分析与谜题答案。

三、结构布局(7 种)

模块分类 模块数量 典型应用场景 渲染引擎
基础排版 7 种 标题、导语、富文本、列表、待办、引用 Python-Markdown + GFM
提示高亮 5 种 提示框、横幅、折叠面板、防剧透、徽章 语义容器 + JS 交互
结构布局 7 种 表格、双栏、卡片、时间轴、步骤、参数、优缺点 CSS Grid 自适应
技术学术 6 种 代码、终端、Diff、LaTeX 公式、Mermaid、快捷键 Pygments + KaTeX + Mermaid
媒体资源 6 种 单图灯箱、画廊、音视频、书签、附件、HTML 定制播放器 + 灯箱
左栏 · 极致静态性能
纯静态 HTML/CSS/JS 产物,零数据库与后端开销,支持任意 CDN 边缘缓存与毫秒级首屏渲染。
右栏 · 现代创作体验
31 种模块自由拼装与拖拽排序,可视化编辑与纯 Markdown 源码模式一键无损互转。
零渐变克制美学
通篇采用 Apple HIG 扁平材质与精细高光边框,彻底告别廉价渐变与视觉噪音。
全端响应式布局
桌面端宽屏阅读与移动端单列自适应无缝衔接,双栏与对比模块自动堆叠。
开箱即用容灾
KaTeX 与 Mermaid 均内置多 CDN 自动回退加载,复杂技术文章稳定呈现。
Phase 1
静态生成器与暗色主题
确立零依赖静态构建流程与 Apple HIG 视觉基调。
Phase 2
正文媒体与交互增强
上线定制音频卡片、全屏图片灯箱、代码语言徽章与一键复制。
Phase 3
31 模块创作者工作台
可视化编辑器扩充至 31 种模块并完成全量浏览器端到端验证。
1
启动管理面板
在项目根目录运行 python main.py,浏览器打开 http://127.0.0.1:32323。
2
模块化编排内容
在可视化编辑器中按需插入标题、公式、图表、画廊或定制音频播放器。
3
一键构建并部署
点击「立即构建」生成 public/ 静态产物,推送到 GitHub Pages、Cloudflare Pages 或任意服务器。
静态构建引擎Python 3 + Markdown + Jinja2
数学公式引擎KaTeX 0.16(多 CDN 容灾)
图表渲染引擎Mermaid 11(暗色 SVG 自适应)
可视化模块总数31 种(5 大分类,支持无损往返)
优点
  • 纯静态部署成本几乎为零
  • 31 种内容模块覆盖绝大多数创作场景
  • 可视化编辑与 Markdown 源码随时切换
不足
  • 需要本地或 CI 环境执行静态构建
  • 互动评论需额外接入第三方评论组件

四、技术学术(6 种)

def quick_sort(nums: list[int]) -> list[int]:
    if len(nums) <= 1:
        return nums
    pivot = nums[len(nums) // 2]
    left = [x for x in nums if x < pivot]
    mid = [x for x in nums if x == pivot]
    right = [x for x in nums if x > pivot]
    return quick_sort(left) + mid + quick_sort(right)
TERMINAL
python builder.py && python -m http.server 8090 --directory public
[OK] 构建完成!40 篇文章,耗时 2.18s Serving HTTP on :: port 8090 (http://[::]:8090/) ...
def render_markdown(raw_text: str) -> str:
- return markdown.markdown(raw_text)
+ normalized = raw_text.replace("\r\n", "\n")
+ return render_with_katex_and_gfm(normalized)
$$ f(x) = \int_{-\infty}^{\infty} \hat{f}(\xi)\,e^{2\pi i \xi x}\,d\xi \quad\Longrightarrow\quad \sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6} $$
flowchart LR A[可视化编辑器 31 模块] --> B[Markdown 语义序列化] B --> C[builder.py 静态构建] C --> D[浏览器 KaTeX / Mermaid / 交互增强]
Ctrl + Shift + S在编辑器中快速保存当前文章草稿

五、媒体资源(6 种)

自适应单图展示(点击可打开全屏灯箱)

ModernBlog 项目主页(GitHub 书签卡片)

附件:ZeroTermux Android 安装包 (APK 附件下载卡片)

自定义 HTML 嵌入块:当 30 种标准模块之外仍有特殊排版需求时,可直接嵌入任意原生 HTML 片段。