Man page 转 MediaWiki转换器
所有处理都在你的设备上完成,大文件可能需要一点时间。
Unix Man Page (roff)与MediaWiki Wikitext的定位并不相同:Man 页是每个 Unix 命令背后的 roff 格式手册:.TH 头、.SH 节和 \fB 字体转义——至今仍在日常使用的最古老文档格式。把 wiki 页面转成 Markdown/Word 做离线文档;或把 Markdown 内容以原生标记推入 MediaWiki 站点。
由于整个转换都在你的设备上完成,它快速、无限量且真正私密——无需账号、没有水印、文件不会出现在任何服务器上。多个文件一次性转换。
Man page 与 MediaWiki 的对比
| Man page | MediaWiki | |
|---|---|---|
| 数据结构 | roff 宏(.TH/.SH、\fB 转义) | 维基文本 + 模板 |
| 最适合 | 命令行参考手册 | wiki 与知识库 |
如何将 Man page 转换为 MediaWiki
- 1
选择文件
选择你的 Man page 文件。
- 2
立即转换
文件先转换成 Markdown(保留标题、列表与段落的中间格式),再重建为目标格式。
- 3
下载结果
下载 MediaWiki——结构保留,复杂排版被简化。
关于 Man page 格式
Man 页是 Unix 最古老且仍活着的文档格式:roff 源码带 .TH 标题宏、.SH 节头和 \fB 这类反斜杠字体转义,由 troff/groff 渲染成每个开发者用 `man ls` 阅读的终端页。它比多数仍在使用的编程语言都老——而且至今随每个 Linux 和 macOS 安装。
现代文档团队已很少手写 roff,但任何要出现在终端里的东西仍绕不开这个格式。Pandoc 把 man 页转成 Markdown、HTML 或 Word,让命令行文档上网——也能从 Markdown 源生成新的 roff。
+优点
- ✓所有类 Unix 系统通用
- ✓紧凑表达结构化手册
- ✓终端与印刷排版皆佳
!局限
- −对新手而言宏语法晦涩
- −roff 工具链古老
- −不适合富媒体或网页优先的文档
关于 MediaWiki 格式
MediaWiki 维基文本是维基百科及数千个克隆站的标记语言:=标题=、[[内部链接]]、{{模板}} 和 <ref> 引用。海量公开知识——百科、历史、技术——只存在于这套语法里。
Wiki 的导出通常不体面,而 Markdown 工具链几乎不认维基文本。转换器让你把 wiki 内容搬进正式文档(Word、EPUB、Markdown)——或者把你的 Markdown 内容以原生方言发布回 wiki。
+优点
- ✓维基百科级知识库的格式
- ✓模板与引用是一等公民
- ✓由 wiki 引擎管理版本与链接
!局限
- −各 wiki 农场的方言有差异
- −模板转换后常失去意义
- −没有 wiki 渲染器可读性差
为什么把 Man page 转换成 MediaWiki?
转换的意义在于 MediaWiki 的长处正好补上 Man page 给不了的东西:维基百科级知识库的格式而另一边,对新手而言宏语法晦涩用上面的转换器过一遍,你的文件就站到了正确的取舍那边。
常见问题
Man page 转 MediaWiki 真的免费吗?
完全免费,无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗?
不会。转换通过 WebAssembly 完全在你的浏览器内完成,文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗?
可以。任何装有现代浏览器的设备都适用:Windows、macOS、Linux、安卓和 iOS,无需安装任何软件。
Man page 转 MediaWiki 有文件大小限制吗?
由于不上传,唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题,超大文件只是需要稍等片刻。
转换可以离线进行吗?
可以。页面加载完成后,转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
转换出来的 MediaWiki 之后还能编辑吗?
取决于目标格式:MediaWiki 为自己的用途而生,本转换器忠实还原其内容,而不是凭空制造可编辑结构。需要大量再编辑时,请从面向编辑的格式入手,最后在这里导出终稿。