TL;DR
아래 명령으로 quip에서 추출할 수 있습니다.
npx quip-export -t "API 키" --docx -d 출력디렉토리추출한 결과는 confluence에 수동으로 import시키거나, https://github.com/Sazar24/confluence-docs-importer 등을 사용합니다.
quip이란
Quip은 협업용 워드 프로세싱 및 스프레드시트 응용 프로그램을 제공하는 생산성 소프트웨어 회사입니다. Quip 플랫폼은 사용자들이 실시간으로 문서, 스프레드시트, 태스크 리스트를 생성하고 편집할 수 있도록 합니다. 또한 메시지 기능이 있어 플랫폼 내에서 파일을 공유하고 소통할 수 있습니다. 또한 iOS와 Android를 위한 모바일 앱이 있어 언제 어디서든 문서를 열람하고 협업할 수 있습니다. Quip는 기업용으로 설계되었으며, 어떠한 크기의 팀들도 생산성과 협업을 향상시킬 수 있습니다.
ChatGPT한테 물어봤는데 훌륭한 설명입니다. 다만, 큅은 회사가 아니라 소프트에어이고, 회사는 세일즈포스(Salesforce)입니다. ChatGPT가 아직은 정확하지 않네요.
왜 confluence로 옮겨야 하는가
물론 꼭 옮겨야만 하는 것은 아닙니다. 다만, 회사에서 쓰려면 quip은 유료이기 때문에 예산을 확보하지 못하면 옮겨야 합니다. confluence 역시 유료이지만 수많은 회사에서 구매하여 사용하고 있습니다. quip을 쓰던 스타트업이 대기업에 인수되었다면 일어날 법한 상황입니다.
quip-export
큅은 인기 있는 도구라서 다양한 추출 도구가 있습니다. 그 중에서 무료로 사용할 수 있는 quip-export를 소개합니다.
준비
quip-export는 자바스크립트로 작성되었습니다. 실행하려면 Node.js 버전이 10.16 이상이어야 합니다. 아래 명령으로 버전을 확인하고 적절한 버전을 준비해주세요.
node -v무설치 실행
npx 활용
파이썬에 pipx가 있듯 Node.js에는 npx가 있습니다. 패키지를 임시로 받아서 설치 및 실행하고 곧바로 삭제합니다.
npx quip-export [options]github 소스코드로 실행
소스코드를 직접 수정하면서 실행하려면 아래와 같이 할 수도 있습니다.
git clone https://github.com/sonnenkern/quip-export.git
cd quip-export
node quip-export [options]설치 실행
보통 추출 작업은 한번에 끝나지 않기 때문에 설치하는 쪽이 편합니다.
npm install -g quip-export실행하면 사용법을 볼 수 있습니다.
quip-export옵션
10여가지가 있지만 주요 옵션만 설명합니다
-t, --token "string" Quip Access Token.
-d, --destination "string" Destination folder for export files
--docx Exports documents in MS-Office format (*.docx , *.xlsx)
--folders "string" Comma-separated folder's IDs to export토큰 받기
https://quip.com/dev/token 접속하면 토큰을 받을 수 있습니다. 물론 계정이 있어야 합니다.
받은 토큰을 -t 옵션 뒤에 적어줍니다
d 옵션
추출 결과를 저장할 위치를 지정합니다. 뒤에 나오는 folders 옵션에 따라서 위치를 바꾸어 줄 필요가 있습니다
docx 옵션
이 옵션이 없으면 html이 기본입니다. 첨부파일을 고려하면 html로 백업하는 것이 좋습니다만, 컨플루언스측에서는 html 업로드를 API로만 제공하는 경우가 많고, word 업로드는 기본으로 제공하므로 편한 방법을 선택하십시오
folders 옵션
이 옵션이 없으면 전체 문서를 추출합니다. 문서가 수백개를 넘는 경우 API 호출 횟수 제한이 걸려서 프로그램이 멈출 수 있으므로 이 옵션을 활용하십시오. (API 호출 횟수는 1분당 50회, 1시간당 750회로 제한됩니다.)
여기서 폴더명을 적는 것이 아니고, 폴더의 ID를 적는다는 점을 주의하십시오. 폴더의 ID는 폴더의 링크를 보면 알 수 있습니다. 예를 들어 제 큅에는 "비공개"라는 제목의 폴더가 있는데 아래와 같이 링크 복사로 링크를 얻을 수 있습니다.
Confluence에서 word 파일 올리기
- 아래 스크린샷 오른쪽 아래에 보이는 Word 문서 가져오기 버튼을 누릅니다
