SphinxでLatex拡張を使ってPDF出力する

Latexを使って、作成したドキュメントをpdfで出力する方法

rst2pdf拡張を使ったPDF出力（[Sphinxについてのメモ　その2（rst2pdf拡張を使ったPDF出力）](http://qiita.com/H-A-L/items/f38f849cc20faefb9fe6)）をやったので、LatexでもPDF出力してみました。

Latexを介して出力したものは、rst2pdfを使って出力したものに比べて相当綺麗だと感じました。rst2pdfに比べてLatexの方はデザインを細かくいじれるようなので、PDFにするならLatex経由の方がいいなと思いました。

# 環境
OS:Mac OS X 10.9.5
Python:Ver.2.7.7

## Latexのインストール
* TeX Liveインストールを使ってインストール

```console
$ sudo port selfup
$ sudo port install texlive +full
```
※「Sphinx-Users.jp」の[OSXへのTeX Liveインストール (MacTex / MacPorts)](http://sphinx-users.jp/cookbook/pdf/latex-install-osx.html)には「ビルドに1時間近くかかります。」と書いてありましたが、私の環境では2時間待っても終わりませんでしたので気長に待ちました。（夜中に付けたまま寝て朝には終わってました。）

```text
・・・・
--->  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の修正
```python
language = 'ja'

latex_docclass = {'manual': 'jsbook'}
```
上記の2行を追加

## ビルド
```console
$ make latexpdfja
```
_build/latexフォルダ内に生成される。

##エラーが出た場合
### その1 Latexのインストール中
```text
・・・・
--->  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 ビルド中
```text
・・・・
! LaTeX Error: Missing \begin{document}.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H <return>  for immediate help.
 ...

l.26

?
```
conf.pyの以下の部分が間違っていると出るので、余計な半角などが入ってないか確認する。

```text
language = 'ja'
latex_docclass = {'manual': 'jsbook'}
```