만덕의

mandoc
만덕의
초기 릴리즈2008년 11월
안정적 해제
1.14.5 / 2019년 3월 10일; 3년 전(2019-03-10)[1]
리포지토리
기록 위치C
유형유형설정
면허증ISC 라이선스
웹사이트mandoc.bsd.lv

mandoc(역사적으로 mdocml이라고 불림)은 BSD 운영 체제(예: NetBSD)에서 man 페이지를 포맷하는 데 사용되는 유틸리티로, 특히 mdoc 및 manmacro 언어로 작성된 페이지들이다.이러한 용도로 주로 사용되는 그로프 및 오래된 트로프 및 nroff 도구와는 달리man, mandoc는 특히 설명서에 초점을 맞추고 있으며 범용 유형 설정에 적합하지 않다.

mandoc주로 BSD 운영 체제에서 사용되는 mdoc 설명서를 포맷하는 데 사용되지만, Linux 배포에서 사용되는 대부분의 man macro는 물론, man macro와 가끔 혼합된 로프 명령의 하위 집합을 구현하기도 한다.[2][1]: 1.14.5 그것은 mm와 ms와 같은 다른 매크로 세트나 하이픈, 글꼴, 정렬과 같은 어떤 유형 설정 기능도 지원하지 않는다.[2]: compatibility 볼드체나 이탤릭체 등 심플한 스타일링이 지원되지만 이탤릭체화된 텍스트는 터미널에 밑줄이 그어진 텍스트로 대체된다.[3][4]

Mandoc은 troff soellim (immedi) 전처리에 대한 내장 지원과 tbl 및 eqn에 대한 부분 내장형 지원을 가지고 있다.UTF-8 출력에 대한 지지가 강하다.또한 mdoc 매뉴얼의 의미 정보를 사용하여 의미 검색을 구현할 수도 있는데, 1.4.1 이전 버전에서는 sqlite에 의존했다.[1]: 1.4.1

역사

만독은 2009년 2월에 초기 텍스트 모드 출력을 획득한 것에 대한 한계에 대응하여 CSS 지원 HTML 형식의 매뉴얼을 제작하기 위해 2008년 11월에 개발이 시작되었다.[5]그 후 아시아B에서 전시되었다.SDCon-2009.[6][7][8]2010년 여름, 만독은 기존 텍스트, HTML, XHTML 출력과 함께 포스트스크립트와 PDF 출력을 생산하기 위해 NetBSD가 고안한 Google Summer of Code 프로젝트의[9] 대상이 되었다.이 작업은 2010년 8월에 완료되었으며,[10] 2010년 11월에 출시된 Mandoc은 OpenBSD 4.8의 기본 포맷터가 되었다.[11][12]이후 NetBSD, FreeBSD, Illumos, Void Linux, Alpine Linux에서 디폴트 포맷터가 되었으며, DragonFlyBSD, MINIX 3, 데비안, 우분투, 젠투, 페도라에도 포함된다.[13]그것의 장점은 고속,[14] 면허, 그리고 깨끗한 재구성으로 명시되었다.

샘플 사용법

다음은 달리기를 보여준다.mandoc자력으로보통, 그것은 man utility를 통해 불릴 것이다.이 예에서는foo.1mdoc UNIX 매뉴얼의 이름.[15] 

 # 단말기에 대한 페이지 매뉴얼.$ mandoc -l foo.1 # 스타일시트가 있는 HTML 출력.$ mandoc -Ttml -Ostyle=style.css >foo.1.html

멀티바이트(현지화된) 매뉴얼도 사전 처리 없이 렌더링할 수 있다.이 예에서는foo.jp.1UTF-8로 인코딩된 일본어 매뉴얼이다. 만독은 인코딩을 자동으로 감지한다.[15] 

 # 단말기에 와이드 문자 설명서를 호출한다.$ mandoc -l foo.jp.1

포함된 apropos 구현은 다음과 같은 검색에서 의미 정보를 사용할 수 있다.[16]

 # return type size_t: $apropos -s 3 Ft=size_t -aNm~^str이 있는 'str'로 시작하는 모든 기능 검색

기타 기능

  • mandoc를 통해 HTML 5, PostScript 및 PDF 출력 지원-T매개 [15]변수
  • man.cgi웹에 수동 페이지를 표시하도록 설계된 CGI 프로그램이다.OpenBSD는 그것의 모든 수동 페이지를 포맷하기 위해 그것을 사용한다.[17]

참조

  1. ^ a b c "Release notes". March 10, 2019.
  2. ^ a b roff(7) – 오픈BSD 기타 정보 설명서
  3. ^ "Italics and colour in manual pages on a nosh user-space virtual terminal". jdebp.eu.
  4. ^ mandoc(1) – FreeBSD 일반 명령 설명서."폰트 스타일은 백스페이스 인코딩을 사용하여 응용된다.."
  5. ^ "Source history". Mdocml.bsd.lv. Retrieved 2010-12-18.
  6. ^ "AsiaBSDCon 2009: Deprecating groff for BSD manual display". 2009.asiabsdcon.org. 2009-03-15. Retrieved 2010-12-18.
  7. ^ "Deprecating groff for BSD manual display" (PDF). Retrieved 2010-12-18.
  8. ^ "Video of AsiaBSDCon presentation". Youtube.com. Retrieved 2010-12-18.
  9. ^ "Google Summer of Code: mandoc_ps". Netbsd-soc.sourceforge.net. Retrieved 2010-12-18.
  10. ^ "NetBSD Blog". Blog.netbsd.org. 2010-08-11. Retrieved 2010-12-18.
  11. ^ "OpenBSD 4.8". Openbsd.org. 2010-11-01. Retrieved 2010-12-18.
  12. ^ "groff deleted from tree".
  13. ^ "Availability of the mandoc toolset". Mdocml.bsd.lv.
  14. ^ Unangst, Ted. "mandoc speed benchmarks".
  15. ^ a b c mandoc(1) – OpenBSD 일반 명령 설명서
  16. ^ apropos(1) – OpenBSD 일반 명령 설명서
  17. ^ man.cgi(8) – 오픈BSD 시스템 관리자 설명서

외부 링크