☰

단일 소스 양식이 없습니다.

tag-icon • tag-icon man
단일 소스 양식이 없습니다.

매뉴얼 페이지를 보다 구조화된 형식으로 구문 분석하고 싶지만 매뉴얼 페이지에서 사용되는 데이터 형식에 대한 올바른 사양을 찾을 수 없습니다. troff, nroff, groff 또는 다른 것을 찾아야 합니까? 그로프(7) 라고

groff 시스템은 클래식 roff의 모든 기능을 갖고 있지만 많은 확장 기능을 추가합니다.

이러한 확장은 tbl이나 다른 것과 같은 다양한 전처리기입니까?

지금까지 다음 리소스를 찾았습니다.

  • 트로브 웹사이트- 여기에는 역사적 기록과 일부 튜토리얼, 일부 데드 링크가 포함되어 있습니다.

  • 롤프 (7) (오픈BSD,리눅스) - 실제 사양은 없으며 간략한 개요와 일련의 역사만 제공됩니다.

  • 매뉴얼 페이지(7) (리눅스) - 이는 매뉴얼 페이지의 다양한 섹션에 대한 가이드를 제공하지만(유용함) 데이터 형식에 대해서는 논의하지 않습니다.

  • Linotype 독립적인 TROFF그리고트로프 사용자 매뉴얼- 이것들은 꽤 오래되었기 때문에 이 논문에 있는 troff와 실제의 troff 사이의 차이점이 무엇인지 실제로 알 수 없습니다.

매뉴얼 페이지에서 사용되는 정확한 형식에 대한 명확한 사양이 있습니까?

답변1

단일 소스 양식이 없습니다.

어떤 사람들은 맨 페이지를 작성하기 위해 roff를 사용합니다. 원시 roff를 사용하는 사람은 거의 없지만 사람들은 an또는 와 같은 매뉴얼 페이지를 작성하기 위해 다양한 roff 매크로를 사용합니다 mdoc. 이러한 매크로 세트는 서로 크게 다릅니다. 하지만 이제는 많은 사람들이Roff에서는 맨 페이지를 전혀 작성하지 마십시오..

Docbook XML, Perl의 POD, TE X , T e χinfo, ASCIIDOC, 일반 HTML 또는 기타 시스템 으로 매뉴얼 페이지를 작성할 수도 있습니다 .

그 중 일부, 특히 Docbook XML은 처음부터 상당히 구조화되어 있으며 roff로의 변환은 손실이 있습니다. roff가 소스인 경우 이를 무시하고 실제 소스 양식으로 직접 이동하는 것이 더 좋습니다. 이는 이미 찾고 있는 구조화된 형식을 갖고 있을 수 있습니다.

실제로,아니요이 테이블 중 일부를 볼 때 roff 중개자. (위의 모든 내용은 중간 roff 단계를 거치지 않고 HTML과 같은 형식으로 직접 변환될 수 있습니다. Docbook XML을 사용하여 작성된 매뉴얼 페이지는 별도의 추가 작업 없이 여러 WWW 브라우저를 사용하여 XML로 직접 볼 수도 있다는 점을 다시 한 번 주목할 가치가 있습니다. HTML 중개자(if)문서집 CSS또는 이와 유사한 용도. )

이러한 소스 형식 중 다수는그들 자신표준화되었지만 매뉴얼 페이지에 대한 단일 범용 소스 형식은 없습니다.

예

답변2

예. HTML처럼 생각하세요...그러나 HTML 이전입니다. 기본적으로 다양한 타이포그래피 매크로 groff...

첫째, 상호 합의된 부분이 있습니다. 물론 더 추가할 수도 있습니다.

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
BUGS
AUTHOR
SEE ALSO

각각(그리고 다른 모든 곳)에 대해 groff조판 매크로 구문을 사용합니다.

예를 들어, TITLE HEADER할 수 있습니다 -

.TH [name of program] [section number] [center footer] [left footer] [center header]

아니면 SECTION HEADER-

.SH [section name]

물론 볼드체, 이탤릭체, 밑줄체 등도 가능합니다. -

.B = bold
.BI = bold alternating italic
.BR = bold alternating Roman
.I = italic
.IB = italic alternating bold
.IR = italic alternating Roman
.RB = Roman alternating bold
.RI = Roman alternating italic

텍스트 파일에 댓글을 남길 수도 있습니다.

." This is a comment

<p></p>그런 다음 단락(html 태그 세트 등)과 같은 것이 있습니다 ..PP

파일 이름을 적절하게 지정하고 gzip완료되면 이름을 지정하는 것을 잊지 마십시오.

이 정보(및 기타 정보)는 다음에서 제공됩니다.http://www.linuxhowtos.org/System/creatingman.htm

관련 정보