We don’t allow questions seeking recommendations for software libraries, tutorials, tools, books, or other off-site resources. You can edit the question so it can be answered with facts and citations.
Closed 6 years ago.
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
接受
或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
发布评论
评论(4)
您可以用
markdown
编写它,然后通过pandoc
将其转换为手册页格式 ((t|g)roff
)。这是精美的手册:http://johnmacfarlane.net/pandoc/README.html。华泰
You can write it e.g. in
markdown
then convert it via e.g.pandoc
to manpage format ((t|g)roff
). Here is the fine manual: http://johnmacfarlane.net/pandoc/README.html .HTH
当然,继续学习格式并在常规文本编辑器中手写。
另一方面,
perl
项目使用一种称为pod
的通用标记,然后通过运行pod2man
转换为手册页。Sure, go ahead and learn the format and write it by hand in a regular text editor.
On the other hand, the
perl
project uses a kind of universal markup calledpod
and then converts into manpages by runningpod2man
.手册页是使用一种名为
troff
的简单标记语言以纯文本形式编写的。实际上有几个相关的标记系统都由一组以
roff
结尾的命令支持:nroff
,troff
,以及所有唱歌,所有跳舞超集groff
。我的 Mac OS 10.5 系统在
man 7 roff
中有一个很好的历史总结。正如其他人所指出的,有几种工具可以将其他标记格式转换为手册页。
Man pages are written in plain text with a simple markup language called
troff
.Actually there are several related markup systems all supported by a set of commands ending in
roff
:nroff
,troff
, and the all singing, all dancing super-setgroff
.My Mac OS 10.5 systems has a nice summary of the history in
man 7 roff
.As others have noted there are several tools around which can convert other markup formats to man pages.
最简单的方法是将内容编写为“reStructuredText”(比 wiki 语法更简单)并使用 docutils 从中生成联机帮助页。
请参阅本教程。
The easiest way is to write content as "reStructuredText" (simpler than wiki syntax) and use docutils to generate manpage from it.
See this tutorial.