Latexを使って、作成したドキュメントをpdfで出力する方法
rst2pdf拡張を使ったPDF出力(Sphinxについてのメモ その2(rst2pdf拡張を使ったPDF出力))をやったので、LatexでもPDF出力してみました。
Latexを介して出力したものは、rst2pdfを使って出力したものに比べて相当綺麗だと感じました。rst2pdfに比べてLatexの方はデザインを細かくいじれるようなので、PDFにするならLatex経由の方がいいなと思いました。
環境
OS:Mac OS X 10.9.5
Python:Ver.2.7.7
Latexのインストール
- TeX Liveインストールを使ってインストール
$ sudo port selfup
$ sudo port install texlive +full
※「Sphinx-Users.jp」のOSXへのTeX Liveインストール (MacTex / MacPorts)には「ビルドに1時間近くかかります。」と書いてありましたが、私の環境では2時間待っても終わりませんでしたので気長に待ちました。(夜中に付けたまま寝て朝には終わってました。)
・・・・
---> Installing texlive @2014_0+doc+full
---> Activating texlive @2014_0+doc+full
The "full" installation of TeX Live was selected. This is a full installation of all TeX Live packages, including all languages and their
associated documentation.
---> Cleaning texlive
---> Updating database of binaries
---> Scanning binaries for linking errors
---> No broken files found.
$
終わった時は、こんな感じのログが出ていました。
プロジェクトの設定変更
conf.pyの修正
language = 'ja'
latex_docclass = {'manual': 'jsbook'}
上記の2行を追加
ビルド
$ make latexpdfja
_build/latexフォルダ内に生成される。
エラーが出た場合
その1 Latexのインストール中
・・・・
---> Attempting to fetch texlive-latex-34192-run.tar.xz from http://fco.it.distfiles.macports.org/mirrors/macports-distfiles/texlive-latex
---> Attempting to fetch texlive-latex-34192-run.tar.xz from http://giraffe.cs.washington.edu/texlive/
---> Attempting to fetch texlive-latex-34192-run.tar.xz from http://ykf.ca.distfiles.macports.org/MacPorts/mpdistfiles/texlive-latex
---> Attempting to fetch texlive-latex-34192-run.tar.xz from http://svn.macports.org/repository/macports/distfiles/texlive-latex
Error: org.macports.fetch for port texlive-latex returned: fetch failed
Error: Failed to install texlive-latex
Please see the log file for port texlive-latex for details:
/opt/local/var/macports/logs/_opt_local_var_macports_sources_rsync.macports.org_release_ports_tex_texlive-latex/texlive-latex/main.log
Error: The following dependencies were not installed: texlive-bibtex-extra texlive-latex texlive-bin-extra detex dvipng gd2 libvpx t1lib latexdiff p5.16-algorithm-diff latexmk pdfjam texlive-latex-recommended pgf texlive-context texlive-fonts-recommended texlive-math-extra texlive-metapost texlive-xetex texlive-generic-recommended texlive-fonts-extra texlive-fontutils lcdf-typetools ps2eps psutils t1utils texlive-formats-extra texlive-games texlive-generic-extra texlive-htmlxml texlive-humanities texlive-lang-african texlive-lang-arabic texlive-lang-chinese texlive-lang-cjk texlive-lang-cyrillic texlive-lang-czechslovak texlive-lang-english texlive-lang-european texlive-lang-french texlive-lang-german texlive-lang-greek texlive-lang-indic texlive-lang-italian texlive-lang-japanese texlive-lang-korean texlive-lang-other texlive-lang-polish texlive-lang-portuguese texlive-lang-spanish texlive-latex-extra texlive-pictures texlive-luatex texlive-music texlive-omega texlive-plain-extra texlive-pstricks texlive-publishers texlive-science
To report a bug, follow the instructions in the guide:
http://guide.macports.org/#project.tickets
Error: Processing of port texlive failed
- このようなログが出てましたが、上記のLatexのインストールの手順を再度行ったら成功しました。
その2 ビルド中
・・・・
! LaTeX Error: Missing \begin{document}.
See the LaTeX manual or LaTeX Companion for explanation.
Type H <return> for immediate help.
...
l.26
?
conf.pyの以下の部分が間違っていると出るので、余計な半角などが入ってないか確認する。
language = 'ja'
latex_docclass = {'manual': 'jsbook'}