GROFF_MWWW(7)

명칭
groff_mwww - 웹페이지의 오쏘링용 groff 매크로

서식
groff -mwww [ options ] file ...

해설
이 메뉴얼 페이지는, GNU -mwww 매크로에 대해 해설하고 있습니다. 이것은, groff 문서 정형 시스템의 일부입니다. 이 메뉴얼 페이지는, 매우 기본적인 가이드에 지나지않고, html 디바이스 드라이버 (grohtml) (은)는 아직껏 알파판이라고 하는 단계입니다. 많은 사람들이 테스트할 기회를 가질 수 있도록(듯이) 하기 위한(해), 이 매크로를 배포물에 포함하고 있습니다. 이 매크로 파일은, -Thtml 를 사용하면 (troffrc 파일에 의해) 자동적으로 불리는 것이라고 하는 것에 주의해 주세요.

하이퍼 링크가 동작하는 것을 확인하려면 , 이 메뉴얼 페이지를 grohtml 디바이스를 이용해 정형해 주세요.

이것은, 이 매크로 세트로 발견되는 기능의 개요입니다.

서식
.HTMLINDEX    섹션 / 헤더용으로 자동적으로
    작성되는 링크의 레벨을 결정합니다.
.BODYCOLOR    웹페이지의 색을 지정합니다.
.BACKGROUND    배경 화상을 지정합니다.
.URL    2 개의 파라미터를 이용해 URL 를 작성합니다.
.MAILTO    HTML 용 전자메일 주소를 작성합니다.
.FTP    FTP 에의 참조를 작성합니다.
.IMAGE    화상 파일을 삽입합니다.
.HTML    디바이스 드라이버에 생의 HTML
    리퀘스트를 건네줍니다.
.TAG    $1 로부터 HTML 의 name 태그를 생성합니다.
.LINE    수평 방향의 괘선을 폭 가득 작성합니다.

pic, eqn, refer 및 tbl 프리프로세서의 출력을 입력으로서 받아들일 수가 있습니다.

리퀘스트

HTMLINDEX
    표제에 대해서 자동적으로 작성되는 링크의 잘라서 버림 레벨을 결정합니다. 디폴트에서는, troff 문서중에 있다 모든 표제에의 링크가 HTML 웹페이지의 선두에 작성됩니다. 아마, 세세한 레벨의 표제에는 링크는 필요없는 것이 많을 것입니다. 또 웹페이지에 따라서는, 표제에의 링크는 모두 필요없는 것도 있을지도 모릅니다. 이러한 경우,

    .HTMLINDEX 0

    (으)로 하면(자), grohtml 하지만 링크를 생성하지 않게 됩니다. HTMLINDEX 를 2 로 하면(자)

    1.1. 1 Some Title

    그렇다고 하는 표제도, 3 레벨눈의 표제가 있다고 하는 것으로, 링크에 포함되지 않게 됩니다. 자동적인 표제를 바꾸는 다른 방법은, 명령행 스윗치 -P-l 입니다.

BODYCOLOR
    5 개(살) 파라미터를 취하는: 캐릭터색, 배경색, 액티브한 하이퍼 링크의 색, 아직 방문했던 적이 없다 하이퍼 링크의 색, 그리고 방문한 것이 있다 하이퍼 링크의 색입니다.

BACKGROUND
    이 매크로의 유일한 파라미터는, 배경 화상 파일을 나타냅니다.

URL 2 개(살) 혹은 3 개의 파라미터를 사용해 URL 를 생성합니다. $1 (은)는 링크명,$2 은 실제의 URL, 그리고 $3 는 $2 의 직후에 인자되는 옵션 부분입니다. 실제의 URL 를 인자하는 동안, 하이픈 자동 삽입은 무효화됩니다. 명시적인 개행 위치는, \: 그리고 삽입해야 합니다. 이것은, 의 encode의 방법을 나타낸 것입니다.

    .URL "groff 의 홈 페이지" http://\:groff.\:ffii.\:org/ :

    -Thtml 이외의 디바이스로 이것을 처리하면(자), 다음과 같이 표시됩니다: groff 의 홈 페이지 ⟨http://groff. ffii. org⟩. URL 매크로는, 어떤 종류의 요소에서도 사용할 수 있습니다. 예를 들면, 그렇다고 하는 참조를 다음과 같이 해 만들 수가 있습니다:

    .URL "Eric Raymond 의 pic 가이드" pic.html

