groff manマクロでタイトルの内容を制御する方法

groff manマクロでタイトルの内容を制御する方法

私はgroff manマクロを使って一般的なドキュメント(実際にはmanページではない)を生成します。なぜなら、groff man マクロは学習し使いやすいからです。しかし、PostScriptページのタイトルをフリーテキストで制御したいと思います。

これグローブマニュアル説明する:

manマクロをローカルに展開したりスタイルを変更したりするには、man.localファイルを使用してください。

マクロ:.PT

タイトルの内容を制御します。通常、ヘッダーは両側にコマンド名とセクション番号を印刷し、中間にTHのオプションの5番目の引数を印刷します。

実際にどうすればいいですか?

答え1

man.local表現はあいまいですが、そのファイル内のマクロを上書きするよりもファイル自体を変更することをお勧めします。

良い出発点はドキュメントです。5.21 マクロの作成(GNU Troffマニュアル)。これは方法を示しています。定義マクロ。

研究する実際のマクロはバージョンによって大きく異なります。 Debian では、PTパッケージgroff-baseの下でこのマクロを見つけました。

/usr/share/groff/1.21/tmac/an-old.tmac

〜のように

.\" Redefine these to customize the header & footer
.
.de1 PT
.  tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
..

名前付き変数を最初の引数として渡します.tl.tlそれが何であるか(grepはあなたの友人です)、何をしているのかを理解するには少し作業が必要です(言及されています)。ここ):

.tl(タイトル)が左、中央、右の3つの部分で構成されていることをご存知でしたか?

一方、groffの文書は長年にわたって改善されています。以下で見つけることができます。索引

一般的には、以下を見つけることができます。

  • ほとんどのマクロ(このファイルの読み込み中に遭遇する)は文書化されていません。
  • マクロリストを介してgrepすること(grep-wヘルプ)が特定のマクロを見つける唯一の方法です。
  • 一部のマクロのデバイス固有のバージョンは、汎用バージョンよりも優先されます。

答え2

修正されたマクロを使用してマニュアルページを本に印刷する方法については、Solarisのマニュアル印刷用のマクロを確認してください。

https://sourceforge.net/p/schillix-on/schillix-on/ci/default/tree/usr/src/cmd/troff/troff.d/tmac.d/

「an」ファイルを「ansun」マクロファイルと比較します。後者は本を印刷するために使用されます。

これは、 troff クローン「groff」ではなく、元の troff のマクロセットであることに注意してください。ただし、groffが互換性がある限り動作する必要があります。

関連情報