[PYTHON] Memo über Sphinx Teil 2 (PDF-Ausgabe mit der Erweiterung rst2pdf)

So geben Sie das erstellte Dokument mit rst2pdf als PDF aus

Umgebung

OS:Mac OS X 10.9.5 Python:Ver.2.7.7

Installation von rst2pdf

$ sudo easy_install rst2pdf

・ ・ ・
Finished processing dependencies for rst2pdf

Wenn Sie dieses Ergebnis erhalten, sind Sie fertig.

Konfigurationsdatei bearbeiten

conf.py Fügen Sie conf.py Folgendes hinzu

extensions = ['rst2pdf.pdfbuilder']

# -- Options for PDF output --------------------------------------------------
pdf_documents = [
    ('index', u'MyProject', u'My Project', u'Author Name'),
]
pdf_stylesheets = ['sphinx','kerning','a4','ja']
pdf_language = "ja"

Makefile Fügen Sie Makefile Folgendes hinzu

pdf:
	$(SPHINXBUILD) -b pdf $(ALLSPHINXOPTS) $(BUILDDIR)/pdf
	@echo
	@echo "Build finished. The PDF files are in _build/pdf."

ja.json Ja.json hinzufügen

{
    "embeddedFonts" : [
        "VL-Gothic-Regular.ttf",
        "VL-PGothic-Regular.ttf",
        "ipam.otf",
        "ipag.otf",
        "ipagp.otf",
        "ipamp.otf"
    ],
    "fontsAlias" : {
        "stdFont": "VL-PGothic-Regular",
        "stdBold": "VL-PGothic-Regular",
        "stdItalic": "VL-PGothic-Regular",
        "stdBoldItalic": "VL-PGothic-Regular",
        "stdMono": "VL-Gothic-Regular",
        "stdMonoBold": "VL-Gothic-Regular",
        "stdMonoItalic": "VL-Gothic-Regular",
        "stdMonoBoldItalic": "VL-Gothic-Regular",
        "stdSans": "VL-Gothic-Regular",
        "stdSansBold": "VL-Gothic-Regular",
        "stdSansItalic": "VL-Gothic-Regular",
        "stdSansBoldItalic": "VL-Gothic-Regular"
    },
    "styles" : [
        ["base" , {
            "wordWrap": "CJK"
        }],
        ["literal" , {
            "wordWrap": "None"
        }]
     ]
 }

Bauen

$ make pdf

Wird im Ordner _build / pdf generiert.

Wenn Sie eine Fehlermeldung erhalten

Wenn bei der Installation von rst2pdf die folgende Fehlermeldung angezeigt wird

error: Setup script exited with error: command 'cc' failed with exit status 1

Installieren Sie xcode-select

$ xcode-select --install