groff man 매크로에서 제목 내용을 제어하는 ​​방법

groff man 매크로에서 제목 내용을 제어하는 ​​방법

나는 groff man 매크로를 사용하여 일반 문서(실제로는 man 페이지가 아님)를 생성합니다. 왜냐하면 groff man 매크로는 배우고 사용하기 쉽기 때문입니다. 그러나 포스트스크립트 페이지 제목을 자유 텍스트로 제어하고 싶습니다.

이것그로브 매뉴얼설명하다:

man 매크로를 로컬로 확장하거나 스타일을 변경하려면 man.local 파일을 사용하세요.

매크로:.PT

제목의 내용을 제어합니다. 일반적으로 헤더는 양쪽에 명령 이름과 섹션 번호를 인쇄하고 중간에 TH에 대한 선택적 다섯 번째 인수를 인쇄합니다.

실제로 어떻게 해야 합니까?

답변1

man.local표현은 모호하지만 해당 파일에 있는 매크로를 덮어쓰는 것보다 파일 자체를 수정하는 것이 좋습니다 .

좋은 출발점은 문서입니다.5.21 매크로 작성(GNU Troff 매뉴얼). 이는 방법을 보여줍니다.정의매크로.

연구할 실제 매크로는 버전에 따라 크게 다릅니다. 데비안에서는 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(제목)이 왼쪽, 가운데, 오른쪽 세 부분으로 구성되어 있다는 사실을 알고 계셨나요 ?

반면에 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가 호환되는 한 작동해야 합니다.

관련 정보