natolambert/colloquium

해결하는 문제

Colloquium은 연구 발표용 슬라이드를 Markdown으로 작성할 수 있게 해서 연구 발표 제작을 간소화합니다. GUI 도구에서 수동으로 슬라이드를 디자인할 필요 없이 Git 친화적인 워크플로우를 제공하며, 발표용 단일 자가 포함 HTML 파일을 생성합니다.

작동 방식

사용자는 YAML 프론트마터 블록을 사용해 글로벌 설정(예: 폰트, 테마, 참고문헌)을 지정한 Markdown 파일에 콘텐츠를 작성합니다. 슬라이드는 --- 구분자로 나뉩니다. 이 도구는 KaTeX를 통한 수식 렌더링과 highlight.js를 통한 코드 강조를 지원하는 빌드 파이프라인을 사용해 Markdown을 형식화된 HTML 발표로 변환합니다. 또한 CLI를 통해 빌드, 라이브 리로드로 서빙, PDF 또는 PPTX로 내보내기 기능을 제공합니다.

대상 사용자

복잡한 수식, .bib 파일에서의 인용, 기술적 다이어그램을 포함해야 하는 연구자 및 학자로, 버전 관리 가능하고 프로그래밍 방식으로 고품질 발표를 만들고 싶어 하는 분들입니다.

주요 기능

• 연구 중심 기능: BibTeX 인용, 자동 참조 슬라이드, KaTeX 수식 지원 내장.
• AI 준비 출력: capture 명령어를 통해 슬라이드를 개별 PNG로 내보내며, AI 에이전트가 시각적으로 발표를 검토할 수 있도록 설계되었습니다.
• 특수 콘텐츠 블록: LLM 스타일 채팅 대화, Chart.js를 통한 데이터 차트, 콜아웃 박스를 YAML 기반으로 렌더링하는 사용자 정의 블록.
• 유연한 레이아웃: 임의의 숫자 비율로 가능한 다중 열 및 다중 행 그리드, 다양한 슬라이드 레이아웃(예: 섹션 분리, 이미지 왼쪽/오른쪽 배치) 지원.
• 개발자 친화적: Git 호환 소스 파일과 라이브 리로드 기능이 있는 개발 서버를 제공합니다.