Manpages

이 름

man2html − 메 뉴 얼 페 이 지 를 HTML로 변 환 한 다 .

사 용 법

man2html [options] [file]

설 명

man2html은 file로 지 정 된 (혹 은 파 일 인 자 가 주 어 지 지 않 았 거 나 "-" 옵 션 이 주 어 지 면 , 표 준 입 력 으 로 부 터 읽 어 들 인 ) 메 뉴 얼 페 이 지 를 man 스 타 일 의 nroff로 부 터 HTML을 생 성 해 결 과 를 표 준 출 력 에 보 여 준 다 . tbl 매 크 로 는 지 원 하 지 만 , eqn 매 크 로 는 지 원 하 지 않 는 다 . 종 료 상 태 는 0 이 고 , 만 약 뭔 가 잘 못 되 면 , 오 류 페 이 지 를 표 준 출 력 에 보 여 준 다 .

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

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

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

옵 션

표 준 입 력 으 로 부 터 읽 어 들 일 때 , .so 확 장 을 어 떻 게 할 것 이 지 는 항 상 명 확 하 지 않 다 . −D 옵 션 을 사 용 하 면 작 업 디 렉 토 리 를 지 정 할 수 있 다 .
−D pathname

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

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

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

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

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

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

−H host[.domain][:port]

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

−M man2htmlpath

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

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

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

버 그

많 은 발 견 적 방 법 (heuristic)이 있 다 . 출 력 은 항 상 완 벽 하 다 고 할 수 없 다 . lynxcgi 방 법 은 lynx를 이 방 법 을 사 용 할 수 있 도 록 컴 파 일 하 지 않 으 면 사 용 할 수 없 다 . 또 한 보 안 상 의 문 제 가 있 을 수 있 다 .

관 련 항 목

lynx(1), man(1)

번 역

윤 현 호 <hhyoon [AT] kldp.org> 2004-03-25