[dW리뷰] Eclipse에서 DocBook XML 구현하기
원문기사 : http://www.ibm.com/developerworks/kr/library/os-eclipse-docbook/
DocBook은 구조화된 문서를 작성하기 위한 DTD 표준입니다. 이 표준을 따르는 XML 문서를 작성하면 DocBook-XSL의 도움을 받아 HTML, PDF 등 다양한 포맷의 문서를 만들 수 있습니다. 논문 작성 등에 많이 사용되는 TeX과 비슷한 목적이지만 표현력이 약간 떨어지는 대신 친숙한 XML을 사용하므로 익숙해지는 데 대한 부담이 덜합니다.
이클립스에서는 도움말에 HTML을 사용하지만 도움말을 작성할 때에는 DocBook을 활용하는 것이 보통입니다. 문서의 구조만 신경쓰면 되기 때문에 개발자가 문서 작성하면서 모양내느라 쩔쩔맬 필요도 없고, 이클립스 내에서 편집하기도 쉽기 때문입니다.
IBM developerWorks의 튜토리얼 Eclipse에서 DocBook XML 구현하기에서는 이클립스를 사용해서 DocBook XML을 편집하고 HTML로 컴파일하고 이클립스의 도움말 컨텐츠에 연동하는 방법까지 설명하고 있습니다. DocBook을 처음 사용하려면 이런저런 준비할 게 많아 쉽게 손이 가지 않는데, 튜토리얼에서 준비물까지 차근차근 설명하고 있어서 DocBook을 처음 접하는 이클립스 개발자라면 한번 따라해보기 좋을 듯 합니다.
튜토리얼은 WTP 개발자인 Nathan Good이 작성한 것이어서 그런지 XML 에디터도 WTP에 있는 것을 기준으로 설명하고 있습니다. 그러므로 튜토리얼을 따라하시려는 분은 필히 WTP를 설치하세요. 필요한 파일들을 한 프로젝트에 전부 쓸어 담으면서 설명하고 있어 이해하기는 쉽지만 향후 정말 제대로 사용하려면 모든 프로젝트에서 공용으로 사용할 수 있도록 외부 폴더에 두고 이클립스의 환경설정을 적절히 활용해야 겠습니다.
DocBook 관련 파일 재사용을 위한 환경설정
- Preferences > General > Ant > Runtime에서 xalan 추가
- Preferences > Web and XML > XML > XML Catalog에서 Docbook DTD 등록
- docbook xsl은 외부 또는 특정 프로젝트에 풀어두고 build.xml에서 적절한 PATH 지정
이 글은 스프링노트에서 작성되었습니다.
