[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
화일의 이름이나, 문서의 제목같은 몇가지 정보는 Texinfo 화일이 시작할때 제공해야 한다.
• Four Parts | Four parts begin a Texinfo file. | |
3.1 Sample Texinfo File Beginning | Here is a sample beginning for a Texinfo file. | |
3.2 The Texinfo File Header | The very beginning of a Texinfo file. | |
3.3 Summary and Copying Permissions for Info | Summary and copying permissions for Info. | |
3.4 The Title and Copyright Pages | Creating the title and copyright pages. | |
3.5 The ‘Top’ Node and Master Menu | Creating the ‘Top’ node and master menu. | |
3.6 Software Copying Permissions | Ensure that you and others continue to have the right to use and share software. |
일반적으로, Texinfo의 시작부분에는 4가지 부분이 있다.
@ifinfo
와 @end ifinfo
명령으로 둘러싼다.
@titlepage
와 @end titlepage
명령으로 둘러싸여 있다. 표지와 copyright page는 인쇄된 매뉴얼에만
나타난다.
또 옵션으로, 프로그램에 대한 copying condition과 warranty disclaimer를 포함할 수 있다. copying section 다음에는 개요나 그외 매뉴얼의 첫번째 장이 올 것이다.
Texinfo 문서에 대한 (프로그램에 대한 copying permission이 아니라) copyright notice와 copying permission은 Info 화일이나 인쇄된 매뉴얼에서 나타나는 부분이기 때문에 이 정보는 두번 써야 한다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
다음 예는 무엇이 필요한지를 보여준다.
\input texinfo @c -*-texinfo-*- @c %**start of header @setfilename name-of-info-file @settitle name-of-manual @setchapternewpage odd @c %**end of header @ifinfo This file documents … Copyright year copyright-owner Permission is granted to … @end ifinfo @c This title page illustrates only one of the @c two methods of forming a title page. @titlepage @title name-of-manual-when-printed @subtitle subtitle-if-any @subtitle second-subtitle @author author @c The following two commands @c start the copyright page. @page @vskip 0pt plus 1filll Copyright @copyright{} year copyright-owner Published by … Permission is granted to … @end titlepage @node Top, Overview, (dir), (dir) @ifinfo This document describes … This document applies to version … of the program named … @end ifinfo @menu * Copying:: Your rights and freedoms. * First Chapter:: Getting started … * Second Chapter:: … … … @end menu @node First Chapter, Second Chapter, top, top @comment node-name, next, previous, up @chapter First Chapter @cindex Index entry for First Chapter |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Texinfo 화일은 Info와 TeX에 필요한 정보를 제공하는 최소한 세줄로
시작한다. 이 세줄은 \input texinfo
줄, @settitle
줄,
그리고 @setfilename
줄이다. 만약 TeX으로 Texinfo 화일의
일부를 처리한다면, @settitle
과 @setfilename
줄을
start-of-header와 end-of-header 줄 사이에 놓아야 한다.
그러므로 Texinfo 화일의 시작은 다음과 같다:
\input texinfo @c -*-texinfo-*- @setfilename sample.info @settitle Sample Document |
또는 다음과 같다:
\input texinfo @c -*-texinfo-*- @c %**start of header @setfilename sample.info @settitle Sample Document @c %**end of header |
3.2.1 The First Line of a Texinfo File | The first line of a Texinfo file. | |
3.2.2 Start of Header | Formatting a region requires this. | |
3.2.3 @setfilename | Tell Info the name of the Info file. | |
3.2.4 @settitle | Create a title for the printed work. | |
3.2.5 @setchapternewpage | Start chapters on right-hand pages. | |
3.2.6 Paragraph Indenting | An option to specify paragraph indentation. | |
3.2.7 End of Header | Formatting a region requires this. |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Texinfo 화일이 TeX의 맨 상위 레벨의 input으로 처리되려면 반드시 다음과 같은 줄로 시작해야 한다:
\input texinfo @c -*-texinfo-*- |
이 줄은 두가지 기능을 한다:
\input texinfo
명령은 TeX이
Texinfo 화일을 처리하기 위한 매크로를 읽도록 한다. 이 매크로는 보통
‘/usr/lib/tex/macros’ 디렉토리에 있는 ‘texinfo.tex’이라는
화일에 있다. TeX은 Texinfo가 명령어의 처음을 표시하기 @
를
사용하는 것처럼 위해 backslash, ‘\’를 사용한다. ‘texinfo.tex’
화일은 ‘\’에서 ‘@’로 바꾼다; 바뀌기 전에 TeX은 화일의 맨
처음에 와야 하기 때문에 ‘\’가 필요하다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Texinfo 화일의 두번째 줄에 start-of-header 줄을 쓴다. start-of-header
줄 다음에는 @setfilename
과 @settitle
줄, 그리고 옵션으로
@smallbook
이나 @footnotestyle
과 같은
다른 명령어들이 온다; 그리고 end-of-header 줄이 온다. (see section End of Header).
이 줄들이 있으면 Texinfo 화일의 일부분을 Info로 format하거나 일부를 프린트할 수 있다.
start-of-header 줄은 다음과 같다:
@c %**start of header |
괴상한 문자열인 ‘%**’는 다른 어떤 comment도 우연히 start-of-header 줄이 되는 일이 없도록 분명히 해준다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@setfilename
makeinfo
나 TeX의 주요 input 화일이 되기 위해서, Texinfo 화일은
다음과 같은 줄을 갖고 있어야 한다:
@setfilename info-file-name |
@setfilename
명령은 줄이 시작할때 쓰고, 같은 줄에 Info 화일의
이름을 쓴다. 그 라인에 다른 어떤 것도 쓰지 말라; comment를 포함해서
명령어 다음에 오는 어떤 것도 화일이름의 일부로 간주될 것이다.
@setfilename
줄은 생성될 Info 화일의 이름을 지정한다.
Texinfo 화일의 이름과는 다른 이름이어야 한다. 이름을 결정할때 두가지
습관이 있다; ‘.tex’ 확장자를 입력 화일 이름에서 없애거나, 그
확장자를 ‘.info’ 확장자로 바꾸는 것이다.
몇몇 operating system은 긴 화일 이름을 처리하지 못한다. 지정한 화일이름은 충분히 짧은 경우에도 문제에 부딪힐 수 있다. Info formatter가 긴 Info 화일을 짧은 부화일로 쪼개고, 원 화일 이름에 ‘-1’, ‘-2’, …, ‘-10’, ‘-11’ 등을 덧붙이기 때문이다. (See section Tag Files and Split Files.) 예를 들어 ‘texinfo.info-10’이라는 부화일의 이름은 몇몇 system에서는 너무 길다; 그래서 이 문서의 Info 화일의 이름은 ‘texinfo.info’가 아니라 ‘texinfo’이다.
Info formatting 명령은 @setfilename
줄 앞에 쓰여진 모든 것을
무시한다. 왜냐하면 화일의 맨 첫 줄(\input
줄)은 주석처리할
필요가 없기 때문이다.
@setfilename
줄은 인쇄된 매뉴얼에서는 어떤 출력도 내질 않는다.
하지만 꼭 필요한 작업이다; 이 명령은 Texinfo에서 사용되는 색인, 상호
참조, 그 외 외부 화일을 연다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@settitle
인쇄된 매뉴얼을 만들기 위해서, Texinfo 화일은 다음과 같은 라인을 갖고 있어야 한다:
@settitle title |
@settitle
명령을 줄이 시작할때 쓰고, 계속해서 같은 줄에 제목을
쓴다. 이 명령은 TeX에게 header나 footer에 쓸 제목을 알려준다. 그
줄에 다른 어떤 것도 쓰지 말라; 주석은 물론 명령어 다음에 오는 그 줄의
어떤 것도 제목의 일부로 간주될 것이다.
전통적으로 TeX이 Texinfo 화일을 양면 출력을 위해 format할때, 제목은
왼쪽 (짝수 번호의) 페이지의 heading에 인쇄되고, 현재 장의 제목은 오른쪽
(홀수 번호의) 페이지의 heading에 인쇄된다. (TeX은 @chapter
명령으로부터 각 장의 제목을 알아낸다.) 페이지의 footer는 인쇄되지
않는다.
한쪽면 스타일로 인쇄할때에도, heading에 매뉴얼의 제목을 포함할 경우,
TeX은 @settitle
명령어줄을 찾는다.
@settitle
명령은 TeX에서 실제 출력을 생성하는 어떤 부분보다도
앞에 와야 한다.
settitle
명령에 있는 제목은 보통 표지에 있는 제목과 같지만,
표지에 있는 제목에는 전혀 영향을 끼치지 않는다. 즉, 이 두개는 정확히
일치할 필요가 없다; 그래서 @settitle
명령에 있는 제목은 표지에
있는 제목을 줄이거나 늘린 버전이 될 수 있다. (See section @titlepage
.)
TeX은 @end titlepage
명령 다음에 오거나, heading을 작동시키는
@headings
다음에 오는 글에 대해서만 heading을 출력한다.
(더 많은 정보는 See section The @headings
Command.)
원한다면 직접 heading과 footing을 만들 수도 있다. (이 작업에 대한 자세한 설명은 See section Page Headings.)
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@setchapternewpage
책이나 매뉴얼에서는 글은 양면에 인쇄되고, 장은 오른편 페이지에서 시작한다. 그리고 오른편 페이지는 홀수번호의 페이지이다. 하지만 때때로 짤막한 보고서나 글은 종이의 한쪽 면에만 인쇄된다. 또 짤막한 보고서에서는 장은 새로운 페이지에서 시작하지 않고, 앞장이 끝난 다음에 수직으로 약간 공간을 띄운 다음 같은 페이지에서 시작한다.
TeX이 어떻게 장을 시작하고, 한쪽면에 인쇄하도록 typeset할지 양쪽면에
인쇄하도록 할지 지정하려면 @setchapternewpage
명령을 여러가지
argument와 함께 사용할 수 있다.
@code{@setchapternewpage} 명령을 줄이 시작할때 쓰고, 그 다음에 그 argument를 쓴다.
예를 들어, 새로운 홀수번째 페이지에서 각 장이 시작하도록 하려면 다음을 쓸 것이다.
@setchapternewpage odd |
@setchapternewpage
명령과 함께 세가지중 하나를 지정할 수 있다.
@setchapternewpage off
는 TeX이 수직으로 약간 공간을 띄운 다음 이전의 장과 같은 페이지에서
새로운 장을 typeset하게 한다. 또, TeX이 page header를 한면 인쇄에
적합하도록 format한다. (header 형식은 @headings double
명령으로
바꿀 수 있다; The @headings
Command.)
@setchapternewpage on
은 TeX이 새로운 페이지에 새로운 장을 시작하도록 하고, 한면 인쇄에 적합하게 page header를 typeset하게 한다. 이것은 짤막한 보고서에서 가장 자주 쓰이는 형식이다.
이것 대신 아무것도 쓰지 않아도 상관없다.
@setchapternewpage odd
는 TeX이 새로운 홀수번째 페이지(오른편 페이지)에서 새로운 장을 시작하도록 하고, 양면 인쇄에 적합하도록 typeset한다. 이것은 책이나 매뉴얼을 위해 가장 자주 쓰이는 형식이다.
Texinfo는 @setchapternewpage even
명령이 없다.
(@headings
명령으로 @setchapternewpage
명령을
취소하거나, 수정할 수 있다. See section The @headings
Command.)
매뉴얼이나 책이 시작할때, 페이지에 번호가 붙여지지 않는다–예를 들어, 책의 표지와 copyright page는 번호가 붙지 않는다. 전통적으로, 차례 페이지는 로마숫자로 번호가 붙여지고, 문서의 다른 부분의 일련번호에는 들어 있지 않다.
Info 화일은 페이지가 없기 때문에 @setchapternewpage
명령은
여기에는 아무 영향을 주지 않는다.
보통 한면 인쇄를 할때는 @setchapternewpage
명령을 쓰지 않고,
한면에 인쇄하도록 typeset하고, 새로운 장을 새로운 페이지에 시작하도록
되어 있는 기본값을 사용한다. 보통 양면 인쇄를 할때는
@setchapternewpage odd
명령을 사용한다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
Info formatting 명령은 각 문단이 시작할때 공백을 집어넣어서 문단을
들여쓸 수 있다. 이 들여쓰는 크기를 지정하기 위해
@paragraphindent
명령을 사용한다. @paragraphindent
명령을 줄이 ㅤㅅㅣㅈㄱ할때 쓰고, 그 다음에 ‘asis’나 숫자를 쓴다.
형식은 다음과 같다:
@paragraphindent indent |
Info formatting 명령은 indent 값에 따라 들여 쓴다.
indent의 기본값은 ‘asis’이다.
@paragraphindent
명령을 end-of-header 줄의 앞이나, 그 뒤에 멀지
않은 곳에 쓴다. (이 명령을 start-of-header와 end-of-header 줄 사이에
쓰면, region formatting 명령은 지정한 만큼 문단을 들여쓴다.)
texinfo-format-buffer
와 texinfo-format-region
명령의
독특한 점은 @w
나 @*
명령이 들어 있는 문단은 들여 쓰지
않는다(채우지도 않는다)는 점이다. 무엇을 하는지 자세한 설명은
See section Refilling Paragraphs.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
header를 end-of-header줄로 계속한다. end-of-header 줄은 다음과 같다:
@c %**end of header |
start-of-header와 end-of-header 줄 사이에 @setchapternewpage
명령을 포함하면, TeX은 region을 지정한 명령대로 typeset할 것이다.
비슷하게 start-of-header와 end-of-header 줄 사이에 @smallbook
명령을 넣으면, TeX은 region을 “small” book 형식으로 typeset할
것이다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
표지와 copyright 페이지는 매뉴얼을 인쇄할때만 나타나고, 똑같은 정보는 Info 화일의 한 section에 들어 있어야 한다. 이 section은 보통 Info 화일의 내용에 대한 짤막한 설명, copyright notice, 그리고 copyright permission이 들어 있다.
copyright notice는 다음과 같아야 한다:
Copyright year copyright-owner |
그리고 한 줄에 단독으로 써야 한다.
copyright permission의 표준 문구가 이 매뉴얼의 부록에 들어 있다; 완전한 문구는 ‘ifinfo’ Copying Permissions.
Info 화일 안의 permission 문구는 첫번째 node의 앞에 와야 한다. 이것은 읽는 사람은 고급 Info 명령 g *를 사용할 때를 빼고는 Info를 사용해서 읽을때 이 문구를 읽지 않는다는 것을 뜻한다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
매뉴얼의 제목과 저자는 보통 표지에 인쇄된다. 또한 copyright 정보는 표지에 인쇄되기도 한다; 그보다는 copyright 정보는 표지의 뒷장에 인쇄되는 일이 많다.
표지와 copyright 페이지는 인쇄된 매뉴얼에는 나타나지만, Info 화일에서는 아니다. 이것때문에 Info 화일에서 사용되지 못하는 약간 이해하기 어려운 TeX typesetting 명령을 사용할 수 있다. 또, Texinfo 화일 시작의 이 부분은 인쇄된 매뉴얼에서 나타나는 copying permission이 들어 있을 수 있다.
copright permission의 표준 문구에 대해서는 See section Titlepage Copying Permissions .
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@titlepage
표지와 다음의 copyright 페이지는 @titlepage
를 그 줄에 단독으로
쓴 @end titlepage
를 그 줄에 단독으로 써서 끝낸다.
@end titlepage
명령은 새로운 페이지를 시작하고, 페이지 번호를
붙이는 것을 시작한다. (어떻게 page heading을 만드는 지에 대해 자세히
알고 싶으면 See section Page Headings.) 번호가 붙지 않은
페이지에 나타내고 싶은 모든 것을 @titlepage
와 @end
titlepage
명령 사이에 놓는다. @page
명령을 사용해서
@titlepage
와 @end titlepage
명령으로 구분되는 부분
중간에서 페이지를 강제로 넘기게 할 수 있고, 그래서 한개 이상의 번호가
붙지 않은 페이지를 만들 수 있다. 이것이 copyright page를 만드는
방법이다. (@titlepage
명령은 @titleandadditionalpages
명령이라고 이름짓는 것이 더 나을 것이지만, 이건 너무 길다.)
컴퓨터 프로그램에 관한 매뉴얼을 쓸때, 그 매뉴얼이 적용되는 프로그램의
버전을 표지에 써야 한다. 매뉴얼이 프로그램보다 자주 변경되거나,
프로그램과는 독립적으로 변경될때, 매뉴얼의 edition
번호(5)를 포함할
수도 있다. 이렇게 하면 독자가 어느 매뉴얼이 프로그램의 어느 버전을 위한
것인지 찾아보기 쉬워진다. (‘Top’ node에도 이 정보가 있다; @top
.)
Texinfo는 표지를 만드는 두가지 주요 방법을 제공한다. 한가지 방법은
페이지의 단어들이 가운데 오도록 되어 있는 표지를 만들기 위해
@titlefont
, @sp
, 그리고 @center
명령을 사용한다.
두번째 방법은 제목 밑에 검은 줄이 있고, 저자이름을 쓴 줄과, 부제 글을
페이지의 오른쪽으로 치우치게 하기 위해 @title
,
@subtitle
, 그리고 @author
명령을 사용한다. 이 방법으로
실제 표지를 만들기 위한 어떤 것도 지정하지 않는다. 원하는 어떤 글이라도
지정하면 Texinfo는 formatting을 할 것이다. 둘중 어떤 방법을 사용해도
된다.
매우 단순한 방법으로, Texinfo는 제목을 한개 argument로 받는
@shorttitlepage
명령을 제공한다. 이 argument는 한 페이지에 혼자
typeset되고, 그 다음에 빈 페이지가 온다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@titlefont
, @center
, and @sp
인쇄된 매뉴얼의 표지를 만들기 위해 @titlefont
, @sp
,
그리고 @center
명령을 쓸 수 있다. (이것이 Texinfo에서 표지를
만들기 위한 두가지 방법중 하나이다.)
제목을 쓰기에 적합한 큰 폰트를 선택하려면 @titlefont
명령을
사용한다.
예를 들어:
@titlefont{Texinfo} |
해당 줄의 나머지 글들을 중앙에 오게 하려면 줄이 시작할때 @center
명령을 쓴다.
@center @titlefont{Texinfo} |
는 제목을 중앙에 오게 한다. 이 예에서 제목은 title font로 인쇄된 “Texinfo”이다.
수직으로 공백을 집어 넣으려면 @sp
명령을 쓴다. 예를 들어:
@sp 2 |
이것은 인쇄된 문서에 두개의 빈 줄을 넣는다. (@sp
명령에 대한 더
많은 정보를 얻으려면 See section @sp
.
이 방법의 기본틀은 다음과 같다:
@titlepage @sp 10 @center @titlefont{name-of-manual-when-printed} @sp 2 @center subtitle-if-any @sp 2 @center author … @end titlepage |
이 예의 공백은 폭 8 1/2 inch이고, 높이 11 inch인 매뉴얼에 맞는다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@title
, @subtitle
, and @author
수직과 수평으로 공백을 띄우는 것이 자동으로 처리되는 표지를 만들려면
@title
, @subtitle
, 그리고 @author
명령을
사용한다. 이 방법은 수직으로 공백을 띄우기 위해 @sp
명령이
필요한 이전 section에서 설명된 방법과 대조된다.
@title
, @subtitle
, 또는 @author
명령은 줄이
시작할때 쓰고, 다음에 제목, 부제목, 저자를 쓴다.
@title
명령은 제목이 보통보다 큰 폰트로 페이지의 왼쪽에 치우쳐진
줄을 만들 것이다. 제목은 검은 밑줄이 그어져 있다.
@subtitle
명령은 페이지의 오른쪽으로 치우쳐진 보통 크기 폰트의
부제목을 만든다.
@author
명령은 표지의 밑바닥과 가까운 곳에 왼편으로 치우쳐진
중간 크기 폰트로 쓰여진 저자의 이름(혹은 이름들)을 만든다. 이 이름은
제목이 그어진 밑줄보다 더 가는 검은 밑줄이 그어진다. (이 검은줄은
@author
명령어 줄 다음에 @page
명령어 줄이 와야만
생긴다.)
@author by Jane Smith and John Doe |
또는 두개 (혹은 그 이상의) @author
명령을 사용해서 이름들을
위아래로 쓸 수 있다:
@author Jane Smith @author John Doe |
(맨 마지막 이름만 검은색 밑줄이 그어진다.)
이 방법의 기본틀은 다음과 같다:
@titlepage @title name-of-manual-when-printed @subtitle subtitle-if-any @subtitle second-subtitle @author author @page … @end titlepage |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
국제조약에 의해, 책의 copyright notice는 표지나, 표지의 뒷면에 있어야 한다. copyright notice는 해당 년도와 그 다음에 copyright를 소유하고 있는 단체나 사람의 이름을 포함해야 한다.
copyright notice가 표지의 뒷면에 있을때, 그 페이지는 보통 번호가 붙지
않는다. 그래서 Texinfo에서는, copyright 페이지의 정보는
@titlepage
와 @end titlepage
명령 사이에 있어야 한다.
페이지를 넘기려면 @page
명령을 사용한다. copyright notice와
copyright 페이지의 그 외의 글들이 페이지의 밑바닥에 오게 하려면,
@page
명령 다음에 다음과 같은 조금 알기 어려운 줄을 쓴다.
@vskip 0pt plus 1filll |
이것은 Info formatting 명령으로 지원되지 않는 TeX 명령이다.
@vskip
명령은 공백을 넣는다. ‘0pt plus 1filll’은 강제로 0
포인트의 공백을 넣고, 다음 글을 페이지의 밑바닥으로 보낼 만큼 많은
공백을 넣는다. ‘filll’ 단어에서 세개의 ‘l’을 사용하는
것에 주목하자; 이것은 TeX에서는 올바른 사용이다.
인쇄된 매뉴얼에서는, @copyright{}
명령은 원안에 ‘c’를
만든다. (Info에서는 ‘(C)’를 만든다.) copyrigt notice는 다음과
같은 법적으로 정의된 순서를 따른다;
Copyright © year copyright-owner |
보통 copyright notice 다음에 어떻게 매뉴얼을 얻을 수 있는지에 대해서 쓰고, 그 다음에 이 매뉴얼의 copying permission을 쓴다.
permission은 header 바로 다음에 오는 @ifinfo
와 @end
ifinfo
사이의 요약부분 뿐만 아니라 여기에도 나타나야 한다는 것에
유의하자. 왜냐하면 이 글은 인쇄된 매뉴얼에만 나오고, ‘ifinfo’의
글은 Info 화일에만 나오기 때문이다.
permission의 표준 문구를 보려면 See section Sample Permissions.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@end titlepage
명령을 한줄에 단독으로 쓰는 것은 표지와 copyright
페이지의 끝을 표시할 뿐만 아니라, TeX이 앞으로 만들어질 페이지에
heading을 붙이고, 페이지 번호를 붙이도록 한다.
다른 곳에서 얘기한 것을 반복하면, Texinfo는 두가지의 페이지 heading
형식이 있다. 한개는 각 종이의 한쪽 면에만 인쇄(single-sided
pringting)되는 문서를 위한 heading이고, 다른 하나는 각 종이의 양쪽 면에
인쇄(double-sided printing)되는 문서를 위한 heading이다.
(See section @setchapternewpage
.)
이 형식을 여러가지 방법으로 지정할 수 있다:
@setchapternewpage
명령을 표지 명령 앞에 쓰는
것이다. 그러면 @end titlepage
명령이 원하는 모양으로 페이지
heading을 만들어 준다. (See section @setchapternewpage
.)
@headings
명령으로 페이지 heading이 한면이나,
양면 인쇄를 위해서 만들어지거나, 시작하지 못하게 할 수 있다.
(@end titlepage
명령 다음에 바로 @headings
명령을 쓴다.
더 많은 정보를 얻으려면 See section The @headings
Command.)
대부분의 문서는 표준적인 한면이나, 양면 형식으로 되어 있고, 양면 인쇄를
하려면 @setchapternewpage odd
명령을 쓰고, 한면 인쇄를 하려면
@setchapternewpage
명령을 쓰지 않는다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
@headings
Command@headings
명령은 거의 사용되지 않는다. 이 명령은 각 페이지에
인쇄할 heading과 footing의 종류를 결정한다. 보통 이것은
@setchapternewpage
명령에 의해 조정된다.
@setchapternewpage
명령이 원하는 대로 하지 못하거나, 미리 정의된
page heading을 사용하지 않고, 자신만의 것을 정의하고 싶을때만
@headings
명령이 필요하다. @headings
명령을 @end
titlepage
명령 바로 다음에 쓴다.
다음과 같이 @headings
를 사용할 수 있다:
@headings off
페이지 heading을 인쇄하지 않는다.
@headings single
한면 인쇄에 적합한 페이지 heading을 인쇄한다.
@headings double
양면 인쇄에 적합한 페이지 heading을 인쇄한다. 두개의 명령
@headings on
과 @headings double
은 동의어다.
@headings singleafter
@headings doubleafter
현재 페이지가 출력된 다음, 각각 single
과 double
heading을
인쇄하도록 한다.
예를 들어, TeX이 이전 장의 끝과 같은 페이지에 새로운 장을 시작하도록
하기 위해 @titlepage
명령 앞에 @setchapternewpage off
명령을 썼다고 가정하자. 이 명령은 TeX이 한면 인쇄를 위한 page
heading을 typeset하도록 하기도 할 것이다. TeX이 양면 인쇄로
typeset하도록 하려면, @headings double
을 @end titlepage
명령 다음에 쓴다.
다음과 같이 @headings off
를 한줄에 단독으로 @end
titlepage
명령이 있는 줄 바로 다음에 쓰면 TeX이 어떤 페이지
heading도 만들지 않도록 할 수 있다:
@end titlepage @headings off |
@headings off
명령은 @end titlepage
명령을 번복하고,
한편으로는 TeX이 페이지 heading을 인쇄하도록 한다.
자신만의 페이지 heading과 footing 스타일을 지정할 수도 있다. 더 많은 정보를 얻으려면 See section Page Headings.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
‘Top’ node는 한개의 Info 화일을 들어가는 node이다.
‘Top’ node는 Info 화일과 전체 Info 화일의 커다란 master menu에 대한 짤막한 설명을 담고 있어야 한다. 이렇게 하면 읽는 이가 이 Info 화일이 무엇에 관한 내용인지 이해하기 쉬울 것이다. 또, 이 Info 화일이 적용되는 프로그램의 버전 번호를 써야 한다; 또는 최소한 edition 번호를 써야 한다.
‘Top’ node의 내용은 Info 화일에만 나타나야 한다; 아무것도 인쇄된
매뉴얼에는 나타나서는 안되기 때문에 @ifinfo
와 @end
ifinfo
명령으로 둘러싼다. (TeX은 @node
줄이나 메뉴를
인쇄하지 않는다; 엄밀히 말해서 이 부분을 @ifinfo
와 @end
ifinfo
로 둘러쌀 필요가 없다. 하지만, 이렇게 하는 것이 제일 간단하다.
See section Conditionally Visible Text.)
• Title of Top Node | Sketch what the file is about. | |
3.5.1 Parts of a Master Menu | A master menu has three or more parts. |
때때로, 문서의 제목이 담겨 있는 @top
sectioning 명령을
@node Top
줄 다음에 쓰고 싶을 수도 있다. (보다 자세한 정보는
see section The @top
Sectioning Command.)
… @end titlepage @ifinfo @node Top, Copying, (dir), (dir) @top Texinfo Texinfo is a documentation system… This is edition… … @end ifinfo @menu * Copying:: Texinfo is freely redistributable. * Overview:: What is Texinfo? … @end menu |
‘Top’ node에서는 ‘Previous’와 ‘Up’ node는 보통 전체 Info 시스템의 맨 윗 레벨을 가리키고, 이것은 ‘(dir)’라고 한다. ‘Next’ node는 main 또는 master menu의 첫번째 node를 가리키고, 이것은 보통 copying permission, 소개, 혹은 첫번째 장이다.
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
master menu는 화일의 모든 node를 나열한 자세한 main menu이다.
master menu는 @menu
와 @end menu
명령으로 둘러싸여져
있고, 인쇄된 매뉴얼에는 나타나지 않는다.
일반적으로 master menu는 여러가지 부분으로 나뉜다.
@detailedmenu
를 맨 앞 node의 앞에 붙이고,
@end detailmenu
를 맨 뒷 node 뒤에 붙인다; 그렇지 않으면
makeinfo
를 혼란스럽게 할 것이다.
menu의 각 부분은 설명하는 줄로 시작한다. 줄이 asterisk로 시작하지 않는다면, menu 항목으로 취급되지 않을 것이다. (보다 자세한 설명은 See section Writing a Menu.)
예를 들어, 이 매뉴얼의 master menu는 다음과 같다(하지만, 더 많은 항목이 있다):
@menu * Copying:: Texinfo is freely redistributable. * Overview:: What is Texinfo? * Texinfo Mode:: Special features in GNU Emacs. … … * Command and Variable Index:: An entry for each @-command. * Concept Index:: An entry for each concept. @detailmenu --- The Detailed Node Listing --- Overview of Texinfo * Info Files:: What is an Info file? * Printed Manuals:: Characteristics of a printed manual. … … Using Texinfo Mode * Info on a Region:: Formatting part of a file for Info. … … @end detailmenu @end menu |
[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
If the Texinfo file has a section containing the “General Public License” and the distribution information and a warranty disclaimer for the software that is documented, this section usually follows the ‘Top’ node. The General Public License is very important to Project GNU software. It ensures that you and others will continue to have a right to use and share the software.
The copying and distribution information and the disclaimer are followed by an introduction or else by the first chapter of the manual.
Although an introduction is not a required part of a Texinfo file, it
is very helpful. Ideally, it should state clearly and concisely what
the file is about and who would be interested in reading it. In
general, an introduction would follow the licensing and distribution
information, although sometimes people put it earlier in the document.
Usually, an introduction is put in an @unnumbered
section.
(See section The @unnumbered
and @appendix
Commands.)
[ << ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
This document was generated by Autobuild on August 22, 2016 using texi2html 1.82.