如何将 AsciiDoc 转换为 Perl POD?
如何转换用 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 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
您应该能够使用
a2x
和rman
来完成此操作,首先将 asciidoc 转换为手册页格式,然后将其转换为 POD:groff
命令是用来修复一些格式问题的 - 显然rman
不理解a2x
生成的特定宏(我在此页面上找到了这条建议:http://www.datastat.com/sysadminjournal/misctips.html)。You should be able to accomplish this using
a2x
andrman
, to first convert asciidoc to man page format, then to convert that to POD:The
groff
command is there to fix some formatting issues -- apparentlyrman
does not understand specific macros produced bya2x
(I found this piece of advice on this page: http://www.datastat.com/sysadminjournal/misctips.html).