협업 위키 기반 연구 플랫폼

초록

WorkingWiki는 MediaWiki에 추가되는 확장 모듈로, 텍스트 기반 소스 코드를 UNIX 명령어와 makefile을 이용해 자동 변환·컴파일·출력함으로써 논문·소프트웨어 공동 작업을 위한 통합 개발·버전 관리·출판 환경을 제공한다. LaTeX, R, Python, C 등 다양한 언어를 지원하며, 마크업·코드·결과물을 동일 위키 페이지에 보관해 실시간 협업과 재현성을 높인다.

상세 분석

본 논문은 WorkingWiki가 기존 위키의 단순 문서 편집 기능을 넘어, 실제 프로그래밍·데이터 분석·논문 작성까지 포괄하는 연구 협업 플랫폼으로 진화시킨 구조적·기술적 메커니즘을 상세히 제시한다. 핵심은 위키 페이지에 삽입된 “소스 블록”을 파일 시스템에 매핑하고, 사용자가 정의한 makefile 규칙에 따라 자동으로 컴파일·실행·PDF 생성 등을 수행하도록 하는 것이다. 이를 위해 WorkingWiki는 MediaWiki의 파서와 확장 API를 활용해 페이지 저장 시 자동으로 해당 블록을 추출·파일화하고, 백그라운드 작업 큐에 잡을 등록한다. UNIX 쉘 명령어와 GNU make를 기반으로 하기 때문에, 거의 모든 프로그래밍 언어와 빌드 시스템을 그대로 이용할 수 있다. 특히 LaTeX 전용 템플릿과 자동 bibtex 관리 기능은 학술 논문 공동 저술에 최적화돼, 저자들이 실시간으로 문서 레이아웃·참고문헌·그림을 확인하고 수정할 수 있게 한다.

버전 관리 측면에서는 위키 자체의 편집 이력과 make 기반의 재현 가능성을 결합한다. 페이지마다 별도 히스토리를 제공하므로, 코드·데이터·텍스트가 언제, 누가, 어떤 이유로 변경됐는지 추적이 가능하다. 또한, makefile에 정의된 “clean”·“rebuild” 명령을 통해 이전 빌드 결과를 손쉽게 정리하고 재생성할 수 있어, 실험 재현성을 크게 향상시킨다.

시스템 설계는 모듈화된 플러그인 구조를 채택해, 핵심 파일 매핑·빌드 엔진·위키 UI를 독립적으로 교체·확장할 수 있다. 예를 들어, 특정 언어 전용 IDE와 연동하거나, 외부 CI/CD 파이프라인과 연결하는 것이 가능하다. 이러한 설계는 연구 그룹의 특수 요구에 맞춰 맞춤형 워크플로를 구현하도록 지원한다.

운영상의 고려사항으로는 서버 자원 관리와 보안이 있다. 작업 큐는 제한된 프로세스 풀을 사용해 과부하를 방지하고, 파일 시스템 접근 권한을 위키 사용자 권한과 연동해 무단 실행을 차단한다. 또한, 실행 환경을 컨테이너화하거나 가상 환경을 지정함으로써 의존성 충돌을 최소화한다.

결과적으로 WorkingWiki는 위키 기반 협업의 접근성·투명성을 유지하면서, 실제 연구에 필요한 코드·데이터·문서의 통합 관리·자동화·재현성을 제공하는 혁신적 도구로 평가된다.