如何将 AsciiDoc 转换为 Perl POD?

发布于 2024-12-07 20:22:34 字数 341 浏览 2 评论 0原文

如何转换用 AsciiDoc 编写的联机帮助页 轻量级标记语言自动融入Perl的POD(普通旧文档)?

也许是从 DocBook 转换为 POD 的东西(从 AsciiDoc 源到手册页格式的转换,即 troff 通过 DocBook(通过 XML))。

How to convert manpage written in AsciiDoc lightweight markup language automatically into Perl's POD (Plain Old Documentation)?

Perhaps something that converts from DocBook to POD (the conversion from AsciiDoc sources to manpage format i.e. troff goes via DocBook (via XML)).

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

梦年海沫深 2024-12-14 20:22:34

您应该能够使用 a2xrman 来完成此操作,首先将 asciidoc 转换为手册页格式,然后将其转换为 POD:

a2x -f manpage foo.1.txt
groff -e -mandoc -Tascii foo.1 | rman -f POD > foo.pod

groff 命令是用来修复一些格式问题的 - 显然 rman 不理解 a2x 生成的特定宏(我在此页面上找到了这条建议:http://www.datastat.com/sysadminjournal/misctips.html)。

You should be able to accomplish this using a2x and rman, to first convert asciidoc to man page format, then to convert that to POD:

a2x -f manpage foo.1.txt
groff -e -mandoc -Tascii foo.1 | rman -f POD > foo.pod

The groff command is there to fix some formatting issues -- apparently rman does not understand specific macros produced by a2x (I found this piece of advice on this page: http://www.datastat.com/sysadminjournal/misctips.html).

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文