How to output the created document as pdf using Latex

PDF output using rst2pdf extension (Note about Sphinx Part 2 (PDF output using rst2pdf extension)), so PDF output even with Latex I tried to.

I felt that the output via Latex was considerably cleaner than the output using rst2pdf. Compared to rst2pdf, Latex seems to be able to tweak the design in detail, so I thought that it would be better to use Latex for PDF.

environment

OS:Mac OS X 10.9.5 Python:Ver.2.7.7

Latex installation

Install using TeX Live installation

$ sudo port selfup
$ sudo port install texlive +full

In "Sphinx-Users.jp" TeX Live installation on OSX (MacTex / MacPorts), "For build" It takes almost an hour. "But in my environment, waiting for two hours didn't finish, so I waited patiently. (I slept with it on in the middle of the night and finished in the morning.)

・ ・ ・ ・
--->  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.
$

When it was over, there was a log like this.

Change project settings

Modify conf.py

language = 'ja'

latex_docclass = {'manual': 'jsbook'}

Add the above two lines

Build

$ make latexpdfja

Generated in the _build / latex folder.

If you get an error

Part 1 Latex is being installed

・ ・ ・ ・
--->  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

I got a log like this, but when I tried the above Latex installation procedure again, it succeeded.

Part 2 during build

・ ・ ・ ・
! LaTeX Error: Missing \begin{document}.

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

l.26

?

If the following part of conf.py is incorrect, it will appear, so check if there are any extra half-width characters.

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

[PYTHON] PDF output with Latex extension in Sphinx