Haddock 转 GZ转换器
所有处理都在你的设备上完成,大文件可能需要一点时间。
Haddock Documentation与Gzip Compressed File的定位并不相同:Haddock 是 Haskell 生态的文档标记:附着在函数上的 -- 注释块,渲染成每个 Hackage 包自带的 API 文档。当接收方不认识 gzip 时,把 .gz 解开成普通文件,或重打包为 ZIP/TAR。
由于整个转换都在你的设备上完成,它快速、无限量且真正私密——无需账号、没有水印、文件不会出现在任何服务器上。多个文件一次性转换。
如何将 Haddock 转换为 GZ
- 1
选择文件
选择你的 Haddock 文件。
- 2
立即转换
文件字节在本地被 gzip 压缩——与服务器或构建工具生成的归档相同。
- 3
下载结果
下载 .gz 文件——可直接上传、提供服务或附件。
关于 Haddock 格式
Haddock 是 Haskell 解释自己的方式:-- 注释块里的文档,用 '标识符链接'、@等宽@ 和 /斜体/ 标记,编译成 Hackage 上每个包都发布的 API 参考页。标记活在源码里,但格式自成一们小语言。
从源码注释里转出后,Haddock 文本变成普通结构化散文:Pandoc 把标题、代码块和标识符链接映射到 Markdown 或 HTML,API 知识得以进入手册、wiki 或静态站点生成器,无需重新打字。
+优点
- ✓文档与所描述的代码同处一地
- ✓跨 API 的标识符感知链接
- ✓整个 Haskell 生态的标准
!局限
- −只在 Haskell 项目里有意义
- −语法小,Haddock 之外输出器少
- −嵌在注释里——需先提取
关于 GZ 格式
.gz 文件是被 gzip 压缩的单个文件——不是归档。kernel.org 的包是「tar 再套 gz」,但大量日志、JSON 转储和 CSV 导出直接以 .gz 流通。打开它就是把字节解回原样。
重打包成 ZIP 或 TAR,解出来的文件就拥有一个人人都会开的容器。
+优点
- ✓Linux/macOS 上无处不在
- ✓快速、透明的压缩
- ✓任意工具原生流式处理
!局限
- −只能装一个文件,无目录树
- −无加密与完整性元数据
为什么把 Haddock 转换成 GZ?
这个转换之所以存在,是有具体原因的:只在 Haskell 项目里有意义GZ 则绕开了这一点——Linux/macOS 上无处不在如果你正处在这种情况,用上面的工具几秒就能解决,全程都在你自己的设备上。
常见问题
Haddock 转 GZ 真的免费吗?
完全免费,无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗?
不会。转换通过 WebAssembly 完全在你的浏览器内完成,文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗?
可以。任何装有现代浏览器的设备都适用:Windows、macOS、Linux、安卓和 iOS,无需安装任何软件。
Haddock 转 GZ 有文件大小限制吗?
由于不上传,唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题,超大文件只是需要稍等片刻。
压缩包转换有大小限制吗?
因为不上传,所以没有上传上限——实际限制是设备内存。现代电脑处理解压后几百 MB 的内容很从容。
Haddock 压缩包里的文件会被修改吗?
不会。文件在内存中解包后逐字节重新打包成 GZ——转换改变的是容器本身,包内文件分毫不动。