Eclipse에서 Javadoc을 PDF로 만들기

atie의 이미지

Eclipse 에서 Javadoc을 PDF로 출력하기 위해 tex 파일을 만드는 절차입니다.

1. 사전에 필요한 것들

Quote:
a. Latex 패키지들이 설치되어 있어야 하고, pdf출력에 필요한 pdflatex는 /usr/bin/pdflatex에 설치되어 있는 것으로 합니다.

b. Latex Doclet을 다운받아 적당한 디렉토리 (예를 들어, ~/javaAPI/TexDoclet)에 jar 파일 압축을 풀어 놓습니다. com/c2_tech/doclets에 클래스들이 풀려 있어야 합니다.

c. latec 플러그인을 eclipse에 설치합니다. 링크된 주소에 있는 user guide(윈도우즈용)를 조금 응용해 보면, /usr/bin/pdflatex를 external tool로 eclipse에 등록을 할 수 있습니다. container_loc 같은 변수는 가이드에 있는대로 똑같이 해 놓습니다.
이 플러그인은 꼭 필요한 것은 아니고, 에디터가 딸려 있어서 eclipse 안에서 tex 파일을 보고 편집을 할 수 있습니다.


2. Javadoc을 PDF로 만들기

Quote:
a. eclipse에서 export -> Javadoc -> custom Doclet 사용을 체크하고, Doclet Name에 com.c2_tech.doclets.TexDoclet을, Doclet Path에 위의 TexDoclet을 풀어 놓았던 디렉토리를 지정합니다. 그런 후에 next 버튼, 그리고 ant 스크립트를 만드는 것에 체크합니다. (직접 export가 안되고 ant 스크립트를 실행을 해야 docs.tex가 생성이 되는데 이유는 아직 모르겠습니다.)

b. 위에서 Javadoc.xml이 생성이 되었으면, external tool -> Ant Build 해서 실행을 합니다. 성공적으로 수행이 되었으면 docs.tex가 생성이 됩니다.

c. docs.tex를 위의 1-c. 등록했던 pdflatex로 실행을 합니다. 성공적으로 수행이 되었으면, docs.pdf가 프로젝트 디렉토리에 생기게 됩니다.

저는 eclipse는 3.1M7을 사용을 하였지만 이전 버전에서도 문제없이 잘 되리라 보고, Javadoc이나 TexDoclet의 옵션은 직접 확인을 해 보세요. 출력된 pdf를 보고 있는데 아주 만족스럽습니다.

더 확인해 볼 것은,
1. 목차에 페이지 번호가 물음표가 뜨는 것,
2. Letter에 맞게 여백을 조정하는 것 (이건 제 환경에 맞추기 위해...)
3. 한글 출력이 되는지... 이 부분은 HLatex 소식에 제가 질문한 것이 해결이 되어야 아마 가능하지 않을까 합니다.
4. 검색을 하면 다른 프로젝트도 있는데 더 좋은 것이 있으면 알려 주시길 바랍니다.

File attachments: 
첨부파일 크기
Image icon eclipse-latex.png139.45 KB
Forums: 
iolo의 이미지

좋은 정보군요~..~

감사합니다.

----
the smile has left your eyes...

atie의 이미지

프린터 출력을 위해서는 kile에서 다시 한번 PDF를 만들어 주는 것이 좋군요. 목차에 ??로 찍히는 것도 제대로 페이지를 잡아 줍니다.
Letter 여백을 맞추기 위해
% \topmargin -.8in 로 되어 있는 것을
\topmargin -.5in 로 하니, 출력해 보면 보기가 좋습니다.

----
I paint objects as I think them, not as I see them.
atie's minipage

댓글 달기

Filtered HTML

  • 텍스트에 BBCode 태그를 사용할 수 있습니다. URL은 자동으로 링크 됩니다.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>
  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.

BBCode

  • 텍스트에 BBCode 태그를 사용할 수 있습니다. URL은 자동으로 링크 됩니다.
  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param>
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.

Textile

  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • You can use Textile markup to format text.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>

Markdown

  • 다음 태그를 이용하여 소스 코드 구문 강조를 할 수 있습니다: <code>, <blockcode>, <apache>, <applescript>, <autoconf>, <awk>, <bash>, <c>, <cpp>, <css>, <diff>, <drupal5>, <drupal6>, <gdb>, <html>, <html5>, <java>, <javascript>, <ldif>, <lua>, <make>, <mysql>, <perl>, <perl6>, <php>, <pgsql>, <proftpd>, <python>, <reg>, <spec>, <ruby>. 지원하는 태그 형식: <foo>, [foo].
  • Quick Tips:
    • Two or more spaces at a line's end = Line break
    • Double returns = Paragraph
    • *Single asterisks* or _single underscores_ = Emphasis
    • **Double** or __double__ = Strong
    • This is [a link](http://the.link.example.com "The optional title text")
    For complete details on the Markdown syntax, see the Markdown documentation and Markdown Extra documentation for tables, footnotes, and more.
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.
  • 사용할 수 있는 HTML 태그: <p><div><span><br><a><em><strong><del><ins><b><i><u><s><pre><code><cite><blockquote><ul><ol><li><dl><dt><dd><table><tr><td><th><thead><tbody><h1><h2><h3><h4><h5><h6><img><embed><object><param><hr>

Plain text

  • HTML 태그를 사용할 수 없습니다.
  • web 주소와/이메일 주소를 클릭할 수 있는 링크로 자동으로 바꿉니다.
  • 줄과 단락은 자동으로 분리됩니다.
댓글 첨부 파일
이 댓글에 이미지나 파일을 업로드 합니다.
파일 크기는 8 MB보다 작아야 합니다.
허용할 파일 형식: txt pdf doc xls gif jpg jpeg mp3 png rar zip.
CAPTCHA
이것은 자동으로 스팸을 올리는 것을 막기 위해서 제공됩니다.