TWiki 转 DocBook转换器
所有处理都在你的设备上完成，大文件可能需要一点时间。
TWiki Markup与DocBook XML的定位并不相同：TWiki 是 TWiki/Foswiki 的企业级 wiki 标记——---+ 标题、%变量% 和内联表格——至今仍运行在许多企业内网里。当 XML 源需要变成 Word 手稿、Markdown 文档或网页时，转换 DocBook。
由于整个转换都在你的设备上完成，它快速、无限量且真正私密——无需账号、没有水印、文件不会出现在任何服务器上。多个文件一次性转换。
TWiki 与 DocBook 的对比
| TWiki | DocBook | |
|---|---|---|
| 数据结构 | TML 纯文本（---+、%VAR%、| 表格 |） | 语义 XML（<chapter>/<section>/<para>） |
| 类型与校验 | UTF-8 文本 | XML，DTD/RelaxNG 校验 |
| 兼容性 | TWiki/Foswiki、Pandoc | XSL-FO、Pandoc、docbook-xsl |
| 最适合 | 内网 wiki 迁移 | 书籍、手册、企业文档 |
如何将 TWiki 转换为 DocBook
- 1
选择文件
选择你的 TWiki 文件。
- 2
立即转换
文件先转换成 Markdown（保留标题、列表与段落的中间格式），再重建为目标格式。
- 3
下载结果
下载 DocBook——结构保留，复杂排版被简化。
关于 TWiki 格式
TWiki 在 2000 年代写下企业 wiki 的教科书——---+ 标题语法、%变量% 宏和 TML 表格随企业内网扩散，还催生了 Foswiki 分支。一代人的内部文档活在这种标记里，服务器往往没人敢升级。
迁移这些内网正是 TWiki 转换的价值所在：Pandoc 读取 TML 的标题、列表、表格和 wiki 链接，重新输出为 Markdown（给 Confluence 时代的平台）或 Word/HTML（给冻结的存档）。
+优点
- ✓为结构化内网知识而生
- ✓宏变量支持模板化页面
- ✓企业装机量巨大
!局限
- −Foswiki 分叉后式微
- −变量与插件内容转换时通常丢失
- −只有遗留工具链
关于 DocBook 格式
DocBook 是工业技术出版所依赖的 XML 方案。它标记的不是外观而是语义：<chapter>、<section>、<para>、<figure>、<indexterm>。单一 DocBook 源可渲染成 PDF（FO 处理器）、HTML 帮助系统、EPUB 和印刷书——O'Reilly、Red Hat 以及几乎所有企业手册管线都依赖它，你 Linux 机器上的 man 页也源自同一血脉。
DocBook 的严谨就是它的重量：手写冗长，把内容搬进更轻的系统是常年的杂务。Pandoc 直接读取元素结构，书的一章能原样变成 Word 手稿或 Markdown 文档页——章节、表格、代码块完好——单源交付出去，编辑舒适度进来。
+优点
- ✓语义化、无外观耦合的唯一事实源
- ✓单源渲染出印刷、网页与 EPUB
- ✓数十年的企业级工具链
!局限
- −XML 冗长——手写痛苦
- −沉重的处理器工具链（XSL-FO）
- −比手册短的内容用它是杀鸡用牛刀
为什么把 TWiki 转换成 DocBook？
可以把它理解为：把文件搬进更合适它的容器。Foswiki 分叉后式微DocBook 的做法不同：语义化、无外观耦合的唯一事实源如果这听起来正是你要做的事，直接转——几秒钟，文件不离开你的设备。
常见问题
TWiki 转 DocBook 真的免费吗？
完全免费，无需注册、无水印、也没有每日次数限制。网站依靠广告维持运营。
我的文件会被上传到服务器吗？
不会。转换通过 WebAssembly 完全在你的浏览器内完成，文件不会离开你的设备——这正是它既快又私密的原因。
Windows、Mac、iPhone、安卓都能用吗？
可以。任何装有现代浏览器的设备都适用：Windows、macOS、Linux、安卓和 iOS，无需安装任何软件。
TWiki 转 DocBook 有文件大小限制吗？
由于不上传，唯一的限制是你设备的内存。现代桌面浏览器处理几百 MB 的文件都没问题，超大文件只是需要稍等片刻。
转换可以离线进行吗？
可以。页面加载完成后，转换完全在浏览器内运行——你甚至可以断网继续转换。任何文件都不会经过服务器。
TWiki 文件的排版会完全保留吗？
本转换器会把 TWiki 的内容渲染成 DocBook，在目标格式允许的范围内尽量保持页面、比例与图片原样。下载前请用预览确认效果符合预期。