著者のページを作成する最良の方法は？

StackOverflow https://stackoverflow.com/questions/2748817

  •  02-10-2019
  •  | 
  •  

質問

著者のページを作成するための最良の方法は何ですか？ Standard Man Macrosを使用して書く必要がありますか、それとも何らかのXML-Ifiedソースを撮影し、Manページ、HTML、ASCIIなどを出力できる巧妙なパッケージがありますか？

ありがとう

役に立ちましたか？

解決

私のために atinout 私が使用しているプログラム ロン これにより、構文のような非常に読みやすいマークダウンでマンページを書くことができます。私はそれに非常に満足しています。

atinout(1) -- Send AT commands to modem, capturing the response
===============================================================

## SYNOPSIS

`atinout` <input_file>|`-` <modem_device> <output_file>|`-`<br>
`atinout` `--version`<br>
`atinout` `--usage`<br>
`atinout` `--help`<br>

## DESCRIPTION

**Atinout** reads a list of AT commands. It sends those commands one by one
to the modem, waiting for the final result code for the
currently running command before continuing with the next command in
the list. The output from the commands is saved.
...

こちらのページ全体を参照してください.

他のヒント

私は以前、GroffというGNUバージョンのNroffバージョンを使用してMan Pagesを書きました。

ここにある素敵なイントロ記事：

http://www.linuxjournal.com/article/1158

ドキシゲン あなたが探しているものです。ソースコードを文書化するように設計されていますが、簡単に適応することができます。

HTML、PDF、およびLaTexドキュメントも生成できます。

一度書くことを検討し、マンページ、HTML、プレーンTXT、さらにはPDFなどのさまざまな出力形式を生成している場合は、 ドキュメントブック 最適に機能するはずです。

TCLコミュニティで一般的に使用されるツールは Doctools マンページ形式の制限された（ただし有用な）サブセットを生成できます。これは、GroffまたはNroffでのレンダリングに適しています。また、プレーンテキストとHTMLの両方を直接生成することもできます。

ライセンス： CC-BY-SA と 帰属
所属していません StackOverflow
scroll top