MAILTO
    HTML 용의 전자 메일 참조를 생성합니다. 제 1 인수는, 전자메일 주소로서 필수의 것입니다. 제 2 인수는 옵션이며, 브라우저에 표시되는 텍스트입니다. 그리고, 제 3 인수나 옵션이며, 이것은 제 2 인수의 직후에 표시되는 것입니다. 실제의 전자메일 주소를 인자하는 동안, 하이픈 자동 삽입은 무효화됩니다. 예를 들면, groff 멘테나는 (와)과 입니다. 이것은, 다음의 매크로로 실현됩니다:

    .MAILTO wl@gnu.org "Werner Lemberg"
    .MAILTO Ted.Harding@nessie.mcc.ac.uk "Ted Harding" .

    실제로는, groff 에서는 URL 는 텍스트로서의 공백을 일절 사용하지 않는 것으로서 다루어지는 것에 주의해 주세요. 이것은, 몇개의 문제의 원인이 되기 때문에 버그라면 생각되겠지요. 이것을 회피하기 위해서, www.tmac 는 그 밖에 영향을 주지 않는 공백에 전개되는 폭 0 의 캐릭터를 삽입합니다 (-Thtml 부로 실행되었을 경우만).

FTP 데이터가 FTP 경유로 취득할 수 있는 것을 나타냅니다. 제 1 인수는, 브라우저에 표시되는 텍스트이며, 제 2 인수는 URL 입니다. 제 3 인수는, 먼저 말한 매크로와 같게, 제 2 인수의 직후에 표시되는 텍스트로서 다루어집니다. 제 2 및 제 3 의 인수는 옵션입니다. 실제의 URL 를 인자하는 동안, 하이픈 자동 삽입은 무효화됩니다. 예로서 이것은, 의 장소입니다. 이 매크로의 예는, 다음과 같이 지정합니다:

    .FTP "현재의 groff 개발자용 배포물" \
    ftp://ftp.ffii.org/\:pub/\:groff/\:devel/\:groff-current.tar.gz

IMAGE
    문서에 화상을 포함할 수가 있습니다. 제 1 인수는 화상 파일입니다. 제 2 의 옵션은, 수평 위치를 지정합니다. l (은)는 화상을 왼쪽 맞춤에, r (은)는 화상을 오른쪽 공격으로 합니다. 그 외의 값은 화상을 중앙에 둡니다. 다음의 2 개의 인수는 옵션입니다. 제 3 인수는 화소수에서의 화상의 폭입니다 (지정이 없으면, 디폴트는 400 화소입니다). 제 4 인수는 화소수에서의 화상의 높이입니다 (지정이 없으면, 디폴트는 화상폭과 같습니다).

HTML
    이 매크로의 뒤에 계속된 텍스트는 모두 생의 HTML 로서 다루어집니다. 문서가 -Thtml 를 사용하지 않고 처리되는 경우, 이 매크로는 무시됩니다. 이 매크로는, 보다 고수준인 다른 매크로의 원가요소입니다.

    예를 들면, BACKGROUND 매크로는 다음과 같이 정의됩니다:
    .de BACKGROUND
    .    HTML <body background=\$1>
    ..

TAG 인수로부터 HTML 의 name 태그를 생성합니다. 이 태그는, 매크로를 사용해 참조할 수 있습니다. 보심대로, 동일 문서내의 참조이므로, 태그명의 전에는 `#'를 붙이지 않으면 안됩니다. 이 링크는, 앞의 URL 매크로의 기술 중(안)에서 TAG 를 두는 것으로 실현되었습니다. 소스는 다음과 같이 됩니다:

    .TP
    . B URL
    (은)는,
    .TAG URL
    (을)를 생성합니다.
    URL 는 2 개 혹은 3 개의
    인수를 사용합니다.
    $1 하지만 링크의 이름, 그리고 $2 가 실제의 URL 입니다.

LINE
    수평 방향으로 폭 가득한 괘선을 생성합니다. 다음이 예입니다:

    .LINE

LINKS
    (은)는, grohtml 가 자동적으로 생성되는 링크를 이 정도치에 두도록(듯이) 요구합니다. 례:

섹션 표제에의 링크

디폴트에서는, grohtml (은)는 섹션의 찾아내 모두에의 링크를 생성해, 링크를 HTML 문서의 선두에 배치합니다. 오프로 하거나 위치를 바꾸기 위한 자세한 것은 (을)를 참조해 주세요.

grohtml 의 제한

tbl 정보는, 현상 png 이미지로 그려집니다.

관련 파일
/usr/share/tmac/mwww.tmac (www.tmac 에의 나팔)
/usr/share/tmac/www.tmac

관련 항목
groff(1), troff(1), grohtml(1)

저자
grohtml 하 하지만 썼습니다.

버그
버그 리포트는 에 보내 주세요. 버그를 재현할 수 있도록(듯이), 완전해 자기 완결하고 있는 예를 붙여 주세요. 또, 어느 버젼의 groff 를 사용하고 있을지도 전해 주세요.