Help us understand the problem. What is going on with this article?

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

More than 5 years have passed since last update.

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'}
H-A-L
IT系ベンチャー企業のエンジニアです。 試した事などを、ログとしていろいろ書いて行きます。 すでに沢山記事にされている事も書くと思いますが、試した時に遭遇したエラーや解決した方法などをしっかり残して行きたいと思っています。
Why not register and get more from Qiita?
  1. We will deliver articles that match you
    By following users and tags, you can catch up information on technical fields that you are interested in as a whole
  2. you can read useful information later efficiently
    By "stocking" the articles you like, you can search right away