2006-03-23
Doxygen
설치
- 공식 홈페이지에서 최신 Doxygen 을 받아서 설치한다.
- Graphiz 홈페이지에서 dot 툴을 받아서 설치한다.
- Microsoft HTML Helper를 받아서 설치한다.
설정
- Doxygen GUI frontend 를 실행한 후, 맨 처음에는 Wizard 모드로 기본 설정을 하고, 다시 Expert 모드로 상세하게 설정을 해주면 된다. 이때 매번마다 환경을 변경한 다음에는 Doxyfile 로 저장하는 것을 잊지 말도록.
- SeriousCode:DoxygenSetup 을 참고해서 배치파일을 잘 만들어두면 편하다.
DoxygenTips
- 상대경로를 애용할 것 : 범용성을 위해 INPUT 및 OUTPUT_DIRECTORY 는 상대 경로로 지정하고, DoxyWizard 의 Working Directory 를 절대 경로를 사용할 것. Doxygen 이 알아서 둘을 조합한다.
- CREATE_SUBDIR 을 설정하면, html 폴더에 너무 많은 파일들이 몰리는 현상을 막을 수 있다.
- FULL_PATH_NAMES 를 설정하고, STRIP_FROM_PATH 에 Working Directory 를 추가해주면, 여러 개의 하위 폴더에 나눠진 파일들의 경로를 출력할 수 있다
- HHC_LOCATION 은 일반적으로
C:/Program Files/HTML Help Workshop/hhc.exe를 지정하면 된다. (Visual Studio 를 설치하면 저기에 자동으로 설치가 되기 때문) - DOT_IMAGE_FORMAT 은 png 로 설정하면 용량이 많이 줄어든다. 단 jpg + DOT_TRANSPARENT 의 조합은 용량이 무지막지하게 커지므로 주의할 것.
- DOT_PATH 는 일반적으로
C:/Program Files/ATT/Graphviz/bin을 지정할 것
see also: