PDF出力

[tcppjp]

PDF版のドキュメントを自動的に生成したい。

Read the DocsにはPDF出力機能があるが、pdfLaTeXを使用しているため日本語を含むドキュメントは現在ビルドできない。

This is pdfTeX, Version 3.14159265-2.6-1.40.18 (TeX Live 2017/Debian) (preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode

(/home/docs/checkouts/readthedocs.org/user_builds/tecs-docs/checkouts/latest/do
cs/_build/latex/ASP3TECS.tex
LaTeX2e <2017-04-15>
Babel <3.18> and hyphenation patterns for 84 language(s) loaded.
(./sphinxmanual.cls
Document Class: sphinxmanual 2016/10/12 v1.5 Document class (Sphinx manual)
(/usr/share/texlive/texmf-dist/tex/platex/jsclasses/jsbook.cls

! LaTeX Error: This file needs format `pLaTeX2e'
               but this is `LaTeX2e'.

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

Related issue

• Xelatex for PDF generation readthedocs/readthedocs.org#1556

[humitos]

Hi @tcppjp! I'm using your project as example to try to achieve the proper usage of platex under Read the Docs to build it properly.

Do you know what are the proper steps/commands to build the PDF of your documentation? I tried just running xelatex and platex and none of them worked. That may help to understand what's the process that I need to consider under RTD. Thanks!

[tcppjp]

@humitos

Here's the build steps that I just tested on a fresh environment (macOS 10.14, MacTeX 2018, Python 3.7, Sphinx 1.5.1):

1. Remove the large table in docs/tecs/CDLref-type.rst. This table is known to produce invalid LaTeX code.
2. Run make latexpdfja. This command internally invokes Sphinx's LaTeX builder and then recursively calls make all-pdf-ja using the generated _build/latex/Makefile. The output should look like this.

I hope this helps!

Edit: I just opened a PR #8 that updates Sphinx to 1.8.4. The first step can be skipped in this version.