0

man.cgi に似た BSD man ページのコレクションでサイトを開始したいと考えていますが、静的な HTML であり、ports ツリーのすべてのものも含まれています。

最近のリリースのすべての OpenBSD パッケージから解凍しようとしましたが、一部のパッケージはでページを提供していますが、他のいくつかのパッケージは でターミナル形式のページのみを提供man/していることに気付きました。mdocman/man?/page.?man/cat?/page.0

のファイルに対してgroff -mdoc -Thtmlまたはmandoc -Txhtmlを使用できますが、ファイルを からXHTMLに変換するにはどうすればよいですか?mdocman/man?/catman/cat?/

FreeBSD.org と NetBSD.org の man.cgi スクリプトはどのようにこれを行うのですか?

4

1 に答える 1

0

MirBSD では、すべてのオンライン マンページを静的な HTML として配信し (実際の Web CGI は非常に小さいため)、巧妙なスクリプトnroff -Tcol foo.1 | col -xを使用して出力を XHTML/1.1に変換します。(1)およびmdoc および man マクロパッケージ (および ms および me など) はわずかに異なります。ただし、ベースからのすべてのマンページと、歴史的な BSD ドキュメントのみを出荷しています。

また、GNU gnroff には -Tcol がありませんが、-Tascii は機能します。ただし、これを gnroff 出力で使用する場合は、それに応じて正規表現を変更する必要がある場合があります。

このファイルを編集するときは特に注意してください。通常の UTF-8 のほか、余分な制御文字や無効なバイト シーケンスが含まれています。注意しないと、エディタファイルを破損します。(私は自分でjuppを使用しています。)

これに関するライブ フィードバックについては、MirBSD IRC チャンネルにアクセスしてください。

あなたの最初の目標について:バイナリパッケージからのみマンページを収集することをお勧めします。これは、autoconf の AC_SUBST などによってコンパイル中に変更されることが多いため、またはパッケージビルドの一部としてのみ生成されることさえあるためです。

于 2013-09-17T21:46:45.730 に答える