KTUGFaq: CTWILL

KTUGFaq

KTUG FAQ

CTWILL (rev. 1.4)

It is better to wear out than to rust out.

SystemInfo
FrontPage
ClipMacro
ConTeXt

CTWILL

Ubuntu占쏙옙占쏙옙TeX占싹깍옙&value=PDF만들기 › WinEdtTip/DOS占쏙옙�占쏙옙占�&value=Yhchoe/WinEdt絹 › JedEditor&value=TeX편집기 › KC2008/PDFSync › VimLaTeX › CTWILL

[편집]

CTWILL 시스템 ¶

[편집]

소개 ¶

CWEB 시스템으로 하는 문학적 프로그래밍은 컴퓨터 프로그래머들로 하여금 마치 자신이 소설이나 수필을 쓰고 있는 듯한 착각을 불러 일으킬 정도로 프로그래밍 작업을 즐겁게하여 줍니다. 뿐만아니라, 그 작업 결과 또한 매우 깔끔하고 훌륭합니다. 특히, 프로그램 도큐먼트 맨 뒤에 자동으로 생성해주는 인덱스는 매우 유용합니다.

한 편의 짧은 에세이 정도 길이의 프로그램이라면 그 인덱스가 매우 유익할텐데, 장편 소설 같은 프로그램이라면 상황이 달라집니다. 오히려 도큐먼트 맨 뒤에 나오는 인덱스는 골칫거리가 될 수도 있습니다. 프로그램 소스를 읽는다는 것은 보통의 소설이나 수필을 읽는 것과는 약간 차이가 있어서, 그 소스에 사용된 변수나 함수등 각종 식별자들의 정의와 쓰임새등을 세세히 자주 파악할 필요가 있습니다. 그럴 때마다, 즉 어떤 변수의 정의나 쓰이는 곳을 찾기 위해서 도큐먼트의 맨 뒤의 인덱스를 찾아서 해당 페이지로 가는 것은 매우 귀찮은 작업입니다.

우리에게 친숙한 TeX: The Program 역시 web 시스템으로 작성된 문학적 프로그램인데, 그 소스의 도큐먼트 페이지가 500 페이지가 훨씬 넘고, 맨 뒤에 나오는 인덱스만도 30 페이지가 넘습니다. 이러한 상황을 해결하기 위한 방법 중의 하나는 인덱스를 맨 뒤에만 두는 것 뿐만 아니라, 도큐먼트 전반에 걸쳐서 매 오른쪽 페이지에 둔다면, 현재 페이지에서 사용된 변수나 함수들을 쉽게 찾아 볼 수 있을 것입니다. 이러한 인덱스를 미니 인덱스(mini-indexes) 라고 하는데, ctwill 시스템은 문학적 프로그래밍 할 때에 미니 인덱스를 생성하도록 도와줍니다.

Knuth는 그의 책 [http]

The Stanford GraphBase는 ctwill을 이용해서 미니 인덱스를 갖춘 멋진 책입니다.

[편집]

구성 ¶

CTWILL 시스템은 크게 세 개의 프로그램으로 구성되어 있습니다.

ctwill
이 프로그램은 cweave를 변형한 two-pass 프로그램입니다. cweave가 cwebmac.tex 매크로 파일을 사용하는 반면, ctwill 프로그램은 cwebmac.tex 매크로과 거의 동일하지만, 미니 인덱스 생성등 책을 만드는 데에 보다 초점을 맞춘 ctwimac.tex 매크로 파일을 이용합니다.
refsort
foo.w라는 cweb 파일에 ctwill 프로그램을 적용하고 나면, foo.ref라는 미니 인덱스 생성에 필요한 reference 파일이 생기는데, 이 foo.ref 파일을 정렬하여, 소트된 버전의 foo.sref를 만들어 냅니다.
twinx
ctwill 시스템은 매우 큰 하나의 cweb 프로그램으로 책을 만들거나, 여러 개의 작은 cweb 파일을 묶어서 책을 만드는 경우에 사용됩니다. The Stanford GraphBase는 후자의 경우에 해당합니다. 이러한 경우, 미니 인덱스 뿐만 아니라 여러 cweb 소스들의 major indexes도 필요한데, twinx는 이 경우에 사용됩니다.

[편집]

설치 ¶

ctwill.tar.gz내의 Makefile에는 그 흔한 make install도 제공하지 않습니다. -_-;

ctwill.tar.gz의 압축을 풀고, cweb 설치 할때와 마찬가지로 한글(utf-8)을 이용하기 위해서 common.w 파일의 buffer_end 정의한 곳에서 buffer_size를 long_buffer_size로 바꿉니다.
make ctwill, make refsort, make twinx를 통해서 실행 파일을 만들어 path가 잡혀 있는, 예를들어, /usr/local/bin에 둡니다.
ctwimac.tex, twinxmac.tex 등 매크로 파일을 tex이 알 수 있는 디렉토리에 둡니다.

[편집]

사용예 ¶

foo.w 라는 이름으로 웹파일을 작성한다.
먼저 ctwill 프로그램으로 foo.tex 파일들을 생성한다.
```
ctwill foo.w
```
위에서 생성한 foo.tex 으로부터 foo.ref 파일을 생성한다.
```
tex foo.tex
```
위 단계에서 생성한 reference 파일, foo.ref를 소트하여 foo.sref를 만든다.
```
refsort < foo.ref > foo.sref
```
최종적으로 tex을 한 번 더 실행한다.
```
tex foo.tex
```
twinx를 이용하여 master 인덱스를 생성합니다.
```
twinx foo.tex > index.tex
```
인덱스 파일, index.tex을 컴파일 합니다.
```
tex index.tex
```
위의 6, 8 단계에서 생성한 foo.dvi, index.dvi로 책을 만듭니다.
```
dvipdfmx foo
dvipdfmx index
```

[편집]

ctwill 예제 ¶

The Stanford GraphBase: A Platform for Combinatorial Computing, Donald E. Knuth 지음
Knuth의 대표적인 ctwill 사용 예제: Hamiltonian circuits (3268)

last modified 2013-02-17 08:42:13
Processing time 0.0450 sec

로그인:
비밀번호:
가입