Gramax: Git 통합 오픈소스 Docs-as-Code 플랫폼
GitHub 저장소와 GitBook 동기화 문제를 겪는 팀들은 Gramax를 강력한 오픈소스 대안으로 찾고 있습니다. 이 플랫폼은 문서를 Git Markdown 파일로 저장하여 클라우드 제약 없이 완전한 데이터 통제를 보장합니다. 민감한 데이터를 다루는 프로젝트에서는 이 점이 핵심입니다: 파일은 자체 인프라에 그대로 유지됩니다.
Gramax는 docs-as-code 접근 방식을 구현합니다—편집, 풀 리퀘스트를 통한 변경 승인, 게시가 Git 내에서 기본적으로 이루어집니다. 비주얼 에디터 지원은 Markdown을 기본 형식으로 유지하면서 Mermaid, PlantUML, Draw.io, OpenAPI와의 호환성을 추가합니다.
개발자를 위한 주요 기능
Gramax는 팀 협업을 위한 문서 작업을 위해 설계되었습니다:
- 네이티브 Git 통합: 앱 내에서 변경 사항을 만들고, PR을 거쳐 사이트에 자동으로 배포됩니다.
- AI 검색 및 코파일럿: 로컬 모델을 연결하여 소스 인용과 함께 의미론적 검색을 수행합니다.
- 비주얼 에디터: 다이어그램 및 스펙을 지원하는 Markdown 내보내기 기능이 있는 WYSIWYG 인터페이스.
- 공개 포털: 무료로 자체 호스팅 문서 사이트를 운영할 수 있습니다.
- 완전 무료: 프리미엄 모델이나 사용자 제한 없이 오픈소스입니다.
지원은 신속합니다: 문제를 논의할 수 있는 Telegram 개발자 채팅이 제공됩니다.
저장소 설정 단계별 안내
기존 Git 저장소를 연결하려면:
- app.gram.ax로 이동하여 "기존 디렉토리 업로드"를 선택합니다.
- 제공자(GitHub, GitLab 또는 자체 호스팅)를 지정합니다.
- 조직 또는 개인 계정에서 저장소를 선택합니다.
- 업로드 후 문서용 폴더(예:
/docs)를 생성합니다. - 카탈로그 설정에서 폴더 경로를 설정합니다.
- 비주얼 에디터를 통해 Markdown 파일을 추가합니다.
- 변경 사항을 게시합니다: git push용 클라우드 버튼, git pull용 화살표 버튼을 사용합니다.
변경 사항 되돌리기는 인터페이스를 통해 가능합니다: diff를 확인하고 롤백합니다. 동기화는 양방향입니다—코드 에디터에서의 편집이 Gramax에 반영되고, 그 반대도 마찬가지입니다. 로컬 작업을 위해 VS Code용 Markdown 확장 프로그램을 권장합니다.
Docs-as-Code 실제 적용
클라우드 서비스와 달리, Gramax는 잠금 위험을 제거합니다: 모든 데이터는 여러분의 Git에 있습니다. 기밀 데이터를 다루는 AI 프로젝트에서는 타협 없이 규정 준수를 보장합니다. 중견 이상의 개발자 팀은 벤더 종속성 없음과 쉬운 마이그레이션을 높이 평가할 것입니다.
AI 기능을 통해 지식 베이스 검색을 설정할 수 있습니다: 모델이 MD 파일에 대한 정확한 링크와 함께 답변을 생성합니다. Mermaid를 통한 시각화는 아키텍처 문서화를 단순화하고, OpenAPI 통합은 API 스펙을 처리합니다.
공개 사이트에 게시하기: 도메인을 구성하고, GitHub Actions를 통한 CI/CD로 Vercel 또는 Netlify에 자동 배포합니다.
핵심 요약
- Gramax는 완전히 오픈소스이며, 숨겨진 비용이나 제한이 없습니다.
- 문서는 Git Markdown에 저장되어 버전 관리와 감독을 보장합니다.
- 개인정보 보호를 위한 로컬 모델 기반 AI 검색 지원.
- 팀 개발을 위한 네이티브 PR 및 게시 기능.
- Telegram 개발자 채팅을 통한 빠른 지원.
— Editorial Team
아직 댓글이 없습니다.