Scroll PDF 는 Confluence 페이지를 PDF 로 변환할 수 있는 유용한 플러그인으로 REST API 를 지원하므로 커맨드를 사용하여 PDF 생성을 할 수 있습니다.


REST API URL 확인

  1. REST API 로 변환할 페이지가 있는 Space 에 들어갑니다. (스페이스 관리자 권한 필요)
  2. Space toolsAdd 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
CODE


인증이 필요한 경우 -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"
CODE

curl 옵션 의미는 curl 설치 및 사용법 - HTTP GET/POST, REST API 연계등 을 참고하세요.)


빌드시 confluence page 를 PDF 변환

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

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


같이 보기