Haddock 转 Reveal.js转换器
所有处理都在你的设备上完成,大文件可能需要一点时间。
当需要一个任何浏览器都能打开的演讲稿时,把 Markdown 或 Word 内容转成 Reveal.js 幻灯——无需 PowerPoint、无需安装。如果你的文件还是 Haddock 格式,这个页面就是最快的捷径:Haddock 是 Haskell 生态的文档标记:附着在函数上的 -- 注释块,渲染成每个 Hackage 包自带的 API 文档。
iLoveConverter 在你的电脑本地完成全部处理,因此既私密又快速:没有上传等待,不存储到任何服务器,也不限次数。想转多少文件都可以,批量转换开箱即用。
Haddock 与 Reveal.js 的对比
| Haddock | Reveal.js | |
|---|---|---|
| 数据结构 | 注释标记(--、'links'、@mono@) | 自包含 HTML + CDN 运行时 |
| 最适合 | Haskell API 文档 | 技术演讲、课程、演示 |
如何将 Haddock 转换为 Reveal.js
- 1
选择文件
选择你的 Haddock 文件。
- 2
立即转换
文件先转换成 Markdown(保留标题、列表与段落的中间格式),再重建为目标格式。
- 3
下载结果
下载 Reveal.js——结构保留,复杂排版被简化。
关于 Haddock 格式
Haddock 是 Haskell 解释自己的方式:-- 注释块里的文档,用 '标识符链接'、@等宽@ 和 /斜体/ 标记,编译成 Hackage 上每个包都发布的 API 参考页。标记活在源码里,但格式自成一们小语言。
从源码注释里转出后,Haddock 文本变成普通结构化散文:Pandoc 把标题、代码块和标识符链接映射到 Markdown 或 HTML,API 知识得以进入手册、wiki 或静态站点生成器,无需重新打字。
+优点
- ✓文档与所描述的代码同处一地
- ✓跨 API 的标识符感知链接
- ✓整个 Haskell 生态的标准
!局限
- −只在 Haskell 项目里有意义
- −语法小,Haddock 之外输出器少
- −嵌在注释里——需先提取
关于 Reveal.js 格式
Reveal.js 把单个 HTML 文件变成完整演示:键盘翻页、过渡动画、演讲者备注、分步呈现,甚至内置 PDF 导出。转换产物通过 CDN 引用 Reveal.js 运行时,任何浏览器都能打开——无需安装,无需上传。
标题变成幻灯片标题,章节变成一组组幻灯片;列表渲染成可逐步呈现的 fragment。这是从书面内容到「任何屏幕都能放的演讲」的最快路径——而且文件属于你,任何文本编辑器都能改。
+优点
- ✓单文件,任何浏览器可放
- ✓内置演讲备注、分步呈现与 PDF 导出
- ✓之后可按纯 HTML 继续编辑
!局限
- −运行时依赖 CDN 网络
- −设计由模板驱动,不如 PPTX 定制
- −复杂图示需要手写 HTML
为什么把 Haddock 转换成 Reveal.js?
转换的意义在于 Reveal.js 的长处正好补上 Haddock 给不了的东西:单文件,任何浏览器可放而另一边,只在 Haskell 项目里有意义用上面的转换器过一遍,你的文件就站到了正确的取舍那边。
常见问题
Haddock 转 Reveal.js 真的免费吗?
完全免费,无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗?
不会。转换通过 WebAssembly 完全在你的浏览器内完成,文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗?
可以。任何装有现代浏览器的设备都适用:Windows、macOS、Linux、安卓和 iOS,无需安装任何软件。
Haddock 转 Reveal.js 有文件大小限制吗?
由于不上传,唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题,超大文件只是需要稍等片刻。
转换出来的 Reveal.js 之后还能编辑吗?
取决于目标格式:Reveal.js 为自己的用途而生,本转换器忠实还原其内容,而不是凭空制造可编辑结构。需要大量再编辑时,请从面向编辑的格式入手,最后在这里导出终稿。
转换可以离线进行吗?
可以。页面加载完成后,转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。