Scroll PDF 는 Confluence 페이지를 PDF 로 변환할 수 있는 유용한 플러그인입니다.

ver 4.0 부터 템플릿 디자이너가 추가되었고 형식이 바뀌어서 기존 템플릿은 수동으로 재생성해야 합니다.


템플릿 관리

템플릿 생성

  1. Confluence 관리자로 로그인합니다.
  2. 관리자 메뉴중에 Scroll PDF Exporter→ Template 를 선택합니다.

  3. 기본 포함된 템플릿도 괜찮지만 한글 폰트가 설정되지 않아서 한글이 깨지는 문제가 있으므로 템플릿을 만들어 줘야 합니다.
    상단의 Add 를 누르면 새로운 템플릿을 만들수 있지만 기존 템플릿을 기반으로 하는게 편리하므로 우측의 ... 을 클릭후 Copy 를 선택합니다.

  4. 복사가 끝나면 Copy of Template 형식의 이름으로 템플릿이 새로 생성됩니다. 우측 메뉴를 클릭하고 Edit 를 선택합니다.

Setttings

  1. 템플릿의 이름을 설정하고 Description 을 적습니다.

  2. PDF 변환시 하위 페이지를  포함할지 여부를 Default Export scope 에 설정합니다. 이 값은 개별 export 마다 재설정 가능합니다.
  3. 좌측의 Properties 를 클릭하고 설정을 수정합니다. Label 의 Include 항목에 키워드를 적으면 해당 label 이 있는 페이지만 export 되며 exclude 에 적으면 해당 label 이 있는 페이지는 제외됩니다. export 시 다시 설정할 수 있으므로 꼭 설정할 필요는 없습니다.

  4. 설정을 마쳤으면 우측 상단의 Save 를 클릭해서 저장합니다.

Style

  1. Styles 를 클릭한 후에 하단의 Heading 에서 Heading 1 을 클릭합니다.
  2. 한글 폰트 설정을 위해 Font 버튼을 클릭한 후에 Manage custom fonts 를 클릭합니다.

  3. 폰트 업로드 화면에서 Updload 를 클릭하고 한글 폰트를 업로드합니다.

  4. Close 를 누른 다음에 Font 에 방금 업로드한 한글 폰트를 설정합니다.

  5. 기타 폰트 크기와 종류, 색등을 지정합니다.
  6. Page break before 는 heading 이 있을 경우 이후 컨텐츠를 다음 페이지로 넘길지 여부를 설정하며 Off 일 경우 넘기지 않고 To next page 일 경우 다음 페이지로 넘기게 됩니다.
  7. 다른 heading 도 폰트를 변경하고 Save 를 클릭합니다.


Tips

기본 템플릿 숨김

  1. 관리자로 로그인한 후에 Scroll RuntimeAdvanced Plugin Settings 를 클릭합니다.
  2. 우측의 List box 에서 Scroll PDF Exporter 를 선택후 Edit 를 클릭합니다.

  3. Value 를 Hidden 으로 변경합니다.


페이지 제목 덮어 쓰기

PDF export 시 confluence 의 Page 제목을 덮어 쓰려면 {Scroll PageTitle} 매크로를 사용하면 됩니다.


Page break 제거/추가

scroll pdf 는 heading 1 태그가 나타나면 새로운 페이지로 넘겨 버리며 이때문에 페이지 수가 너무 많아질 수 있습니다.

이를 방지하려면 Styles → Heading 1 → Section → Page break before 항목을  Off 로 설정합니다.


반대로 특정 Heading 이 나오면 페이지를 넘겨야 할 경우 해당 heading 설정(예: Heading 3)을 클릭하고 Page break beforeTo next page 로 설정하면 됩니다.


개별 페이지에 강제로 페이지 넘김을 설정할 경우 {scroll-pagebreak} 매크로를 사용하면 됩니다.


TOC level 조정

어느 헤딩까지 table of content 에 포함시킬 지 설정하려면 Document Section → TOC 에서 max levels 를 설정해 줍니다.


같이 보기