C++ API 레퍼런스
이제 C++ API 전체 Doxygen 사이트가 Read the Docs 내부에서 직접 빌드되어 다른 문서와 동일한 브랜치·태그 버전 관리 흐름을 그대로 따릅니다. RTD 빌드가 실행될 때마다 체크아웃된 소스 트리에 대해 Doxygen을 돌리고, 생성된 HTML 번들을 나머지 페이지와 함께 배포합니다.
동작 방식
conf.py가 별도의 Doxyfile을 생성하고builder-inited단계에서 Doxygen을 실행합니다.생성된 HTML 번들은
_generated/cpp-api/``(git에서 무시됨)에 임시 저장한 다음 ``cpp-api/로 복사되어 현재 버전에 맞춰 RTD가 서비스합니다.이 페이지는 즉시
../cpp-api/index.html로 리디렉션하여 Doxygen이 렌더링한 레퍼런스를 별도 문서 섹션으로 열어 줍니다.
직접 보기
Loading the generated C++ API reference…
로컬 빌드
로컬에서 미리 보려면 pixi run config 로 도구체인이 설치되어 있는지 확인한 뒤 다음 명령을 실행하세요:
pixi run docs-build
위 명령은 docs/readthedocs/ 디렉터리에서 sphinx-build 를 실행해 Read the Docs와 동일한 방식으로 동작하며, 결과 Doxygen 사이트를 docs/readthedocs/_generated/cpp-api 에 생성합니다.