{{위키데이터 속성 추적}}
{{프로그래밍 패러다임}}
'''문학적 프로그래밍'''(literate programming)은 프로그래밍 방법론의 한 가지로, 프로그래밍을 할 때 컴퓨터로 컴파일 가능한 코드를 만드는 것보다 사람이 이해하기 쉬운 코드를 만드는 것에 중점을 두는 방법이다. 다시 말해, 사람이 보고 이해할 수 있도록 문서를 만들듯이 프로그래밍을 하는 것이 목적이다. '마치 문학작품을 읽는 것처럼 프로그래밍을 읽을 수 있도록 만드는 것'이 목표이므로 '문학적 프로그래밍'이라는 이름을 지었다.

문학적 프로그래밍에서는 프로그램에 대한 문서와 [[소스 코드]]가 하나의 소스 파일에 들어 있으며, 특별한 프로그램을 사용하여 문서와 소스 코드를 각각 따로 뽑아낸다. 소스 코드는 흔히 '덩어리'라고 부르는 단위로 구분하고, 각각의 덩어리가 어떤 원리로 동작하는지 등을 소스 파일에서 자세히 설명한다. 여기서 덩어리는 실제 소스 코드의 순서와 다르게 배열되어도 상관 없으며, 문서로 설명하고자 하는 순서대로 배열한다. 컴파일러나 인터프리터가 처리할 수 있는 형태로 만드는 것은 별도의 프로그램을 이용한다.

== 기원 ==
처음으로 개발된 문학적 프로그래밍 환경은 [[도널드 커누스]]가 [[TeX]] 조판 시스템을 만들면서 [[1981년]]에 개발한 [[웹 (프로그래밍)|웹]]이다. 웹은 프로그래밍 언어로는 [[파스칼 (프로그래밍 언어)|파스칼]]을 사용하고, 문서화는 <nowiki>TeX</nowiki>을 이용한다.

커누스는 <nowiki>TeX</nowiki> 전체 소스를 문학적 프로그래밍 형식으로 만들었고 이것을 문서화해서 자신의 다섯권짜리 책 《[[Computers and Typesetting]]》중에서 B권 《TeX: The program》으로 출판했다. 커누스는 [[1979년]]부터 DOC이라고 이름 지은 문학적 프로그래밍 환경을 이용했다. 커누스 본인은 [[Pierre Arnoul de Marneffe]]의 아이디어에서 영감을 얻어 이 작업을 시작했다고 한다. 파스칼만 사용할 수 있는 웹의 단점을 보완하여, 커누스와 레비는 [[CWEB]]을 만들었다. CWEB의 특징은 다음과 같다.
* 프로그래밍 언어로 [[C (프로그래밍 언어)|C]], [[C++]], [[자바 (프로그래밍 언어)|자바]] 등을 사용할 수 있다.
* 대부분의 운영체제에서 돌아간다.
* <nowiki>TeX</nowiki>뿐 아니라 [[PDF]] 문서도 만들 수 있다.
다른 문학적 프로그래밍 툴에는 [http://faq.ktug.or.kr/faq/noweb noweb], [[FunnelWeb]] 등이 있다.

== 구현 ==
문학적 프로그래밍 툴 중에서 가장 널리 쓰이고 가장 강력한 것으로 [https://web.archive.org/web/20060128235241/http://webpages.charter.net/edreamleo/front.html Leo]가 있다. Leo는 내부적으로 noweb과 CWEB 처리기를 내장하고 있으며, 사용하기 편리한 인터페이스를 가진 편집기도 제공한다. [[마이크로소프트 윈도우|윈도우]], [[리눅스]], [[OS X]] 등 다양한 시스템에서 돌아간다. Leo 설명서에는 문학적 프로그래밍에 대해서 알기 쉽게 설명한 것도 들어 있다.

문학적 프로그래밍과 비슷하게, 다음과 같은 [[문서 생성기]]를 이용하여 프로그램의 주석에서 문서를 뽑아내는 방법이 있다.
* [[pod]]: [[펄]]
* [[doc 플러스 플러스|doc++]]: C, C++, Java
* [[javadoc]]: [[자바 (프로그래밍 언어)|자바]]
* [[Doxygen]]: 여러 언어에 사용할 수 있음.
그러나 이런 방법은 엄밀한 의미의 문학적 프로그래밍과는 거리가 있다.
* 프로그램 함수와 파라미터에 대해 설명하는 방식으로 프로그램에 대해서 설명할 수는 있지만, 소스 코드 전체에 대해서 문서화할 수는 없다.
* 대부분의 문학적 프로그래밍 환경에서 사용하는 소스 파일은 문서화에 사용되는 파일도 아니고 소스 코드도 아닌 제 3의 형태를 가진다. 그러나 위와 같은 프로그램에서는 소스 코드에 주석으로 설명이 추가된 형태를 가진다.
* 문학적 프로그래밍에서는 소스 파일이 제3의 형태를 가지기 때문에, 프로그램에 대해서 설명할 때 작성자가 원하는 순서대로 프로그램 덩어리를 배열하여 설명할 수 있다. 그러나 위와 같은 도구에서는 소스 코드에 주석문의 형태로 설명을 붙인 것이기 때문에 설명 순서는 소스 코드의 순서를 따를 수밖에 없다.

== 참고 문헌 ==
* Donald E. Knuth, ''Literate Programming'', Stanford, California: Center for the Study of Language and Information, 1992, CSLI Lecture Notes, no. 27.
* Pierre Arnoul de Marneffe, ''Holon Programming''. Univ. de Liege, Service d'Informatique (December, 1973).
* [http://www.literateprogramming.com/ Literate Programming]
* [news:comp.programming.literate]

== 외부 링크 ==
* [https://web.archive.org/web/20060128235241/http://webpages.charter.net/edreamleo/front.html Leo]: 문학적 프로그래밍 도구
* [https://web.archive.org/web/20060125040922/http://www.ross.net/funnelweb/ FunnelWeb]: 문학적 프로그래밍 도구
* [https://web.archive.org/web/20060104044644/http://moonflare.com/code/select/index.php Select: noweb을 이용한 문학적 프로그래밍 예제]
* [http://xmlliterate.sourceforge.net/index.html XMLLiterate: Literate programming]: [[xmlliterate]]를 이용한 문학적 프로그래밍
* [http://faq.ktug.or.kr/faq/LiterateProgramming 문학적 프로그래밍]: KTUG(Korean TeX User Group)의 문학적 프로그래밍에 관한 전반적인 소개
* [https://web.archive.org/web/20070927104424/http://faq.ktug.or.kr/faq/CWEB CWEB]: 문학적 프로그래밍 도구

[[분류:문학적 프로그래밍| ]]
[[분류:소프트웨어 공학]]