Child pages
  • Confluence 로 책 저술하기 #2

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Confluence 로 책 저술 하기 #1 에서는 저술 프로세스와 제가 아는 약간의 테크닉에 대해서 간략하게 설명하고 왜 confluence 를 선택했는지 설명했습니다.


저술 준비

Space 만들기 

제일 먼저 먼저 할 일은 Confluence 에 저술용 공간을 만드는 것입니다. 기존 공간이 있어도 별도로 분리하는 것이 저술 작업과 페이지 관리가 용이하고 나중에 MS WORD 로 변환시에도 편리하므로 별도의 공간을 생성하고 작업하는 것을 권장합니다.

...

저술 과정을 공개할지 여부는 저자의 성향에 따라 다르겠지만 저는 공개하고 사용자의 피드백을 받는 건 저술의 품질(오타, 어색한 문장, 실행되지 않는 코드코드등)을 높이고 독자의 필요에 맞는 책을 쓸 수 있는 장점이 있다고 생각합니다.

...

Confluence 에 계정이 없는 일반 사용자도 볼 수 있어야 하므로 해당 저술 공간은 누구나 읽을수 있도록 권한을 설정해야 합니다.

권한 설정은 관리자 콘솔에서 General Permission 에 하면 됩니다.

...


confluence 는 기본 댓글 기능을 제공하지만 인증 기능이  없고 익명 사용자가 댓글을 남길 수 있게 할 경우 캡챠 기능이 약하므로 스팸이 많아지는 문제가 있습니다.

저는 소셜 댓글 플랫폼인 disqus 를 사용해서 이런 문제를 처리했으며 처리했으며 설정 방법은 Confluence 와 디스커스(DISQUS) 연동 을 참고하세요.

...

저술 진행시 제목만 써 놓거나 참고 자료만 달랑 있는 페이지도 있는등 내용이 부실한 페이지를 만들게 될 수 있습니다.

공개할 경우 이런 페이지가 보인다면 페이지는 사용자가 보기에 무성의해 보일 수 있으므로 미완인 페이지는 페이지 접근 제한을 사용해서 사용자가 볼 수 없게 잠가 놓고 저술하는 게 좋습니다.

...

예로 개발 환경 만들기"의 하단의 "vagrant 란" 은 최상위 부모인 "개발 환경 만들기" 보다 2단계가 깊으므로 "2.2.1 vagrant" 라는 목차가 됩니다.

페이지에 숫자  안 붙이기

주위의 confluence 사용자중에 페이지 정렬때문에 페이지 제목에 의 페이지 기본 정렬 방식은 제목순이며 이때문에 페이지 정렬을 위해 제목마다 1.1, 1.2 등 숫자를 붙이는 경우가 있습니다.

정렬 용도로 제목에 숫자를 붙이면 중간에 페이지가 추가될 경우 이후 페이지에 붙인 숫자를 다 변경해야 하는 문제가 있으므로 사용하지 않는게 좋습니다.

...

특히 MS Word 로 변환시 자동으로 목차를 생성하고 숫자를 붙여주므로 숫자가 중복되는 문제가 있으니 페이지 정렬이나 이동이 필요할 경우 아래에서 설명하는 기능을 사용하면 됩니다.


페이지 이동을 사용해 목차 변경

Confluence 는 페이지의 이동과 순서 조정이 용이하므로 이 기능을 사용하면 챕터 순서를 자유롭게 조정할 수 있습니다.

...

어느 방법을 썼든 참고 자료는 원고에서 빠져야 하며 이런 페이지가 있을 경우 사전에 exclude 등 label 을 정한후에 페이지에 label 을 지정하면 나중에 초고본 원고 변환시 유용하게 사용할 수 있으며 자세한 내용은 하단의 "WORD 로 변환에서 변환" 항목에서 설명합니다.

scroll ignore 매크로

한 페이지에 참고 자료를 달았다면 export 시에 페이지내 해당 부분은 출판용 초고에서 제외해야 합니다.

...

그림이나 표의 경우 {scroll title} 매크로내에 위치시키면 캡션을 달수 있으며 이는 WORD 로 export 시 반영됩니다.

Warning

scroll office 버그로 캡션에 "표 1, 그림 1 처럼 번역된 용어로 만들어 지지 않고 " 로 캡션이 생성되지 않고 "table 1, figure 1 으로 남으므로 " 로 만들어 지므로 초고가 완성되면 수작업으로 캡션 명을 일일이 수정해야 하므로 캡션 수정은 합니다.

그러므로 캡션의 한글 용어 변경은 초고 완성후에 작업하는 게 좋습니다.


페이지 제목을 덮어쓰는 scroll page title

...

scroll page title 매크로는 PDF 나 MS WORD 로 변경시 실제 페이지의 제목이 아닌 매크로에 설정한 이름으로 제목을 변경해 주는 기능을 제공하므로 저술할 때 동일 제목 페이지 문제를 해결할 수 있습니다.

...

WORD로 변환

템플릿 선택

scroll office 는 템플릿 기능을 제공하므로 용도에 맞게 템플릿을 만들어서 활용할 수 있습니다. 

...

Note

고객사에 제출할 문서를 Confluence 로 작성하려면 고객이 최종 산출물로 . HWP 가 아닌 MS-Word 나 PDF 형식의 문서로 제출해도 되는지 여부를 고객에게 꼭 확인해야 합니다.



참고 자료

...