REST API 를 사용하여 Confluence Page 를 PDF로 변환하기

REST API URL 확인

1. REST API 로 변환할 페이지가 있는 Space 에 들어갑니다. (스페이스 관리자 권한 필요)
2. Space tools → Add on → Scroll PDF Exporter  로 들어가서 pdf 변환시 사용할 템플릿을 확인합니다.
   
   
3. 우측 끝의 ... 을 클릭한 후에 Template Information 을 선택합니다.
   
   
4. REST URL 을 복사하고 맨 뒤에 pageId=PAGE-ID 를 확인합니다.
   
5.  export 할 페이지의 ID 를 알아낸 후에 위에서 확인한 REST-URL 의 PAGE-ID 대신 이 값을 설정합니다. 즉 실제 페이지의 ID 가 1234567890인 경우 pageId=1234567890 이 됩니다.
   
   

curl 로 PDF 변환

커맨드용 http 요청 프로그램인 curl 을 아래 옵션으로 사용하여 PDF 변환을 할 수 있습니다. 

curl -k -L -o 저장파일명.pdf REST-URL

인증이 필요한 경우 -u 뒤에는 confluence 사용자 id와 암호를 설정하며 REST-URL 에는 위에서 복사한 전체 URL(page-id 를 포함)를 넣어 줍니다.

예로 id 가 wikiuser 이고 암호가 passwd 인 경우 아래 명령으로 confluence page 를 PDF 로 변환할 수 있습니다.

curl -k -L -o -u wikiuser:password -o confluence-page.pdf "https://mywiki.com/plugins/servlet/scroll-pdf/api/public/1/export-sync?templateId=02647913-a6da-4815-9b59-f1d443d4cbc4&pageId=123456789"

빌드시 confluence page 를 PDF 변환

빌드시 자동으로 Confluence 의 Page 를 PDF 로 변환해서 패키징에 포함시키는 것도 가능합니다.

maven 의 경우 maven exec plugin 을 사용하여 curl 을 실행하면 되며 아래의 설정을 pom.xml 에 추가하면 됩니다.

같이 보기

• curl 설치 및 사용법 - HTTP GET/POST, REST API 연계등
• maven exec plugin 을 사용하여 빌드시 외부 프로그램 실행하기