30분만 투자하면 사용하는 API 문서 검색 엔진, Doxygen 외부 검색 설정하기

간단 소개

Doxygen 외부 검색 기능 설정 방법과 아파치/NGINX 서버 연동 및 Xapian 검색 엔진 설정 방법을 설명합니다.

AI Summary

Doxygen 외부 검색 기능 설정
- Doxygen은 C++, C#, Java, Python 등 다양한 언어의 API 문서를 자동 생성하는 도구이다.
- 기본 검색 기능의 한계를 극복하기 위해 EXTERNAL_SEARCH 옵션을 사용, Xapian 오픈 소스 검색 엔진을 연동한다.
- 아파치 HTTP 서버와 NGINX를 이용한 설정 방법을 제시하며, WAS 설정의 구체적인 방법을 제공하지 않는 Doxygen의 External Indexing and Searching 문서의 부족한 부분을 보완한다.
WAS별 설정 방법
- 아파치 HTTP 서버에서는 CGI 설정을 통해 Doxygen의 외부 검색 기능을 활성화한다.
- NGINX에서는 FcgiWrap을 사용하여 FastCGI를 설정하거나, 아파치 HTTP 서버에 리버스 프록시를 설정하여 CGI 기능을 활용한다.
Doxygen 설정 및 Xapian 연동
- Doxygen GUI 또는 Doxyfile 설정을 통해 검색 엔진 관련 옵션을 활성화하고, doxyindexer를 사용하여 검색 데이터베이스를 생성한다.
- Xapian 런타임 라이브러리 및 개발 라이브러리를 설치하여 검색 엔진이 정상적으로 동작하도록 한다.
- doxysearch.cgi 파일을 적절한 디렉터리에 복사하고, 웹 브라우저를 통해 CGI 동작을 확인한다.