MAN2HTML

이름

사용법

설명

이 프로그램은 stand-alone 도구로도 사용할 수 있지만, 주된 목적은 사용자가 메뉴얼 페이지를 lynx(1), xmosaic(1), netscape(1) 등과 같은 HTML 브라우저를 통해 볼 수 있도록 보조하는 것이다.

man2html의 주요 부분은 Richard Verhoeven <rcb5@win.tue.nl>에 의해 쓰여진 troff-to-html 엔진이다. 이것은 다음과 같은 형태의 하이퍼링크를 추가한다.

foo(3x)	"http://localhost/cgi-bin/man/man2html?3x+foo"
method://string	"method://string"
www.host.name	"http://www.host.name"
ftp.host.name	"ftp://ftp.host.name"
name@host	"mailto:name@host"
<string.h>	"file:///usr/include/string.h"

(다른 메뉴얼 페이지를 링크할 경우, 옵션에 의해 변경할 수 있다. 아래에 나와있으니 참조하라.) 링크의 확인은 하지 않는다. 즉, 링크가 가리키는 것이 존재하고 있지 않더라도 링크는 만들어진다. 문서 내부에서 각 섹션에 대한 하이퍼링크도 만들어진다. 따라서, bash(1) 같이 큰 메뉴얼 페이지에서 필요한 부분을 찾는 것이 편해진다.

옵션

-D pathname

pathname의 마지막 두 부분을 없애고, 변환을 시작하기 전에 거기로 이동(chdir)한다.

-E 옵션을 이용하면 cgi 스크립트로부터 간단하게 오류 메세지를 생성할 수 있다.

-E string

주어진 오류 메시지를 포함한 오류 페이지를 출력한다.

참조처가 메뉴얼 페이지인 하이퍼링크는 일반적으로 아래와 같은 형식으로 생성된다.

<method:cgipath><man2htmlpath><separator><manpage>

위의 내용을 기본값으로 사용하지만, 하이퍼링크의 각 부분은 옵셩들을 이용해서 원하는 내용으로 설정할 수 있다.

-h

<method:cgipath>를 http://localhost 로 설정한다. 이것이 기본값이다.

-H host[.domain][:port]

<method:cgipath>를 http://host.domain:port 로 설정한다.

-l

<method:cgipath>를 lynxcgi:/home/httpd 로 설정한다.

-L dir

<method:cgipath>를 lynxcgi:dir 로 설정한다.

-M man2htmlpath

사용할 man2htmlpath를 설정한다. 기본값은 /cgi-bin/man/man2html 이다.

-p

<separator>를 '/'으로 설정한다.

-q

<separator>를 '?'으로 설정한다. 이것이 기본값이다.

httpd가 실행되고 있지 않은 기계에서 lynxcgi 방법을 이용해서 lynx를 통해 메뉴얼 페이지를 열람할 수 있다. http 데몬이 실행되고 있을 경우에는 lynx, 혹은 다른 브라우저에서도 http 방법을 이용해서 메뉴얼 페이지를 열람할 수 있다. -l (`lynxcgi') 옵션은 첫번째 방법을 사용하는 것이고 cgipath 기본값은 /home/httpd 이다.

일반적으로 cgi 스크립트는

<path_to_script>/<more_path>?<query>

과 같이 부를 수 있다. 환경 변수 PATH_INFO와 QUERY_STRING는 각각 <more_path>, <query>로 설정된다. lynxcgi는 PATH_INFO 부분을 다룰 수 없기 때문에, 기본값으로 `?' 을 구분자로 하는 하이퍼링크를 생성한다. `-p'(`path') 옵션은 '/'를 구분자로 사용하고, `-q'(`query')는 '?'를 구분자로 사용한다.

-H host 옵션은 localhost 대신 이용하는 호스트를 지정한다. 환경 변수 SERVER_NAME이 설정되어 있으면 cgi 스크립트에서

man2html -H $SERVER_NAME

와 같이 사용할 수 있다. 이렇게 해서 사용하는 기계를 메뉴얼 페이지를 제공하는 서버처럼 동작시킬 수 있다.  

버그

관련 항목

번역

Index

이름

사용법

설명

옵션

버그

관련 항목

번역