알고 싶습니다. 매크로 패키지를 사용하여 UNIX 매뉴얼 페이지를 작성하는 방법에는 (장 제목)과 (섹션)이 man
있습니다 . 하지만 "하위 섹션"을 갖고 싶다면 어떻게 해야 할까요?.SH
.SS
그런 기준이 있나요? 일부 페이지에서 (적어도 troff
) 의 글꼴 크기를 수정하는 것을 본 것 같지만 .SS
실제로 일부 (준) 표준이 있는지 궁금합니다.
답변1
나는 짧은 대답이 "아니요"라고 믿습니다. 매뉴얼 페이지에는 하위 섹션에 대한 표준이 없습니다.
이 문제는 작년 9월에 발생했습니다.메일링 linux-man
리스트, 많은 자료가 선별되어 있지만 man
그렇게 하는 데 허용되는 관용구를 아는 사람은 아무도 없습니다.
제가 강조하고 싶은 점은 "필요하다면매뉴얼 페이지, [그러면] 전체 페이지에 대한 토론 수준이 너무 개략적입니다. "맨 페이지를 여러 문서로 나누는 것을 금지하는 법은 없습니다. 이것이 groff와 Perl이 하는 일입니다.
심지어원본 man
매크로 패키지의 매뉴얼 페이지(1979)심지어 분할된 매크로를 기록하지 않은 채 문 밖으로 나갔습니다 SS
.
나에게 있어서 이러한 (의도적인?) 감독은 "간결한" 문서라는 매뉴얼 페이지의 원래 개념과 일치하는 것 같습니다.
만약 당신이 이것을 해야만 한다면, 나는 당신만의 매크로를 작성하거나 TP
스레드에서 논의된 것처럼 그것을 남용하지 않을 것입니다 linux-man
. 아마도 "가져오기 헤더"를 사용할 것입니다. 즉, 제목으로 시작하는 단락을 이탤릭체나 굵은 글씨로 표시합니다.
.P
.B Error handling.
The Z language does not support an exception mechanism.
Therefore you have to check return values at every point blah blah blah
답변2
Perl의 POD 문서 형식 은 다양한 형식으로 변환될 수 있으며 pod2man
.Pod::Man
=head1
로 번역.SH
, 사용.IX Header "...."
=head2
로 번역.SS
, 사용.IX Subsection "...."
=head3
다음을 사용하여 기울임꼴 글꼴로 번역됩니다..IX Subsection "...."
=head4
다음을 사용하여 일반 텍스트로 변환됩니다..IX Subsection "...."
=head3
and 의 제목 텍스트 는 다음과 같이 =head4
s로 둘러싸여 있습니다 ..PP
.PP
title text
.IX Subsection "title text"
.PP