오픈소스 도구로 자율적 지식 생산: 번역·집필·연구 협업 워크플로우

3~5인이 매판독점 플랫폼(구글·MS·네이버·카카오)에서 벗어나 Forgejo(Git)+Zotero(참고문헌)+Markdown+Pandoc(작성·변환)+Hugo(출판)+AI 기반 번역(DeepSeek API, Ollama+vLLM)로 자율적 지식 생산 파이프라인을 구축하는 3단계 실천 가이드. 평문 우선 원칙, 도구별 설치법, 공동 번역 워크플로우, 전체 통합 예시, 운영 원칙, 반독점·반제국주의·노동자 자치로의 정치적 연결 포함. 디지털 자치 인프라 가이드(#1)의 상위 레이어.

왜 이 가이드가 필요한가

한국에서 진지한 연구·번역·집필을 하려면 대개 이런 도구에 의존한다: 구글 독스(문서), GitHub(코드·협업), 구글 번역·파파고·DeepL 같은 구형 번역 플랫폼, EndNote·RefWorks(참고문헌), 미디엄·브런치(출판). 이들은 모두 미국·한국 빅테크의 사유 플랫폼이다.

문제는 비용만이 아니다. Elsevier·Springer 같은 학술 출판 제국은 논문 한 편에 40달러를 받고, 그 논문을 쓴 연구자는 한 푼도 받지 못한다. Google Docs는 언제든 계정 정지·내용 검열·API 폐기가 가능하다. 미디엄은 당신이 쓴 글을 페이월 뒤에 가둔다. 지식을 생산하는 사람이 지식의 유통을 통제하지 못하는 구조다.

이 가이드는 디지털 자치 인프라 가이드(#1) 위에서 작동하는 자율적 지식 생산 도구 체인을 제시한다. 통신·파일 공유 인프라(#1)가 갖춰졌다면, 이제 그 위에서 무엇을 생산할 것인가의 문제다. 번역가·연구자·작가·교육자·활동가 3~5인이 함께 연구하고, 쓰고, 번역하고, 출판하는 전체 워크플로우를 오픈소스 도구만으로 구축한다.

핵심 원칙: 평문(plain text) 우선. 모든 산출물은 마크다운(.md) 평문으로 저장된다. 평문은 어떤 기기에서도 열리고, Git으로 변경 이력을 추적할 수 있고, 플랫폼 하나가 망해도 데이터는 살아있다. 이 원칙만 지키면 도구는 언제든 바꿀 수 있다.

도구 체인 개요

도구역할비용플랫폼 의존 대체
Forgejo자체 호스팅 Git 서버 — 모든 문서·번역·코드 버전 관리VPS에 추가 0원GitHub, GitLab
Zotero참고문헌 관리, 공동 서지 구축, 인용 생성무료 (그룹 100MB)EndNote, RefWorks, Mendeley
Markdown + Pandoc평문 작성 → HTML/PDF/ePub/LaTeX 변환무료Word, Google Docs, Pages
Hugo마크다운 → 정적 웹사이트·블로그·연구 출판물무료 (Netlify 호스팅)Medium, Brunch, WordPress.com
AI 기반 번역DeepSeek V4 Flash API 상시 번역, Ollama+vLLM 자체 호스팅API 사용량 기반 / 자체 호스팅은 GPU·VPS 비용DeepL, Google Translate, Papago

1단계: 오늘 당장 시작 (무료, 1시간)

Zotero — 참고문헌, 연구 노트, 공동 서지

연구·번역·집필의 출발점은 무엇을 읽었는가를 체계적으로 관리하는 것이다. Zotero는 이 작업을 위한 오픈소스 표준 도구다.

설치와 기본 사용

  1. zotero.org에서 Zotero + 브라우저 커넥터 설치 (Windows/Mac/Linux).
  2. 계정 생성 (이메일만 필요, 무료).
  3. 브라우저에서 논문·뉴스·보고서 페이지 접속 → Zotero 커넥터 아이콘 클릭 → 자동 저장.
  4. PDF 첨부파일 자동 다운로드 설정 가능.

그룹 라이브러리 설정 (공동 연구의 핵심)

  1. zotero.org → Groups → Create Group.
  2. 그룹원 초대 (이메일). 인원 제한 없음, 무료.
  3. 도서·논문·보고서·기사·통계자료를 그룹 라이브러리에 추가 → 모든 구성원이 실시간 공유.
  4. 컬렉션(폴더)으로 주제별 분류: "제국주의", "한국 노동운동", "반공 이데올로기", "생태·에너지" 등.

인용 워크플로우

Zotero + Better BibTeX 플러그인 → citation key 자동 생성 (예: lenin_imperialism_1917). 마크다운에서 [@lenin_imperialism_1917]로 인용 → Pandoc이 자동으로 참고문헌 목록 생성. CSL(Citation Style Language) 파일로 어떤 양식(APA, Chicago, 한국 학술지 양식)이든 지원.

실천: 오늘 바로 Zotero 설치하고, 지금까지 읽은 주요 자료 10개를 저장하라. 그룹 라이브러리를 만들고 동료 2인을 초대하라. 공동 서지 구축이 공동 연구의 첫 걸음이다.

Markdown — 평문 작성의 시작

마크다운은 2004년 John Gruber가 만든 경량 마크업 언어다. 배우는 데 30분이면 충분하다. 이 가이드(#2)와 #1 가이드, 사이버레닌의 모든 연구 보고서가 마크다운으로 작성되었다.

30분 만에 배우는 마크다운

# 제목 (H1)
## 소제목 (H2)
### 소소제목 (H3)

**굵은 글씨**, *기울임*

- 순서 없는 목록
- 항목 2

1. 순서 있는 목록
2. 항목 2

[링크 텍스트](URL)
![이미지 설명](이미지URL)

> 인용문 — 레닌이 말했다

| 표 | 제목 |
|----|------|
| 셀 | 셀  |

각주는 [^1] 이렇게.

[^1]: 각주 내용.

부족한 것은 HTML로 직접 보완 가능. 마크다운은 HTML의 상위집합이다.

에디터 선택

  • 초보자: Obsidian, Typora, MarkText — 실시간 미리보기, 무료.
  • 중급자: VS Code + Markdown All in One 확장 — Git 연동, 다중 파일 관리.
  • 터미널파: Vim/Neovim + 마크다운 플러그인.

실천: 오늘 작성하는 모든 새 문서를 .md 파일로 시작하라. 동료와 공유할 때도 .md 파일 그대로 Matrix 또는 CryptPad로 전송하라.

2단계: 이번 주 안에 구축 (월 0원 추가, 2~4시간)

Forgejo — 당신의 Git, 당신의 통제

코드만 Git으로 관리하는 것이 아니다. 번역 원고, 연구 노트, 정책 제안서, 교육 자료까지 모든 텍스트 자산을 Git으로 버전 관리할 수 있다. Forgejo는 GitHub 없이 Git 협업을 가능하게 하는 경량 자체 호스팅 서버다.

설치 (Docker Compose, #1 가이드의 VPS에 추가)

# docker-compose.yml
version: '3'
services:
  forgejo:
    image: codeberg.org/forgejo/forgejo:1.21
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./forgejo-data:/var/lib/gitea
    environment:
      - GITEA__server__DOMAIN=your-vps-ip
      - GITEA__server__ROOT_URL=http://your-vps-ip:3000
      - GITEA__database__DB_TYPE=sqlite3

실행: docker compose up -d. 브라우저에서 http://VPS-IP:3000 접속 → 초기 설정 완료. RAM 사용량 약 150MB, VPS에 충분히 여유 있다.

협업 워크플로우

  1. 연구 그룹 저장소 (예: research/joseon-imperialism) → Zotero 서지 데이터(.bib)도 함께 관리.
  2. 번역 프로젝트 저장소 (예: translation/korean/deleuze-anti-oedipus) → 원문, 번역 초안, 교정본을 브랜치로 관리.
  3. 이슈 트래커로 작업 분배: "2장 1차 번역 완료, 3장 리뷰어 배정 필요".
  4. Pull Request → 동료 리뷰 → 병합. GitHub과 완전히 동일한 Git 워크플로우를 자체 서버에서.

Forgejo는 2022년 Gitea의 커뮤니티 포크로 시작되어, 2025년 기준 Gitea보다 더 활발한 개발 활동을 보이고 있다. Codeberg.org가 Forgejo를 기반으로 15만 명 이상의 사용자에게 무료 Git 호스팅을 제공 중이다.

Pandoc — 마크다운에서 세상 모든 형식으로

Pandoc은 문서 변환의 스위스 군용 칼이다. 마크다운으로 작성한 원고 하나로 HTML, PDF, ePub, LaTeX, DOCX, 슬라이드까지 모두 생성할 수 있다.

설치와 기본 명령

# Ubuntu/Debian
sudo apt install pandoc texlive-xetex

# macOS
brew install pandoc basictex

# 기본 변환 예시
pandoc manuscript.md -o manuscript.html
pandoc manuscript.md --pdf-engine=xelatex -o manuscript.pdf
pandoc manuscript.md -o manuscript.epub
pandoc manuscript.md --citeproc --bibliography=refs.bib -o paper.pdf

--citeproc 옵션은 Zotero의 .bib 파일과 연동하여 인용을 자동 생성한다. CSL 파일만 바꾸면 APA, Chicago, 한국 학술지 양식이 즉시 전환된다.

실천: 이번 주 안에 Forgejo를 VPS에 설치하고, 기존에 Google Docs나 Notion에 흩어져 있던 문서들을 .md 파일로 변환하여 Git 저장소에 올려라. Pandoc으로 변환 테스트를 해보라.

3단계: 다음 달, 선택적 고도화 (월 0~1만원 추가)

Hugo — 당신의 출판 플랫폼

Medium이나 브런치에 글을 올리면, 당신의 독자는 플랫폼의 소유물이 된다. Hugo는 마크다운 파일로 정적 웹사이트를 생성하는 오픈소스 도구다. Netlify나 Cloudflare Pages에 무료로 호스팅할 수 있다.

워크플로우

  1. hugo new site research-group-name — 새 사이트 생성.
  2. hugo new posts/2025-05-imperialism-chain.md — 마크다운으로 글 작성.
  3. hugo server — 로컬에서 미리보기.
  4. Git push → Netlify가 자동으로 빌드·배포.
  5. Forgejo Actions로도 CI/CD 구축 가능 (추가 설정 필요).

사이버레닌 사이트 자체가 Hugo로 빌드되어 Netlify에 호스팅된다. 연구 그룹, 노동조합 교육 자료실, 번역 출판 프로젝트 모두 Hugo로 충분하다.

AI 기반 번역 — DeepSeek V4 Flash API와 Ollama+vLLM 자체 호스팅

AI 번역은 이제 피할 수 없는 현실이다. 문제는 누구의 AI를 쓰느냐다. 구글·네이버·카카오의 번역 API는 당신의 텍스트를 수집하고 학습 데이터로 사용한다.

DeepSeek V4 Flash API (실용적 접근)

  • 중국 DeepSeek의 API는 OpenAI API와 호환되며, 가격은 GPT-4o의 약 1/10 수준.
  • Python으로 간단한 번역 스크립트 작성: openai 라이브러리, base_url="https://api.deepseek.com".
  • 마크다운 파일을 청크 단위로 분할 → API 호출 → 번역 결과 병합.
  • 비용: 중편 논문(약 1만 단어) 번역 시 약 $0.15~0.30.

Ollama + vLLM 자체 호스팅 (완전 자주적 접근)

  • GPU가 있는 별도 서버(VPS 또는 로컬)에서 Ollama나 vLLM으로 오픈소스 LLM(Llama 3, Qwen 2.5 등)을 자체 호스팅.
  • 모든 텍스트가 외부로 유출되지 않음 — 국가보안법 위험군 번역에 필수.
  • Oracle Cloud 무료 ARM 인스턴스(4코어 24GB RAM)에서도 작은 모델은 구동 가능.
  • 단점: 초기 설정 난이도 높음, GPU 비용(월 $50~200), 번역 품질은 DeepSeek API 대비 낮을 수 있음.

정치적 판단: DeepSeek API는 중국 기업의 서비스로, 미국 빅테크 대비 상대적으로 제국주의적 감시 위험이 낮다. 그러나 완전한 자주성을 원한다면 Ollama+vLLM 자체 호스팅이 궁극적 목표다. 현실적으로는 DeepSeek API로 시작하고, 예산과 기술이 확보되면 자체 호스팅으로 전환하는 경로를 권장한다.

통합 워크플로우 예시: 공동 번역 프로젝트

  1. Zotero: 원문 PDF 저장, 관련 참고문헌 그룹 라이브러리에 수집. 서지 정보 정리.
  2. Forgejo: 원문 텍스트(.md)를 저장소에 커밋. 번역 작업 이슈 생성 ("1장 담당: A", "2장 담당: B").
  3. DeepSeek API: 1차 기계 번역 초안 생성 → Forgejo에 커밋.
  4. Markdown: 번역자가 초안을 수정·교열·주석 추가. Git diff로 변경 이력 추적.
  5. Forgejo Pull Request: 동료 번역자가 리뷰 → 토론 → 병합.
  6. Pandoc: 최종본을 HTML·PDF·ePub으로 변환.
  7. Hugo: 출판물을 웹사이트에 게시.
  8. Zotero: 완성된 번역본도 참고문헌으로 등록 → 다음 프로젝트의 기초 자료.

운영 원칙

  1. 모든 것은 평문으로: .md 파일은 2050년에도 열 수 있다. 독점 포맷(.docx, .hwp, .pages)에 당신의 노동을 가두지 마라.
  2. Git은 문서의 노동조합이다: 모든 변경은 추적 가능하고, 누가 무엇을 했는지 기록된다. 지식 노동의 투명한 협업을 위한 기초다.
  3. 자체 호스팅은 자주권의 물질적 기초다: GitHub Pages가 아니라 당신의 VPS에서 서비스가 돌아간다. 플랫폼의 약관 변경, 계정 정지, 서비스 종료에 당신의 지식 생산 수단이 휘둘리지 않는다.
  4. API 의존도를 점진적으로 낮춰라: 처음에는 DeepSeek API를 써도 된다. 그러나 1년 안에 자체 호스팅 번역 인프라로 전환하는 로드맵을 가져라.
  5. 공동 소유, 공동 관리: VPS 비용을 분담하고, 서버 관리는 돌아가며 맡는다. 기술 지식도 공동 자산이다 — 한 사람이 독점하지 않도록 문서화하라.

정치적 연결: 이 지식 생산 도구가 반독점·반제국주의·노동자 자치로 이어지는 이유

반독점 (Anti-Monopoly)

Google Docs, GitHub, DeepL, Medium — 이 모든 도구는 미국 빅테크 독점의 산물이다. 지식 생산자가 자신의 도구를 통제하지 못하면, 생산된 지식의 방향도 통제하지 못한다. Forgejo+Zotero+Markdown+Hugo는 이 독점적 지식 인프라에서 벗어나는 구체적 실천이다.

반제국주의 (Anti-Imperialism)

학술 출판 제국(Elsevier, Springer, Taylor & Francis)은 전 세계 연구자들의 무료 노동(논문 작성, 동료 심사)을 착취하여 연 30% 이상의 이윤을 올린다. 이 가이드가 제안하는 오픈소스 도구 체인은 이 착취 구조에서 벗어나 자율적 지식 유통 경로를 만드는 것이다. Zotero의 그룹 라이브러리는 학술 출판 제국에 대항하는 공동 서지 인프라의 씨앗이다.

노동자 자치 (Workers' Autonomy)

지식 노동자가 자신의 생산 수단(도구, 서버, 출판 플랫폼)을 소유하고 통제하는 것은, 공장 노동자가 기계를 소유하는 것과 동일한 원리다. 3~5인이 월 7천원씩 분담하여 자체 Git 서버와 지식 생산 파이프라인을 운영할 수 있다는 사실은, 생산 수단의 집단적 소유가 거대한 자본 없이도 가능함을 증명한다. 이 경험이 축적되면 더 큰 규모의 노동자 자치 조직화로 이어질 수 있다.

다음 단계

  • #1 가이드: 디지털 자치 인프라 구축 — 이 도구들이 돌아갈 인프라(Matrix, Nextcloud, CryptPad, VPN).
  • #3 가이드: 안전한 디지털 조직화 — 이 도구들을 조직화된 실천으로 묶는 보안·운영·의사결정 지침.
  • 실천 과제: (1) 오늘 Zotero 설치, (2) 이번 주 Forgejo 구축, (3) 다음 달 Hugo+AI 번역 파이프라인 완성.