== noweb이란 == noweb 은 LaTeX 을 사용하는 cweb 이다. web/cweb 이 TeX 을 대상으로 하는 것처럼 noweb 은 LaTeX 을 대상으로 한다. 즉, 기존의 모든 LaTeX 의 패키지를 cweb 에서 제공하는 [literate programming] 과 함께 사용할 수 있다. == 다운로드/인스톨 == http://www.eecs.harvard.edu/nr/noweb/ 에서 소스를 다운로드 하여 컴파일 해주면 된다. == knoweb == 기존의 noweb 을 개선한 스타일 파일, http://www.k-online.com/~joer/noweb/knoweb.html 에서 다운로드 받을 수 있다. 이 버전이 문제가 없고 더 안정적이므로 가능하면 knoweb.sty 를 사용하도록 한다. == 예제 만들기 == 간단히 구구단을 해주는 예제를 만들어 보았다. {{{ \documentclass{article} \usepackage{noweb} \usepackage{dhucs} \begin{document} \section{구구단 만들기} 구구단을 해주는 프로그램을 작성해 보자. @ 가장 높은 레벨에서는 다음과 같이 처리할 수 있다. <>= <> <> <
> <> <> @ 상태는 [[status]]로 표시가 가능하다. <>= /* 헤더파일 */ #include #include @ <>= /* DoxyGen string */ int engine(int x, int y) { assert(x >= 0 && y >= 0); return (x * y); } @ <>= /* Write down the result. */ int print(int x, int y, int z) { printf("(%d) X (%d) = (%d)\n",x,y,z); } @ <
>= /* Main Routine */ int main() { int i, j; for (i = 1; i < 3; i++) { for (j = 1; j < 3; j++) { int z = engine(i,j); print(i,j,z); } } } @ <>= /* Test routine */ int test() { printf("testme\n"); } @ \end{document} }}} == 사용법 == 텍파일 얻기 {{{ noweave -delay nine.nw > nine.tex }}} 소스코드 얻기 {{{ notangle nine.nw -Rnine.c > nine.c }}} == 결과 == 텍소스를 컴파일 하면 pdf 를 얻을 수 있다. 소스코드를 컴파일 하면 프로그램을 얻을 수 있다. {{{ $ gcc nine.c -o nine $ ./nine (1) X (1) = (1) (1) X (2) = (2) (2) X (1) = (2) (2) X (2) = (4) }}} == 코드 청크 == noweb 은 {{{<<>>}}} 로 상징되는 코드 청크들을 하나로 모아주는 기능을 제공한다. {{{\nowebchunks}}} 명령을 이용한다. == 인덱스 == noweb 은 어떠한 정의가 어디에서 사용되었는지를 알려주는 index 를 만들 수 있다. === 인덱스 정의 === {{{[[main]]]}}} 과 같이 사용하면 main 이 인덱스로 기록된다. === 인덱스 지정 === {{{@ %def main}}} 을 코드청크 다음에 기록하면 인덱스와 코드청크가 연결이 된다. === 인덱스 생성 === {{{\nowebindex}}} 를 사용하여 생성한다. * noweb 명령에서 {{{-index}}} 를 추가한다. === 책갈피 === 보통의 hyperref 를 사용하는 것 만으로도 코드 청크 끼리의 연결이 자동으로 생성된다. == 기타 == * notangle 이 만들어 주는 소스코드는 조금 답답한 느낌을 준다. 이경우 bcpp 등을 이용하여 소스를 예쁘게 변환할 수 있다.